iOS-alkalmazás létrehozása (előzetes verzió)

Ez a cikk bemutatja, hogyan adhatja hozzá az Azure Térképek egy iOS-alkalmazáshoz. Végigvezeti az alábbi alapvető lépéseken:

• Állítsa be a fejlesztési környezetet.
• Hozzon létre saját Azure Térképek-fiókot.
• Szerezze be az elsődleges Azure-Térképek kulcsot, amelyet az alkalmazásban használhat.
• Hivatkozzon az Azure Térképek-kódtárakra a projektből.
• Adjon hozzá egy Azure-Térképek vezérlőt az alkalmazáshoz.

Feljegyzés

Azure Térképek iOS SDK kivonása

Az iOS-hez készült Azure Térképek Natív SDK elavult, és 25.31-én megszűnik. A szolgáltatáskimaradások elkerülése érdekében 25.31-ig migráljon az Azure Térképek Web SDK-ba. További információ: Az Azure Térképek iOS SDK migrálási útmutatója.

Előfeltételek

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

• Azure-Térképek-fiók
• Előfizetési kulcs
• Xcode

Feljegyzés

Az Azure Térképek-hitelesítéssel kapcsolatos további információkért lásd az Azure Térképek hitelesítésének kezelését.

Azure Maps-fiók létrehozása

Hozzon létre egy új Azure Térképek-fiókot a következő lépésekkel:

1. Az Azure Portal bal felső sarkában válassza az Erőforrás létrehozása lehetőséget.

2. A Keresés a Marketplace-en mezőbe írja be az Azure Térképek.

3. Az Eredmények területen válassza az Azure Térképek, majd a térkép alatt megjelenő Létrehozás gombot.

4. A Maps-fiók létrehozása lapon adja meg a következő értékeket:

   • A fiókhoz használni kívánt előfizetés.
   • A fiókhoz tartozó erőforráscsoport neve. Választhat, hogy létrehoz egy új erőforráscsoportot, vagy egy meglévő erőforráscsoportot használ.
   • Az új fiók neve.
   • A fiók tarifacsomagja .
   • Olvassa el a licencfeltételeket és az adatvédelmi nyilatkozatot, és jelölje be az azok elfogadását jelző jelölőnégyzetet.
   • Válassza a Létrehozás gombot.

   

A fiók előfizetési kulcsának lekérése

Miután sikeresen létrehozta Térképek fiókját, kérje le az elsődleges kulcsot, amely lehetővé teszi a Térképek API-k lekérdezését.

1. Nyissa meg a Maps-fiókot a portálon.

2. A beállítások szakaszban válassza a Hitelesítés lehetőséget.

3. Másolja ki az elsődleges kulcsot a vágólapra. Mentse a helyi gépre, hogy később felhasználhassa ebben az oktatóanyagban.

Feljegyzés

Ez a rövid útmutató a közös kulcsos hitelesítést használja bemutató célokra, de az éles környezetek előnyben részesített megközelítése a Microsoft Entra-hitelesítés használata.

Projekt létrehozása az Xcode-ban

Először hozzon létre egy új iOS-alkalmazásprojektet. Hajtsa végre az alábbi lépéseket egy Xcode-projekt létrehozásához:

1. A Fájl területen válassza az Új ->Projekt lehetőséget.

2. Az iOS lapon válassza az Alkalmazás, majd a Tovább lehetőséget.

3. Adja meg az alkalmazás nevét, a csomagazonosítót, majd válassza a Tovább gombot.

Az új projekt létrehozásával kapcsolatos további segítségért tekintse meg az Xcode-projekt létrehozása alkalmazáshoz című témakört.

Az Azure Térképek iOS SDK telepítése

Az alkalmazás létrehozásának következő lépése az Azure Térképek iOS SDK telepítése. Hajtsa végre az alábbi lépéseket az SDK telepítéséhez:

1. Ha a Project kezelőjében kiválasztja a kívánt Xcode iOS-projektet, válassza a + csomagfüggőség hozzáadásához szükséges gombot.

   

2. Adja meg a következő értékeket az eredményként kapott párbeszédpanelen:

   • Írja be https://github.com/Azure/azure-maps-ios-sdk-distribution.git a jobb felső sarokban megjelenő keresősávot.
   • Válassza ki Up to Next Major Version a Függőségi szabály mezőt.
   • Adja meg 1.0.0-pre.3 a Függőségi szabály verzió mezőjét.

   

3. Miután feloldotta a csomagot a függőségei mellett, válassza a Csomag hozzáadása gombot a függőség beállításának befejezéséhez.

   

MapControl nézet hozzáadása

1. Egyéni UIView vezérlő hozzáadása a vezérlő megtekintéséhez

2. Osztály kiválasztása MapControl a modulból AzureMapsControl

   

3. Az AppDelegate.swift fájlban:

   • importálás hozzáadása az Azure Térképek SDK-hoz
   • Az Azure Térképek hitelesítési adatainak beállítása

Az Azure Térképek osztály hitelesítési adatainak globális beállításával AzureMaps.configure(subscriptionKey:)AzureMaps.configure(aadClient:aadAppId:aadTenant:)vagy használatával nem kell minden nézetben megadnia a hitelesítési adatokat.

1. Válassza a futtatás gombot az alábbi ábrán látható módon (vagy nyomja le CMD + R) az alkalmazás létrehozásához.

   

Az Xcode néhány másodpercet vesz igénybe az alkalmazás létrehozásához. A build befejezése után tesztelheti az alkalmazást a szimulált iOS-eszközön. Ehhez hasonló térképet kell látnia:

Hozzáférési térkép funkciói

A térképfunkciók testreszabását úgy kezdheti el, hogy egy kezelőben visszatartja a AzureMap példányt mapView.onReady . A nézet hozzáadása után a MapControl minta ViewController a következő kódhoz hasonlóan néz ki:

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()
        })
    }
}

Egy ilyen példához folytassa a sokszögréteg hozzáadása a térképhez az iOS SDK-ban .

Az erőforrások eltávolítása

Az alábbi lépésekkel törölheti az ebben a rövid útmutatóban létrehozott erőforrásokat:

1. Zárja be az Xcode-ot, és törölje a létrehozott projektet.

2. Ha külső eszközön tesztelte az alkalmazást, távolítsa el az alkalmazást az eszközről.

Ha nem tervezi folytatni a fejlesztést az Azure Térképek iOS SDK-val:

1. Lépjen az Azure Portal lapjára. Válassza az Összes erőforrás lehetőséget a fő portállapon. Vagy válassza a menüikont a bal felső sarokban, majd a Minden erőforrás lehetőséget.

2. Válassza ki az Azure Térképek-fiókját. Az oldal tetején válassza a Törlés lehetőséget.

3. Ha nem tervezi folytatni az iOS-alkalmazások fejlesztését, távolítsa el az Xcode-ot.

További információk

További példakódokért tekintse meg az alábbi cikkeket:

• Hitelesítés kezelése az Azure Térképek
• Térképstílusok módosítása iOS-térképeken
• Szimbólumréteg hozzáadása
• Vonalréteg hozzáadása
• Sokszögréteg hozzáadása