Deploy an App

The deployment process in Mobile Designer makes it possible to move an app through several stages after the app is configured. These stages include Development, Testing, Staging, and Production. You can also change the deployment strategy to include only two stages: Development and Production, or three stages: Development, Testing, and Production.

Movement of the app through these stages is only in one direction. For example, if you are in the Production stage and need to edit a component, you can only edit the component in the Development stage. That means that you need to return to the Development stage, make the changes and then move the app through the other deployment stages again.

To change your deployment strategy: 

  1. In Mobile Designer, click Deploy | Change Deployment Strategy.
  2. In the Deployment Strategy drop-down list, select the strategy you want to use.

  3. Click Save.

Integration with Esri Through Deployment Stages

As you move your GXM app through different deployment stages within the Mobile Designer, a copy of its web map is created and given a new ID in the Esri portal. The stage that the map is in is added to the name of the web map, for example, GXM Map (test). At the same time, a copy of the Web Application you are creating is also saved in the portal and labelled with the stage it is at, for example, My GXM App (test).

Once an app reaches the Production stage, it's given a unique and permanent ID that stays with the app from that point onwards. This is the ID that is shared with end users. The web map and the app have (prod) added to the name in the portal.

Where to Find Saved Apps

Because apps are saved in your portal and a new version of the same app is saved at each deployment stage, it's important to know where to find the apps you want to share, or work on. For example, you may want to give your QA testers access to the app in the Testing stage in your portal, or giver your field workers access to the app in the Production stage.

You can find a list of apps that you have created or others have shared with you in the following:

The table below shows you where to find each version of an app in a Portal or in the Geocortex Go app.

File Name

Is saved here in Portals:

Is listed here on the selection screen of
Geocortex Go

Name of GXM app
No (dev) label is added to the name

Root folder
label: Web Mapping Application

In the Development Apps section

No (dev) label is added to the name

Name of GXM app (test)

Geocortex Web Viewer Files folder
label: Web Mapping Application

In the Test Apps section

Name of GXM app (staging)

Geocortex Web Viewer Files folder

label: Web Mapping Application

In the Staging Apps section

Name of GXM app (prod)

Geocortex Web Viewer Files - label: Web Mapping Application

In the Production Apps section

Environment Values

The Environment Values option allows you to substitute text strings that you want to change for each deployment stage. For example, you may want there to be some indication on your app to show the stage that a particular app is on. You could change the I Want To menu to include the words (Dev), (Test), (Staging) but then leave the Production stage as I Want To... as that will be the final version of the app.

Deploy an App

Once you have configured the app to have the settings you want and saved it, you can push it through the deployment stages.

To select the deployment stages for your app:

If you reduce the number of deployment stages for your app, the excluded stages are permanently discarded.

  1. Once you have saved your app in Web Designer, click Deploy.

  2. Click Deployment.

  3. In the Deploy panel, click Change Deployment Strategy, and then choose one of the following:

  4. Click FileSave.

To deploy an app:

  1. Once you have saved your app in Mobile Designer and selected the deployment stages, if you are not in the Deploy panel, click Deploy.

  2. When your app is ready for testing, click Push to Testing (if you selected this option).

  3. When your app is ready for staging, click Push to Staging (if you selected this option).

  4. When your app is ready for production, click Push to Production.

Once your app has gone to Production, it is ready to be built into a file that can be distributed to users.

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.2