Patching Project Files

Upgrading your project to a newer version may sometimes require changes to project files (such as adding new files) or source files (such as adding include directives). These changes are most commonly related to integrating new third-party libraries.

To save you from having to make these modifications manually, the SDK includes built-in functionality to assist with migration. When updating your project, you can select which files should be automatically patched.

By default, all files are selected for patching.

To upgrade the project or source files in the manual mode, do the following:

1. Put the binary executable <UnigineSDK>/bin/usc_x64.exe to the <UnigineSDK>/utils/upgrade folder that contains the upgrade script.
   Notice

   Use usc_x64.exe from the SDK version you are migrating to.

2. In the command prompt, run the upgrade.usc with the corresponding arguments. The following arguments are possible:

   • --skip_source_paths — C++ files won't be patched.
   • --skip_vscode_paths — VS Code files won't be patched.
   • --skip_csproj_path — .csproj files won't be patched.
   Shell commands

   usc_x64.exe upgrade.usc --project_path path/to/.project --skip_source_paths --skip_csproj_path

   In this case, only VS Code files will be patched.