Сценарий обновления

UNIGINE upgrade script is a one-touch solution to upgrade data of a UNIGINE-based project to be consistent with updated engine builds. Сценарий обновления UNIGINE - это решение в одно касание для обновления данных проекта на основе UNIGINE в соответствии с обновленными сборками движка.

The script recursively scans the project folders inside the data folder to upgrade the files located there. If the script fails to upgrade some files, it will generate an error log (errors.log file). Скрипт рекурсивно сканирует папки проекта внутри папки data, чтобы обновить файлы, находящиеся там. Если скрипту не удается обновить некоторые файлы, он сгенерирует журнал ошибок (файл errors.log).

Примечание

The same upgrade script is run when upgrading projects via UNIGINE SDK Browser. Тот же сценарий обновления запускается при обновлении проектов через UNIGINE SDK Browser .

The script is located in utils/upgrade directory of UNIGINE SDK. Скрипт находится в каталоге utils/upgrade UNIGINE SDK.

Примечание

You need to properly set the development environment to get the script working. Чтобы скрипт заработал, необходимо правильно настроить среду разработки .

To invoke the upgrade script, run upgrade.usc at the command prompt by using USC Interpreter: Чтобы вызвать сценарий обновления, запустите upgrade.usc в командной строке, используя USC Interpreter:

usc_x* upgrade.usc DIRS OPTIONS

• If the content to be upgraded is stored only in the project's data folder, specify the path to this folder:
  Shell-команды

  usc_x* upgrade.usc PATH_TO_DATA OPTIONS

  You can also specify only a particular folder inside the data folder, if necessary. Если обновляемый контент хранится только в папке проекта data, укажите путь к этой папке:
  Shell-команды

  usc_x* upgrade.usc PATH_TO_DATA OPTIONS

  При необходимости вы также можете указать только конкретную папку внутри папки data.
• If the content to be upgraded is stored outside the data folder, you can specify the corresponding folders for the upgrade script:
  Shell-команды

  usc_x* upgrade.usc DIR_0 DIR_1 OPTIONS

  Если обновляемый контент хранится вне папки data , вы можете указать соответствующие папки для сценария обновления:
  Shell-команды

  usc_x* upgrade.usc DIR_0 DIR_1 OPTIONS

Примечание

If you need to upgrade several projects, you should run the upgrade script for each of them separately. Если вам нужно обновить несколько проектов, вы должны запустить сценарий обновления для каждого из них отдельно.

The upgrade script recognizes the following command line options: Сценарий обновления распознает следующие параметры командной строки:

• --log - a path to the log file. If the option isn't specified, the log will be printed to the command prompt only. --log - путь к файлу журнала. Если параметр не указан, журнал будет выводиться только в командную строку.

If no options are set, the script will start upgrading with the default values. Если параметры не заданы, скрипт начнет обновление со значениями по умолчанию.

• To upgrade content of a UNIGINE-based project located in D:\my_project directory, type at the command prompt:
  Shell-команды

  usc_x64 upgrade.usc D:\my_project\data

  Чтобы обновить содержимое проекта на основе UNIGINE, расположенного в каталоге D:\my_project, введите в командной строке:
  Shell-команды

  usc_x64 upgrade.usc D:\my_project\data

• To run content upgrading of a UNIGINE-based project and save the log data into a file, run the upgrade script as follows:
  Shell-команды

  usc_x64 upgrade.usc  D:\my_project\data --log D:\my_project\log.html

  Чтобы запустить обновление содержимого проекта на основе UNIGINE и сохранить данные журнала в файл, запустите сценарий обновления следующим образом:
  Shell-команды

  usc_x64 upgrade.usc  D:\my_project\data --log D:\my_project\log.html