GST 4.01 upgrade guide

Review when migrating to Genero Studio 4.01.


This is an incremental upgrade guide that covers only topics related to the Genero Studio version specified in the page title. Check prior upgrade guides if you migrate from an earlier version. Make sure to also read about the new features for this version.

Corresponding new features page: GST 4.01 new features.

Previous upgrade guide: GST 4.00 upgrade guide

iOS project deploy rule script has changed

Starting with GST 4.01.01, there has been an update to the script behind the project deploy rules for iOS applications. If you edited your project deploy rules and they contain calls to the ideploy.tcl script, your modifications may no longer work against the updated script. Deploy rules are considered modified when you right-click on a project node, select Edit Package Rules, click the Deploy tab, and select the Overwrite default rules check box.

Prior to 4.01.01, the script is called with three arguments:
  • $(GSTDIR)
  • $(packageId)
  • $(DistDir)/$(PackageName)

Starting with 4.01.01, the script is called with a different set of arguments:

  • $(DistDir)
  • $(packageId)
  • $(packageLabel)

If you select to apply your previous configuration to your 4.01.01 installation, the old arguments in your modified deploy rules may (and most likely will) no longer work properly. You should review your modifications to ensure they work with the new version of the deployment script.

Changes in earlier versions

Make sure to check the upgrade notes of earlier versions, to not miss changes introduced in maintenance releases. For more details, see GST 4.00 upgrade guide.