Known Issues

This section provides the list of the known issues in Stingray 2025.1

Compilation

C++23 Build Error and Support

The following error is generated when using latest Visual Studio 2022 update 17.6.4 and later, and if using C+latest as C+ Standard for creating non-make file-based builds:

"C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Tools\MSVC\14.36.32532\modules\std.ixx(147,1): fatal error C1010: unexpected end of file while looking for precompiled header. Did you forget to add '#include "stdafx.h"' to your source?"

To resolve this error set the following option:

Configuration Properties > C/C++ > Language > Build ISO C+23 Standard Library Modules = "No"

Project Files

Targeted to Windows SDK

We ship .vcxproj files ported to Visual Studio 2017 targeted to Windows SDK 10.0.17763.0 with the following line of code:

<WindowsTargetPlatformVersion>10.0.17763.0</WindowsTargetPlatformVersion

If you are targeting the Windows 8.1 SDK, this line is not needed and should be removed.

For Visual Studio 2019 and 2022, we use a new option to target to the latest installed version of the SDK:

<WindowsTargetPlatformVersion>10.0</WindowsTargetPlatformVersion

You can re-target C++ projects to another version of Windows SDK using the Windows SDK setting in Stingray Assistant or by manually editing the .vcproj file and changing the code line above to match the Windows 10 SDK version you would like to target.

For projects that are not makefile-based, you can re-target the Windows SDK version on the project's property pages (Configuration Properties|General | Windows SDK Version) or use the “Retarget Projects” option in Visual Studio IDE. Note that these options do not work for makefile-based projects used for main Stingray components.

Targeted to .NET Framework

Stingray projects which use .NET are targeted to .NET Framework 4.7.2.

To set this targeting in shipped MFC samples or other similar projects used with C++\CLI, you need to add the following line of code in the <PropertyGroup Label="Globals"> of the *vcxproj file:

<TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion>

“Run as Administrator” is needed for Build

To build Stingray components, start Visual Studio with the “Run as administrator” option. If you start Stingray Studio Assistant in administrator mode, launching Visual Studio from Assistant will also launch Visual Studio in administrator mode.

Parallel Projects Build May Cause Errors

To avoid possible Stingray build errors in Visual Studio, go to Tools | Options | Projects And Solutions | Build and Run, and set "maximum number of parallel project builds" to 1.

Grid Build with ExcelReadWrite Option

Grid make file was modified to ignore ExcelReadWrite files when building with Unicode. In the Grid Build Wizard this option was set checked by default. We strongly recommend you do not run build wizards for Grid and other components until you’re sure it is needed for your custom purpose. This improvement does not work for build Grid from command line. If you face any problem building from command line, please, contact techsupport@perforce.com.

Build Fails with Message "This project cannot build given the current state of the project."

Use of Visual Studio versions 17.12 and later may cause build error message "This project cannot build given the current state of the project."

This error is common after upgrading to Visual Studio 2022 version 17.12, especially with MFC projects. Usually retarget the project can resolve this. If the problem persists, search for Microsoft documentation.

Later versions of Visual Studio (we tested with 17.14) do not show up this problem.

Build GridExcelHelper

Build of GridExcelHelper fails if DocumentFormat.OpenXml 3.1.0.0 is not installed.

To build a project using DocumentFormat.OpenXml version 3.1.0.0, follow these steps:

  1. Install the NuGet Package:

    • Open your project in Visual Studio.

    • Go to the NuGet Package Manager (Tools > NuGet Package Manager > Manage NuGet Packages for Solution).

    • Search for DocumentFormat.OpenXml and install version 3.1.0.0.

  2. Add References:

    • Ensure that your project references the DocumentFormat.OpenXml assembly. You can do this by right-clicking on your project in Solution Explorer, selecting Add Reference, and then browsing to the installed package.