Project Uplift operations

Template Uplift

The Template uplift consists in the following operations.

Update project.mwprj. The project.mwprj in the current project will be updated against the updated one.

The following operation are performed:

1. Update extcmds: new <extcmd> present in the updated project are added to the current project, existing <extcmd>are not overridden (the name is used for comparison)

2. Update runcfgs: new <runcfg> declared in the updated project are added to the current project project, existing <runcfg>are not overridden (the name is used for comparison), XMLs files referenced in the applicationConfig and engineConfig attribute of new <runcfg> are copied in the current project.

Update project sections. Project <section> and <file> of the current project are updated against ones in the updated project.

The following operation are performed:

3. Add to current project all sections from the updated project missing in the current project, with relative child items.

4. Add to current project items from the updated project missing in the current project, even in already existing and matched sections.

5. For items matched in the current project (already existing) check if the type is configuration, if so, execute updateWithConfig(...) against the counterpart in the updated project.

6. Copy referenced files (usually contained in GameData/SectionName/user/) if missing in the current project.

Update unreferenced config files

The following operations are performed:

7. Collect all XML files from the current project root directory and from the updated project data directory.

8. Filter only files that are config (checked by verifying the presence of a renderSetupFilePath item).

9. Compare the files in the current project and in the updated project: copy missing ones from the updated project to the current project, update matched ones by executing updateWithConfig(...)

Update generic files. Copy all files in the updated project project data directory not handled by previous operations.

Update the current project manifest. <Project currentVersion> is updated to updated template version.

Target framework for runtime Uplift

The target framework for runtime uplift consists in the following operations:

• Update all config files in the project root directory against the master config of the uplifting version framework.

• Update the framework Version to updated version in the project.manifest file.

Contents Uplift

The contents update consists in the following operations:

• Delete from project the resources referenced by Contents that were deleted from the table.

• Delete from project the resources referenced by Contents that were updated from the table.

• Copy to project new resources referenced by Contents that were updated in the table.

• Copy to project new resources referenced by Contents that were added in the table.

• Update the project.manifest file according to the configuration in the Contents manager table (add new Contents, update updated ones, remove deleted ones).