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_project 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 available:

Here's an example with skipping several types of files:

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

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

The following arguments are available if you want to have a more controllable patching process: