Mobile Map Packages (MMPK)

Geocortex Mobile apps can be configured to support a Mobile Map Package (MMPK). An MMPK is an offline-capable package that contains basemaps and features. Unlike a Tile Package (TPK) which only contains map tiles, an MMPK is a full geodatabase that allows you to perform search and identify operations even while offline. However, if you want to edit data offline, you must use Map Areas.

Within the MMPK, each map is represented by a Mobile Map file (.mmap), which is nearly identical in structure to a web map. Mobile Designer allows you to configure layers for a single .mmap file within an MMPK.

For more information about MMPKs, see Esri's Share a Mobile Map Package.

Use an MMPK

The following table lists the high-level actions you need to do to use an MMPK in Geocortex Mobile.

In...

Do...

ArcGIS Pro

Configure the map to assign unique IDs before exporting your map data to an .mmpk file.

Mobile Designer

Configure the app's Mobile Map Package settings.

Geocortex Item Manager

(Optional) Configure the MMPK source so end users can download the .mmpk file without sideloading.

The Geocortex Mobile Device

Sideload the .mmpk file onto your device.

Configure the Map to Assign Unique IDs Before Creating the MMPK

To ensure layer IDs remain the same if the MMPK is ever updated, you must configure the map to assign unique IDs in ArcGIS Pro before creating the MMPK.

To configure the map to assign unique IDs:

  1. While editing your map data in ArcGIS Pro, in the Contents panel, right-click Map.

  2. Click Properties.

    The Map Properties: Map window appears.

  3. In the General section, select Allow assignment of unique numeric IDs for sharing web layers.

  4. Click OK.

    To manually set a layer's ID, right-click the layer, click PropertiesGeneral, and type an integer in the Layer ID box.

  5. Save and then create the MMPK.

Configure the App's Mobile Map Package Settings

In Mobile Designer, you must configure your app's Mobile Map Package settings to use the desired .mmpk and .mmap files. An .mmpk file is essentially a zip file that contains map data. Each map is represented by an .mmap file.

To configure the app's Mobile Map Package settings:

  1. While editing your app in Mobile Designer, in the Components panel, click Map.

  2. To expand the section, click Mobile Map Package.

  3. In the .mmpk Name box, type the name of your .mmpk file including the extension.

  4. In File Explorer, unzip the .mmpk file.

    An .mmpk file is essentially a zip file, which can be unzipped by any zipping utility, for example, 7-Zip.

  5. Within the folder where you unzipped the .mmpk file, navigate to the p## folder.

  6. Click the .mmap file that represents the map you want, and press CTRL+C.

  7. In Mobile Designer, under .mmap File, click Select File.

    A window appears that allows you to select the .mmap file.

  8. To paste the location of the .mmap file, press CTRL+V and then Enter.

    The map's layers are added to your app.

  9. Click File | Save.

(Optional) Configure the MMPK source

You can optionally configure the MMPK source in Geocortex Item Manager so that end users can download the .mmpk file without needing sideload the file onto their device. When the end user starts the app in GXM, the user is prompted to download the .mmpk file from an Esri portal. Configuring the MMPK source has the added benefit of prompting the user to download the .mmpk file if it is later updated.

Before you can configure the MMPK source, you must ensure the .mmpk file has been published to your Esri portal and you must know its portal item ID (the number at the end of the URL when viewing the Esri portal item).

To configure the MMPK source

If you have the app open in Mobile Designer, we recommend you close the app in Mobile Designer before performing the following procedure. Failure to do so may result in changes being overridden.

  1. In Geocortex Item Manager, open the app for which you want to configure the MMPK source.

  2. In the second panel, click Item Content.

  3. In the third panel, find the following mmpk section:

    Copy
          "mmpk": {
            "path": "MyMobileMapPackage.mmpk",
            "mapId": "MyMMAPFile"
          },
  4. Add the source property within the mmpk section and set the value to the MMPK's portal item ID (or URL), so that the section looks similar to the following:

    Copy
          "mmpk": {
            "path": "MyMobileMapPackage.mmpk",
            "mapId": "MyMMAPFile",
            "source": "a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4"
          },
  5. Click Save.

Sideload an MMPK File onto a Device

This procedure is only necessary if your administrator has not configured the MMPK source to automatically prompt end users to download MMPK files when starting an app.

If configured to do so, Geocortex Mobile apps support using a Mobile Map Package (MMPK) while offline. Users can sideload MMPK files onto Windows, Android and iOS devices. MMPKs are sideloaded onto mobile devices using the file system in the case of Windows or Android, or via iTunes in the case of iOS.

Your organization may have other ways to copy files to your device.

It is essential that users add the MMPK file to the correct folder on each type of device because GXM apps look for MMPKs in those specific folders.

Windows Devices

Use the file manager on a computer to transfer the MMPK to the following folder on the device:

%userprofile%\AppData\Local\Packages\[GeocortexMobileViewerAppName]\LocalState

Android Devices

Use the file manager on the computer to transfer the MMPK to the following equivalent folder on the device:

[Root Path]/Android/data/geocortex.mobile.viewer.custom/files

On Android devices, the first part of this path varies according to the device.

iOS Devices

To sideload a file onto an iOS device:

  1. Open iTunes.

  2. Plug the device into a computer, and then in iTunes click the device icon in the top left corner.

    The panel on the left displays the Settings for the device.

  3. Click File Sharing, and then click one of the following:

    • For Geocortex Go, click Geocortex Go in the Apps box.

      A list of the Geocortex Go Documents displays in the right-hand box.

    • For Custom apps, click the [app name] in the Apps box.

      A list documents for your custom app displays.

  4. From your file system, drag the .mmpk file and drop it into the Documents box.

    The status bar at the top of the window indicates that iTunes is copying the MMPK file to the device.

    Once the file is copied, it appears in the list of Documents.

    The MMPK is now sideloaded onto the device.