Display a map from a mobile map package

Before starting this tutorial:

1. You need an ArcGIS Location Platform or ArcGIS Online account.

2. Your system meets the system requirements.

Option 1: Develop the code

1. Complete the Display a map tutorial.
2. Continue with the following instructions to display a map from a mobile map package (.mmpk) file.

Add a mobile map package

You will add a mobile map package (MMPK) A mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps. Learn more to your Xcode project. To get an .mmpk file, you can complete the Create a mobile map package tutorial or download its solution.

Once you have the mobile map package:

1. In Xcode’s app menu, click File > Add Files to ”…”.
2. Navigate to and select the .mmpk file. If you used the tutorial solution, it will be named MahouRivieraTrails.mmpk.
3. Choose Show Options, select the Copy items if needed checkbox, and ensure the project target is selected in Add to targets. Click Add.

Open the mobile map package and display a map

Select a map A map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers. Learn more from the maps contained in a mobile map package A mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps. Learn more , and display it in a map view. Use the MobileMapPackage class to access the mobile map package, and load it to read its contents.

1. In Xcode, in the Project Navigator, click ContentView.swift.

2. Update the map variable to initialize a simple map object. Setting a basemap and initial viewpoint is not needed in this scenario.

   ContentView.swift

   1
   struct ContentView: View {
   2
   
   3
       @State private var map = Map()
   4
   
   5
       var body: some View {
   6
   
   7
           MapView(map: map)
   8
   
   9
       }
   10
   
   11
   }

3. Create a function called loadMobileMapPackage() to set the MobileMapPackage referencing the mobile map package A mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps. Learn more you added to the project.

   More info

   The file name must match exactly. The name reflects the MahouRivieraTrails.mmpk added to the bundle.

   If you sideload Sideloading is the process of deploying a file or package to a device without using a network. Learn more or download the .mmpk file, you should provide the full file URL to the file’s location on the device.

   ContentView.swift

   1
   struct ContentView: View {
   2
   
   3
       @State private var map = Map()
   4
   
   5
       private func loadMobileMapPackage() async throws {
   6
           guard let mobileMapPackage = MobileMapPackage(name: "MahouRivieraTrails", bundle: .main) else { return }
   7
   
   8
       }
   9
   
   10
   }

4. Load the MobileMapPackage and check that it loads without error. Set the first map A map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers. Learn more in the package to the @State map.

   More info

   An MobileMapPackage can contain many maps in a maps array.

   Loading the mobile map package A mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps. Learn more is an asynchronous process. The file is read on a thread that does not block the UI.

   ContentView.swift

   1
       private func loadMobileMapPackage() async throws {
   2
           guard let mobileMapPackage = MobileMapPackage(name: "MahouRivieraTrails", bundle: .main) else { return }
   3
   
   4
           try await mobileMapPackage.load()
   5
           guard let map = mobileMapPackage.maps.first else { return }
   6
           self.map = map
   7
   
   8
       }

5. Lastly, as the MapView is being built, use the .task view modifier to asynchronously call the loadMobileMapPackage().

   ContentView.swift

   32 collapsed lines
   1
   // Copyright 2024 Esri
   2
   //
   3
   // Licensed under the Apache License, Version 2.0 (the "License");
   4
   // you may not use this file except in compliance with the License.
   5
   // You may obtain a copy of the License at
   6
   //
   7
   //   https://www.apache.org/licenses/LICENSE-2.0
   8
   //
   9
   // Unless required by applicable law or agreed to in writing, software
   10
   // distributed under the License is distributed on an "AS IS" BASIS,
   11
   // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   12
   // See the License for the specific language governing permissions and
   13
   // limitations under the License.
   14
   
   15
   
   16
   import SwiftUI
   17
   
   18
   import ArcGIS
   19
   
   20
   struct ContentView: View {
   21
   
   22
       @State private var map = Map()
   23
   
   24
       private func loadMobileMapPackage() async throws {
   25
           guard let mobileMapPackage = MobileMapPackage(name: "MahouRivieraTrails", bundle: .main) else { return }
   26
   
   27
           try await mobileMapPackage.load()
   28
           guard let map = mobileMapPackage.maps.first else { return }
   29
           self.map = map
   30
   
   31
       }
   32
   
   33
       var body: some View {
   34
   
   35
           MapView(map: map)
   36
   
   37
               .task {
   38
                   do {
   39
                       try await loadMobileMapPackage()
   40
                   } catch {
   41
                       print(error)
   42
                   }
   43
               }
   44
   
   45
       }
   2 collapsed lines
   46
   
   47
   }

Run the solution

Press Command + R to run the app.

You should see a map A map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers. Learn more of trail heads, trails, and parks for the area south of the Santa Monica mountains. You will be able to pinch (to zoom and rotate), drag, and double-tap the map view to explore the map.

Option 2: Download the solution

1. Click the Download solution link under Solution and unzip the file to a location on your machine.

2. Open the .xcodeproj file in Xcode.

Run the solution

Press Command + R to run the app.

You should see a map A map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers. Learn more of trail heads, trails, and parks for the area south of the Santa Monica mountains. You will be able to pinch (to zoom and rotate), drag, and double-tap the map view to explore the map.