Dela via

Migreringsguiden för Azure Maps iOS SDK

Migrering från Azure Maps iOS SDK till Webb-SDK i en WebView innebär att du övergår din befintliga kartvy från en intern implementering till en webbaserad karta med hjälp av Azure Maps Web SDK. Den här guiden visar hur du migrerar din kod och dina funktioner från iOS SDK till Web SDK.

Anmärkning

Azure Maps iOS SDK-tillbakadragning

Azure Maps Native SDK för iOS har nu dragits tillbaka och stöds inte längre. Använd den här guiden för att migrera till Azure Maps Web SDK.

Förutsättningar

Om du vill använda kartkontrollen på en webbsida måste du ha något av följande krav:

Skapa en webbvy

Lägg till en WebView om ditt iOS-program inte har någon. Gör det genom att lägga till i WKWebView din storyboard eller programmatiskt i Din Swift-kod. Se till att den är konfigurerad för att uppta det önskade området i layouten.

import UIKit
import WebKit

class ViewController: UIViewController, WKNavigationDelegate {

    var webView: WKWebView!

    override func viewDidLoad() {
        super.viewDidLoad()

        // Create WKWebView instance
        webView = WKWebView(frame: view.bounds)
        webView.navigationDelegate = self
        view.addSubview(webView)

        // Load local HTML file
        loadLocalHTMLFile()
    }

    func loadLocalHTMLFile() {
        if let htmlPath = Bundle.main.path(forResource: "map", ofType: "html") {
            do {
                let htmlString = try String(contentsOfFile: htmlPath, encoding: .utf8)
                webView.loadHTMLString(htmlString, baseURL: Bundle.main.bundleURL)
            } catch {
                print("Error loading HTML file: \(error)")
            }
        } else {
            print("HTML file not found.")
        }
    }
}

Konfigurera en karta med Azure Maps Web SDK

Initiera en karta med din prenumerationsnyckel i HTML-filen. Ersätt <YOUR_SUBSCRIPTION_KEY> med din faktiska nyckel.

<!DOCTYPE html>
<html>
   <head>
       <title>Azure Maps</title>
       <meta charset="utf-8" />
       <meta name="viewport" content="width=device-width, initial-scale=1" />
       <!-- Add references to the Azure Maps Map control JavaScript and CSS files. -->
       <link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css"/>
       <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>
       <style>
           html,
           body,
           #map {
               margin: 0;
               height: 100%;
               width: 100%;
           }
           body {
               display: flex;
               flex-direction: column;
           }
           main {
               flex: 1 1 auto;
           }
       </style>
       <script type="text/javascript">
           // Create an instance of the map control.
           function InitMap() {
               var map = new atlas.Map("map", {
                   center: [-122.33, 47.6],
                   zoom: 12,
                   authOptions: {
                       authType: "subscriptionKey",
                       subscriptionKey: "<YOUR_SUBSCRIPTION_KEY>"
                   }
               });

               // Wait until the map resources are ready.
               map.events.add("ready", function () {
                   // Resize the map to fill the container.
                   map.resize();
               });
           }
       </script>
   </head>
   <body onload="InitMap()">
       <main>
           <div id="map"></div>
       </main>
   </body>
</html>

Spara och kör appen. En karta bör visas i en webbvy. Lägg till funktioner som du vill använda från Web SDK. Mer användningsfall finns i Dokumentation om Azure Maps och Azure Maps-exempel .

En skärmbild av en karta i en Webbvy.

Kommunikation mellan intern kod och WebView (valfritt)

Om du vill aktivera kommunikation mellan ditt iOS-program och WebView kan du använda protokollet WKScriptMessageHandler som tillhandahålls av WKWebView klassen. Det gör att du kan upprätta en brygga för kommunikation mellan JavaScript som körs i WebView och din Swift-kod. Mer information finns i WKScriptMessageHandler i iOS WebKit-dokumentationen.

Rensa inbyggd kartimplementering

Ta bort kod som är relaterad till den interna Azure Maps iOS SDK från projektet, inklusive beroenden och initieringskod som är relaterad till azure-maps-ios-sdk-distribution.

Testa

Testa programmet noggrant för att säkerställa att migreringen lyckades. Sök efter problem som rör kartfunktioner, användarinteraktioner och prestanda.

Nästa steg

Lär dig hur du lägger till kartor i webb- och mobilprogram med hjälp av JavaScript-biblioteket på map control-klientsidan i Azure Maps:

Använda Azure Maps-kartkontrollen