Upgrading on iOS

Before upgrading the Geocortex Mobile App Framework or the Geocortex Viewer for HTML5, to avoid losing any unsaved changes, users must synchronize each viewer that has unsaved changes.

Upgrade from Version 2.x

Upgrading follows a similar procedure to first-time installation. You must obtain a customized installation package, like you did the first time.

You must use the same Apple Developer Account for upgrading that you used for first-time installation. Otherwise the device will treat the App as a new application and install it beside the old App instead of upgrading the old App.

Upgrading preserves the Essentials registration, ArcGIS Runtime SDK licensing, TPK files, viewers, and feature data.

Main Steps

The main steps to upgrade the Geocortex Mobile App Framework from version 2.x given below:

  1. Obtain the Installation Package.

  2. Deploy the Installation Package.

  3. Install the App.

  4. Trust the App.

Upgrade from Version 1.x

There is no automated upgrade process from version 1.x to version 2.x. To upgrade from version 1.x, the user must uninstall version 1.x and install version 2.x like a new installation.

Uninstalling the App deletes any TPK files that the user has downloaded to the device. After installing the new version, the user must restore the TPK files.

To upgrade the Geocortex Mobile App Framework version 1.x to version 2.x:

If you want to keep your TPK files, you can save them via iTunes before uninstalling the Geocortex Mobile App Framework. For instructions, see Manually Copy an Existing TPK File to the Device.

  1. Uninstall the Geocortex Mobile App Framework 1.x using the device's usual app removal method.

  2. Install GMAF for iOS 2.x.

  3. Restore the TPK files.

    The easiest way to restore the TPK files is for the user to re-download the offline maps. Alternatively, if you saved the TPK files before uninstalling, they can be restored via iTunes. For instructions, see Manually Copy an Existing TPK File to the Device.

© 2021 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 4.14