System Requirements for Android

Supported Android Platforms

The Geocortex Mobile App Framework for Android supports Android 5.0 and newer on tablets and phones with at least 1 GB of RAM.

See also...

Requirements for Previous Versions

Supported Geocortex Software

The Geocortex Mobile App Framework 2.3.2 for Android works with:

If Internet Information Services (IIS) is configured to deny anonymous access for either Essentials or the HTML5 Viewer, the Geocortex Mobile App Framework may not work properly.

See also...

Requirements for Previous Versions

Supported ArcGIS Software

The Geocortex Mobile App Framework 2.3.2 works with:

We recommend using ArcGIS Enterprise or ArcGIS Server rather than ArcGIS Online. As of 2016, ArcGIS Online can support approximately 20 concurrent synchronizations, depending on the data. Using ArcGIS Enterprise or ArcGIS Server, you can scale your server resources to handle the number of concurrent synchronizations that your organization needs.

If your site uses secured services, see Types of Security Supported in Android.

Offline Requirements

Proxy Page

As of version 1.3.2, the Geocortex Mobile App Framework makes use of the HTML5 Viewer proxy page. You must configure the HTML5 Viewer proxy page to communicate with trusted servers such as the Essentials server, otherwise the application may not function properly. For more information, see Set Up a Proxy Page for the HTML5 Viewer.

Do not use the proxy page for user access control because some Geocortex Mobile App Framework requests are not routed through the proxy page, for example, offline map downloads. The proxy page is only used to facilitate cross-domain activity between the device and servers. If you want to enforce user access control for your GIS services, consider using a reverse proxy for your GIS services instead.

Cross-Origin Resource Sharing (CORS)

The Geocortex Mobile App Framework requires cross-origin resource sharing (CORS) with Geocortex Essentials to function properly. You can set up CORS in Essentials Manager. Essentials 4.5 and newer support the Geocortex Mobile App Framework out of the box. If you have configured CORS in Essentials before version 4.5, you must first remove the legacy CORS configuration. For instructions, see Set Up Cross-Origin Resource Sharing (CORS).

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:

For more information, see Obtain an ArcGIS Runtime SDK License.

Requirements for Offline Editing

In addition to the general offline requirements, offline editing requires the following:

Requirements for Offline Workflows

To support running workflows offline, the Geocortex Viewer for HTML5 server must have an internet connection.

Deployment Server Requirements

The Geocortex Mobile App Framework must be installed on each end user's device. One way to make the installation package available to users is to deploy it to a file share or web server that users have access to. They can then download the package from the server and install the App on their device.

To allow end users to download the installation package from a web server, you can use any web server capable of serving .apk, .tpk, and .json files. If you use Internet Information Services (IIS), you will need to add MIME types for each of these file extensions. Follow the instructions below.

MIME Types

In order to host the Android installation package on an IIS web server, you must add MIME types for the following file extensions:

To add the MIME types to IIS:

  1. To open IIS Manager, click the Windows Start button, type iis, and click Internet Information Services (IIS) Manager.

  2. In the Connections panel, expand the hierarchy and select the item in the hierarchy where you want to add the MIME types.

    You can add MIME types at any point in the hierarchy. The higher in the hierarchy you add the MIME types, the greater the scope they have. Selecting the website where Essentials and the HTML5 Viewer are deployed is sufficient. By default, Essentials and the HTML5 Viewer are deployed to the Default Web Site.

  3. In the IIS section of the middle panel, double-click MIME Types.

  4. For each file extension listed in the MIME Types to Add to IIS table:

    1. In the Actions panel on the right, click Add.

      The Add MIME Type dialog box opens.

    2. Type the file extension in the File name extension box.

    3. Type the MIME type in the MIME Type box.

    4. Click OK.

      The Add MIME Type dialog box closes.

    MIME Types to Add to IIS

    File Extension

    MIME Type

    .apk

    application/vnd.android.package-archive

    .tpk

    application/octet-stream

    .json

    application/json

  5. Click OK and close IIS Manager.

Types of Security Supported in Android

We recommend that you avoid securing your ArcGIS services with Basic Authentication because editing will not work. Use Windows Authentication instead.

If your site contains ArcGIS services that are secured with Windows Authentication, you must set up a proxy page for the HTML5 Viewer if you do not already have one. For information, see Set Up a Proxy Page for the HTML5 Viewer. In addition, you must adapt your proxy page to access Windows-secured services by configuring authentication in IIS. Adapt the ASP.NET Proxy Page to Access Windows-Secured Servers includes instructions to configure authentication in IIS. When accessing a secured ArcGIS service, the user may be prompted to sign in.

The following table shows the types of security supported by the Geocortex Mobile App Framework and Geocortex Essentials Manager.

Supported Types of Security for the Geocortex Mobile App Framework

 

Windows
Authentication*

ArcGIS Online Security
(OAuth 2)

Portal for ArcGIS

ArcGIS Token Security

Two-level Security
(Windows Authentication + Token)*

TLS / SSL*

Web server-hosted TPK

N/A

 

N/A

N/A

Essentials-hosted TPK

N/A

 

 N/A N/A

Custom TPK

 

Feature Layers

 

Dynamic Map Services

 

Tiled Map Services

 

Sign-in Authentication

†

N/A

N/A

‡

: Full Support, : Partial Support, N/A: Not Applicable

* The Geocortex Mobile App Framework for Android supports both TLS 1.2 and Windows Authentication separately, but not in conjunction.

† Portal-tier authentication has been tested with the built-in identity store for sign-in. Enterprise identity store, Enterprise logins, or Security Assertion Markup Language (SAML) have not been tested.

‡ Essentials (and Portal for ArcGIS, if relevant) are SSL/TLS secured.

Two-level security with map services in Essentials is only supported for users authenticated with the application pool identity.

Unsupported Security

With the exception of Essentials Sign-in Authentication, any authentication techniques that involve the following are unsupported: