Skapa en iOS-app (förhandsversion)

  • Artikel

Den här artikeln visar hur du lägger till Azure Kartor i en iOS-app. Vi går igenom de grundläggande stegen:

  • Konfigurera din utvecklingsmiljö.
  • Skapa ditt eget Azure Maps-konto.
  • Hämta din primära Azure Kartor-nyckel som ska användas i appen.
  • Referera till Azure Kartor-biblioteken från projektet.
  • Lägg till en Azure Kartor-kontroll i appen.

Kommentar

Azure Kartor iOS SDK-tillbakadragning

Azure Kartor Native SDK för iOS är nu inaktuell och kommer att dras tillbaka den 3/31/25. För att undvika tjänststörningar migrerar du till Azure Kartor Web SDK senast 3/31/25. Mer information finns i migreringsguiden för Azure Kartor iOS SDK.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Kommentar

Mer information om autentisering i Azure Kartor finns i Hantera autentisering i Azure Kartor.

Skapa ett Azure Maps-konto

Skapa ett nytt Azure Kartor-konto med följande steg:

  1. I det övre vänstra hörnet i Azure-portalen väljer du Skapa en resurs.

  2. I rutan Sök på Marketplace skriver du Azure Kartor.

  3. I Resultat väljer du Azure Kartor och sedan knappen Skapa som visas under kartan.

  4. Ange följande värden på sidan Skapa Maps-konto:

    • Den Prenumeration som ska användas för det här kontot.
    • Namnet på Resursgrupp för kontot. Du kan välja att skapa ny eller använda befintlig resursgrupp.
    • Namn för ditt nya konto.
    • Prisnivån för det här kontot.
    • Läs licensen och sekretesspolicy och markera kryssrutan för att godkänna villkoren.
    • Markera knappen Skapa.

    Skapa ett Azure Maps-konto.

Hämta prenumerationsnyckeln för ditt konto

När ditt Kartor-konto har skapats hämtar du den primära nyckeln som gör att du kan köra frågor mot Kartor API:er.

  1. Öppna ditt Maps-konto i portalen.

  2. I avsnittet Inställningar väljer du Autentisering.

  3. Kopiera Primärnyckel till Urklipp. Spara den lokalt för senare användning i den här självstudien.

Kommentar

Den här snabbstarten använder autentisering med delad nyckel i demonstrationssyfte, men den bästa metoden för alla produktionsmiljöer är att använda Microsoft Entra-autentisering.

Skärmbild som visar din Azure Kartor-prenumerationsnyckel i Azure-portalen.

Skapa ett projekt i Xcode

Skapa först ett nytt iOS-appprojekt. Slutför de här stegen för att skapa ett Xcode-projekt:

  1. Under Arkiv väljer du Nytt ->Projekt.

  2. På fliken iOS väljer du App och sedan Nästa.

  3. Ange appnamn, paket-ID och välj sedan Nästa.

Mer hjälp med att skapa ett nytt projekt finns i Skapa ett Xcode-projekt för en app .

Skapa det första iOS-programmet.

Installera Azure Kartor iOS SDK

Nästa steg i att skapa ditt program är att installera Azure Kartor iOS SDK. Utför de här stegen för att installera SDK:et:

  1. Med önskat Xcode iOS-projekt valt i Projektnavigatorn väljer du + knappen för att lägga till paketberoende.

    Lägg till paketberoende.

  2. Ange följande värden i den resulterande dialogrutan:

    • Ange https://github.com/Azure/azure-maps-ios-sdk-distribution.git i sökfältet som visas i det övre högra hörnet.
    • Välj Up to Next Major Version i fältet Beroenderegel .
    • Ange 1.0.0-pre.3 i fältet Beroenderegelversion .

    Lägg till beroenderegel i ett iOS-projekt.

  3. När paketet tillsammans med dess beroenden har lösts väljer du knappen Lägg till paket för att slutföra beroendekonfigurationen.

    Lägg till paket i ett iOS-projekt.

Lägg till MapControl-vy

  1. Lägg till anpassad UIView för att visa kontrollant

  2. Välj MapControl klass från AzureMapsControl modul

    Lägg till en Azure Maps-kontroll.

  3. I filen AppDelegate.swift:

    • lägga till import för Azure Kartor SDK
    • ange autentiseringsinformation för Azure Kartor

Genom att ange autentiseringsinformationen för Azure Kartor-klassen globalt med hjälp av AzureMaps.configure(subscriptionKey:) eller AzureMaps.configure(aadClient:aadAppId:aadTenant:)behöver du inte lägga till din autentiseringsinformation i varje vy.

  1. Välj kör-knappen, som du ser i följande bild (eller tryck på CMD + R), för att skapa ditt program.

    Kör iOS-programmet.

Xcode tar några sekunder att skapa programmet. När bygget är klart kan du testa ditt program på den simulerade iOS-enheten. Du bör se en karta som den här:

Din första karta i ett iOS-program.

Åtkomst till kartfunktioner

Du kan börja anpassa kartfunktioner genom att AzureMap hålla fast vid instansen i en mapView.onReady hanterare. MapControl När vyn har lagts till bör exemplet ViewController se ut ungefär så här:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let mapView = self.view.subviews.first as? MapControl;
        mapView?.onReady({ map in
            // customize your map here
            // map.sources.add()
            // map.layers.insertLayer()
        })
    }
}

Fortsätt till Lägg till ett polygonlager på kartan i iOS SDK för ett sådant exempel.

Rensa resurser

Gör så här för att rensa resurserna som skapades i den här snabbstarten:

  1. Stäng Xcode och ta bort projektet du skapade.

  2. Om du har testat programmet på en extern enhet avinstallerar du programmet från den enheten.

Om du inte planerar att fortsätta utveckla med Azure Kartor iOS SDK:

  1. Gå till Sidan i Azure-portalen. Välj Alla resurser på huvudportalsidan. Eller välj menyikonen i det övre vänstra hörnet och sedan Alla resurser.

  2. Välj ditt Azure Kartor-konto. Välj Ta bort längst upp på sidan.

  3. Om du inte planerar att fortsätta utveckla iOS-appar kan du också avinstallera Xcode.

Ytterligare information

Se följande artiklar för fler kodexempel: