Android Installation Prerequisites

Main Steps

The main steps to obtain the Geocortex Mobile App Framework for Android are:

  1. Obtain an ArcGIS Runtime SDK license.

    The Geocortex Mobile App Framework ships with an ArcGIS Runtime SDK Basic license that is registered to Latitude Geographics. To allow offline editing using the App, you must obtain an ArcGIS Runtime SDK Standard license code. If you are not going to support offline editing, but you want the App to be associated with a license that is registered to your organization instead of to Latitude Geographics, you must obtain your own ArcGIS Runtime SDK Basic license.

  2. Obtain the installation package.

    You can either download the package from the Geocortex Support Center or obtain a customized package from Geocortex Support.

Obtain an ArcGIS Runtime SDK License

Certain offline features require the App to be licensed using an ArcGIS Runtime SDK license.

There are two kinds of ArcGIS Runtime SDK license:

By default, the Geocortex Mobile App Framework is licensed using a Basic license that is registered to Latitude Geographics. To obtain your own license, you can either request the license from Esri, or you can become a Portal for ArcGIS or ArcGIS Online customer. ArcGIS Runtime SDK Standard licensing is built into Portal for ArcGIS and ArcGIS Online.

If you use Portal for ArcGIS or ArcGIS Online licensing, the user must sign in as a Level 2 Named User to Portal for ArcGIS or ArcGIS Online at least once every 30 days to maintain the Standard license. If the user fails to sign in after 30 days, functionality will be reduced to the equivalent of a Basic license until the user signs in again. Level 1 Named Users are equivalent to those with a Basic license.

The options for licensing the App with the ArcGIS Runtime SDK are:

 

For more information about obtaining an ArcGIS Runtime SDK license, refer to Esri's "License your app" documentation.

Obtain an ArcGIS Runtime SDK Basic License

The Geocortex Mobile App Framework is preconfigured with a Basic license belonging to Latitude Geographics. You only need to obtain a Basic license if you want the App to be associated with your Client ID, instead of the Latitude Geographics Client ID.

To obtain a ArcGIS Runtime SDK Basic license:

  1. Contact your local Esri representative and request a ArcGIS Runtime SDK Basic license. You will need the license's Client ID.

    You may want to provide the license's Client ID to Geocortex Support if you decide to request a customized installation package. Geocortex Support will preconfigure the license in the installation package.

    If you use the download package from the Geocortex Support Center instead of a customized package, then the license must be applied after the App is installed.

Sign in as a Portal for ArcGIS or ArcGIS Online Level 1 Named User

When a Level 1 Named User signs in to Portal for ArcGIS or ArcGIS Online, the Basic license is automatically activated. No other steps are required.

Obtain an ArcGIS Runtime SDK Standard License Code

To obtain a ArcGIS Runtime SDK Standard license code:

  1. Contact your local Esri representative and purchase a ArcGIS Runtime SDK Standard license code.

    You must provide the license code to Geocortex Support if you decide to request a customized installation package. Geocortex Support will preconfigure the license in the installation package.

    If you use the download package from the Geocortex Support Center instead of a customized package, then the license must be applied after the App is installed.

Sign in as a Portal for ArcGIS or ArcGIS Online Level 2 Named User

When a Level 2 Named User signs in to Portal for ArcGIS or ArcGIS Online, the Standard license is automatically activated. No other steps are required.

Obtain the Installation Package

There are two ways to obtain a Geocortex Mobile App Framework for Android installation package:

Benefits of Customized Installation Packages

The customized installation packages that you obtain from Geocortex Support offer the following benefits:

Request a Customized Multi-Viewer Package

This option allows users to select which viewer to open.

To obtain a customized package that supports multiple viewers:

  1. Send the following information to Geocortex Support (support@latitudegeo.com):

    Required Information

    Optional Information

Request a Customized Single-Viewer Package

This option automatically opens a specific viewer when the Geocortex Mobile App Framework starts.

To request a customized package that supports a single viewer:

  1. Send the following information to Geocortex Support (support@latitudegeo.com):

    Required Information

    Optional Information

Download the Software

Instead of downloading the installation package, you can request a customized package from Geocortex Support. Customized packages provide a number of benefits.

To download the Geocortex Mobile App Framework installation package from the Geocortex Support Center:

  1. Open the Geocortex Essentials Downloads page in the Geocortex Support Center.

  2. If prompted, log in with your Support Center account credentials.

    If you do not have a Support Center account, click the link to create an account.

  3. Find the Geocortex Mobile App Framework section.

    Information is displayed about the current version of the Geocortex Mobile App Framework for Android, with download and documentation links.

    To download a previous version, click Previous Versions and find the version you want.

  4. Click Geocortex Mobile App Framework 2.3.2 (Android).

    The APK file downloads.

What's next?

Android Server-side Tasks

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 4.11