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.

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.

Sideload an MMPK File onto a Device

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:

  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.

© 2020 VertiGIS North America Ltd. All Rights Reserved.

Documentation Version 5.10