Condividi tramite

Creare un'app iOS (anteprima)

  • Articolo

Questo articolo illustra come aggiungere il Mappe di Azure a un'app iOS. L'articolo descrive le operazioni di base seguenti:

  • Configurare l'ambiente di sviluppo.
  • Creare un proprio account di Mappe di Azure.
  • Ottenere la chiave primaria di Mappe di Azure da usare nell'app.
  • Fare riferimento alle librerie di Mappe di Azure dal progetto.
  • Aggiungere un controllo di Mappe di Azure all'app.

Nota

ritiro di iOS SDK Mappe di Azure

Il Mappe di Azure Native SDK per iOS è ora deprecato e verrà ritirato il 3/31/25. Per evitare interruzioni del servizio, eseguire la migrazione all'SDK Web di Mappe di Azure entro il 3/31/25. Per altre informazioni, vedere La guida alla migrazione Mappe di Azure di iOS SDK per iOS.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Nota

Per altre informazioni sull'autenticazione in Mappe di Azure, vedere Gestire l'autenticazione in Mappe di Azure.

Creare un account di Mappe di Azure

Creare un account di Mappe di Azure eseguendo questa procedura:

  1. Nell'angolo superiore sinistro della portale di Azure selezionare Crea una risorsa.

  2. Nella casella Cerca nel marketplace digitare Mappe.

  3. In Risultati selezionare Mappe di Azure, quindi selezionare il pulsante Crea visualizzato sotto la mappa.

  4. Nella pagina Crea account di Mappe immettere i valori seguenti:

    • La sottoscrizione da usare per l'account.
    • Il nome del gruppo di risorse per l'account. Per il gruppo di risorse è possibile selezionare l'opzione Crea nuovo o Usa esistente.
    • Il nome del nuovo account.
    • Piano tariffario dell'account.
    • Leggere la Licenza e l'Informativa sulla Privacy e selezionare la casella di controllo per accettare le condizioni.
    • Selezionare il pulsante Crea.

    Creare un account mappe di Azure.

Ottenere la chiave di sottoscrizione per l'account

Dopo che è stato creato l'account di Mappe, recuperare la chiave primaria che consente di eseguire query nelle API di Mappe.

  1. Aprire l'account di Mappe nel portale.

  2. Nella sezione delle impostazioni selezionare Autenticazione.

  3. Copiare il valore di Chiave primaria negli Appunti. Salvarlo in locale per usarlo in seguito in questa esercitazione.

Nota

Questa guida introduttiva usa l'autenticazione con chiave condivisa a scopo dimostrativo, ma l'approccio preferito per qualsiasi ambiente di produzione consiste nell'usare l'autenticazione Microsoft Entra.

Screenshot che mostra la chiave di sottoscrizione Mappe di Azure nel portale di Azure.

Creare un progetto in Xcode

Creare prima di tutto un nuovo progetto di app iOS. Completare questi passaggi per creare un progetto Xcode:

  1. In File selezionare Nuovo ->Progetto.

  2. Nella scheda iOS selezionare App e quindi Avanti.

  3. Immettere il nome dell'app, l'ID bundle e quindi selezionare Avanti.

Per altre informazioni sulla creazione di un nuovo progetto, vedere Creazione di un progetto Xcode per un'app.

Creare la prima applicazione iOS.

Installare Mappe di Azure iOS SDK

Il passaggio successivo nella compilazione dell'applicazione consiste nell'installare Mappe di Azure iOS SDK. Per installare l'SDK, seguire questa procedura:

  1. Con il progetto Xcode iOS desiderato selezionato nello strumento di spostamento del progetto, selezionare il + pulsante Aggiungi dipendenza pacchetto.

    Aggiungere la dipendenza del pacchetto.

  2. Immettere i valori seguenti nella finestra di dialogo risultante:

    • Immettere https://github.com/Azure/azure-maps-ios-sdk-distribution.git nella barra di ricerca visualizzata nell'angolo superiore destro.
    • Selezionare Up to Next Major Version nel campo Regola di dipendenza.
    • Immettere 1.0.0-pre.3 nel campo Versione regola di dipendenza.

    Aggiungere una regola di dipendenza a un progetto iOS.

  3. Dopo aver risolto il pacchetto insieme alle relative dipendenze, selezionare il pulsante Aggiungi pacchetto per completare l'installazione delle dipendenze.

    Aggiungere un pacchetto a un progetto iOS.

Aggiungere la visualizzazione MapControl

  1. Aggiungere custom to view controller (Aggiungi personalizzato UIView al controller di visualizzazione)

  2. Selezionare MapControl la classe dal AzureMapsControl modulo

    Aggiungere un controllo Mappe di Azure.

  3. Nel file AppDelegate.swift:

    • aggiungere l'importazione per Mappe di Azure SDK
    • Impostare le informazioni di autenticazione di Mappe di Azure

Impostando le informazioni di autenticazione nella classe Azure Mappe a livello globale usando AzureMaps.configure(subscriptionKey:) o AzureMaps.configure(aadClient:aadAppId:aadTenant:), non è necessario aggiungere le informazioni di autenticazione in ogni visualizzazione.

  1. Selezionare il pulsante Esegui, come illustrato nell'immagine seguente (o premere CMD + R) per compilare l'applicazione.

    Eseguire l'applicazione iOS.

Xcode richiede alcuni secondi per compilare l'applicazione. Al termine della compilazione, è possibile testare l'applicazione nel dispositivo iOS simulato. Verrà visualizzata una mappa simile a questa:

La prima mappa in un'applicazione iOS.

Funzionalità della mappa di accesso

È possibile iniziare a personalizzare la funzionalità della mappa recuperando il blocco all'istanza AzureMap in un mapView.onReady gestore. Dopo aver aggiunto la visualizzazione, l'esempio MapControl ViewController dovrebbe essere simile al codice seguente:

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

Passare ad Aggiungere un livello poligono alla mappa in iOS SDK per uno di questi esempi.

Pulire le risorse

Per pulire le risorse create in questa guida introduttiva, seguire questa procedura:

  1. Chiudere Xcode ed eliminare il progetto creato.

  2. Se l'applicazione è stata testata in un dispositivo esterno, disinstallarla da tale dispositivo.

Se non si prevede di continuare a sviluppare con Mappe di Azure iOS SDK:

  1. Accedere alla pagina del portale di Azure. Selezionare Tutte le risorse dalla pagina principale del portale. In alternativa, selezionare l'icona del menu nell'angolo superiore sinistro e quindi Tutte le risorse.

  2. Selezionare il proprio account di Mappe di Azure. Nella parte superiore della pagina selezionare Elimina.

  3. Facoltativamente, se non si prevede di continuare a sviluppare app iOS, disinstallare Xcode.

Informazioni aggiuntive

Per altri esempi di codice, vedere gli articoli seguenti: