GST 4.01 upgrade guide

Review when migrating to Genero Studio 4.01.

Important:

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

Report design documents

Update report design documents (.4rp) to the current version by using the gsreport command line utility. For further information, see Update report design documents to the current version.

ANDROID_HOME replaces ANDROID_SDK_ROOT

After promoting ANDROID_SDK_ROOT usage over ANDROID_HOME, Google decided to deprecate ANDROID_SDK_ROOT in favor of ANDROID_HOME.

See https://developer.android.com/studio/command-line/variables.html

The default Android environment set includes ANDROID_SDK_ROOT. To account for Change it to ANDROID_HOME and update the PATH to reference $(ANDROID_HOME) instead of $(ANDROID_SDK_ROOT). If you have existing Android environment sets defined, replace ANDROID_SDK_ROOT with ANDROID_HOME and edit the PATH to reference $(ANDROID_HOME) instead of $(ANDROID_SDK_ROOT).

Note:

Setting ANDROID_HOME is not mandatory, and keeping ANDROID_SDK_ROOT should still be fine. However, all procedures have been updated to promote the use of ANDROID_HOME over ANDROID_SDK_ROOT.

See Install and configure Java SDK and Android SDK.

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.