Skapa en iOS-app (förhandsversion)

  • Artikel
  • 3 minuter för att läsa

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 utvecklingsmiljön.
  • 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.

Förutsättningar

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 Portal väljer du Skapa en resurs.

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

  3. Från 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å för det här kontot.
    • Läs licensen och sekretesspolicy och markera kryssrutan för att godkänna villkoren.
    • Välj knappen Skapa.

    Skapa ett Azure Maps-konto.

Hitta primärnyckeln för ditt konto

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

  1. Öppna ditt Maps-konto i portalen.

  2. I inställningsavsnittet väljer du Autentisering.

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

Anteckning

Den här snabbstarten använder autentiseringsmetoden delad nyckel i demonstrationssyfte, men den bästa metoden för alla produktionsmiljöer är att använda Azure Active Directory autentisering.

Hämta prenumerationsnyckeln.

Skapa ett projekt i Xcode

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

  1. Under Arkiv väljer du Ny -> Project.

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

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

Se Skapa en Xcode-Project för en app för mer hjälp med att skapa ett nytt projekt.

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:n:

  1. När du har valt önskat Xcode iOS-projekt i Project navigatören klickar du på + knappen för att lägga till paketberoende.

    Lägg till paketberoende.

  2. Ange följande 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.1 i fältet Beroenderegelversion.

    Lägg till en 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ägga 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 måste du:

    • lägg till import för Azure Kartor SDK
    • ange autentiseringsinformation för Azure Kartor-server

Om du anger autentiseringsinformationen för AzureMaps-klassen globalt med metoderna eller blir det så att du inte behöver lägga till AzureMaps.configure(subscriptionKey:) AzureMaps.configure(aadClient:aadAppId:aadTenant:) autentiseringsinformation i varje vy.

  1. Välj körningsknappen enligt följande bild (eller tryck på CMD + R ) för att skapa ditt program.

    Kör iOS-programmet.

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

Din första karta på ett iOS-program.

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 som 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 Azure Portal sidan. Välj Alla resurser på huvudportalsidan. Du kan också välja 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 även avinstallera Xcode.

Ytterligare information

Se följande artiklar för ytterligare kodexempel: