Versioni dell'SDK Maps per iOS

Seleziona la piattaforma: Android iOS JavaScript

Il team di Google Maps Platform aggiorna regolarmente gli SDK con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. Questa pagina fornisce indicazioni su come gestire le dipendenze su SDK per dispositivi mobili.

  • Per le app mission critical, inserisci un link alla versione più recente dei punti delle principali versione che stai utilizzando (X.*) ed esegui ogni anno l'upgrade alla nuova versione principale.

    Quando rilasci nuove versioni dell'applicazione nel corso dell'anno, puoi iniziare a utilizzare versioni .dotte più recenti di Maps SDK for iOS. In questo modo Non richiedono aggiornamenti nell'applicazione, in quanto le nuove versioni .dotte sono compatibili con le versioni precedenti.

    Vantaggi:

    • Se rilevi problemi in Maps SDK for iOS, le correzioni verranno fornite in un compatibile con le versioni precedenti per 12 mesi dopo il rilascio iniziale della versione principale, l'app Mobile support . Non sarà necessario eseguire urgentemente l'upgrade a una versione dell'SDK incompatibile per usufruire delle correzioni.
    • Le funzionalità e i miglioramenti più recenti sono facili da adottare quando la tua app è già basata su all'ultima versione.
    • Gli aggiornamenti annuali incrementali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro adattare, riscrivere e testare l'applicazione, anziché dover gestire apportate in più release delle versioni principali.

  • Per le app non critiche, inserisci un link a qualsiasi versione fissa. Quando ricevi un ritiro per la versione corretta, avrai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato i tuoi utenti.

    Vantaggi:

    • Lavori di manutenzione meno frequenti.
    • Le nuove versioni della tua app continuano a supportare le funzionalità dispositivi con dispositivi mobili meno recenti sistemi più a lungo (fino a quando non dovrai eseguire l'upgrade a una nuova versione dell'SDK).

I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sui cambiamenti che impatto su ciascuno dei loro progetti. Rimani informati in merito ad aggiornamenti importanti, ritiri e altri cambiamenti.

Installazione

Gestore pacchetti Swift

Maps SDK per iOS può essere installato tramite Gestore pacchetti Swift. Per aggiungere l'SDK, assicurati di avere rimosso eventuali dipendenze di Maps SDK for iOS esistenti.

Per aggiungere l'SDK a un progetto nuovo o esistente:

  1. Apri il file Xcode project o workspace, quindi seleziona File > Aggiungi dipendenze pacchetto.
  2. Inserisci https://github.com/googlemaps/ios-maps-sdk come URL e premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un'entità version specifica, imposta il campo Regola di dipendenza su uno dei le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare la versione più recente con la "versione esatta" . Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli i prodotti del pacchetto, verifica GoogleMaps (per le versioni precedenti alla 9.0.0, verifica GoogleMaps, GoogleMapsBase e GoogleMapsCore) verrà aggiunto a il target main designato. Al termine, fai clic su "Aggiungi pacchetto".
  5. Per verificare l'installazione, vai al riquadro General di destinazione. In Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare le "Dipendenze pacchetto" sezione di "Project Navigator" per verificare il pacchetto e la sua versione.

Per aggiornare package per un progetto esistente:

  1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le dipendenze seguenti: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per ulteriori informazioni, consulta Note di rilascio della versione 9.0.0.

    Dalle impostazioni di configurazione del progetto Xcode, individua Framework, Libraries, e Contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

    • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
  2. Da Xcode, vai su "File > Pacchetti > Aggiorna alle ultime versioni del pacchetto".
  3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la sua versione.

Per rimuovere le dipendenze di Maps SDK for iOS esistenti aggiunte utilizzando CocoaPods, segui questi passaggi:

  1. Chiudi l'area di lavoro Xcode. Apri il terminale ed esegui questo comando: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. Rimuovi Podfile, Podfile.resolved e Esegui l'Xcode workspace se non lo utilizzi per scopi diversi da CocoaPods.

CocoaPods

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>) perché ciò può portare a build imprevedibili e irripetibili. La Maps SDK per iOS rispetta il controllo delle versioni semantico, mentre le nuove versioni principali includono modifiche che provocano errori.

Esempio di dipendenza di un podfile Sintassi di Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.4.0'
end

Manutenzione e upgrade

Per creare con gli ultimi miglioramenti, controlla regolarmente se sono disponibili versioni più recenti e aggiorna la tua versione specifiche. Se stai eseguendo l'aggiornamento a una nuova versione principale, controlla note di rilascio per scoprire come aggiornare il codice e le modifiche non compatibili con le versioni precedenti.

Gestore pacchetti Swift

Per aggiornare package per un progetto esistente:

  1. Se esegui l'upgrade da una versione precedente alla 9.0.0, devi rimuovere le dipendenze seguenti: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B dopo l'upgrade. Non rimuovere la dipendenza per GoogleMaps. Per ulteriori informazioni, consulta Note di rilascio della versione 9.0.0.

    Dalle impostazioni di configurazione del progetto Xcode, individua Framework, Libraries, e Contenuti incorporati. Utilizza il segno meno(-) per rimuovere il seguente framework:

    • GoogleMapsBase (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsCore (solo per gli upgrade da versioni precedenti alla 9.0.0)
    • GoogleMapsM4B (solo per gli upgrade da versioni precedenti alla 9.0.0)
  2. Da Xcode, vai su "File > Pacchetti > Aggiorna alle ultime versioni del pacchetto".
  3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la sua versione.

Cocoapodi

  1. Apri un terminale e vai alla directory contenente Podfile:

    cd <path-to-project>
  2. Esegui pod outdated per verificare se una versione più recente dell'SDK Maps per iOS è disponibile.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna Podfile con questa nuova versione. Consulta Specificare le versioni dei pod per scoprire come impostare una versione specifica in Podfile.
  4. Esegui pod update.
  5. Apporta le modifiche necessarie a seguito dell'upgrade. Consulta le Note di rilascio per un elenco delle modifiche apportate in ciascuna release.
  6. Pulisci e ricrea il progetto selezionando Prodotto > Pulisci, quindi Prodotto > Creazione

Installazione manuale

Ottieni il link ai file di origine più recenti durante l'installazione dell'SDK.

Oltre al polling per le versioni più recenti, Google Cloud progetto proprietari ricevono email relative a modifiche incompatibili con le versioni precedenti che potrebbero influire sui loro progetti. A ricevere notifiche proattive sulle modifiche incompatibili con le versioni precedenti; assegna il ruolo di proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.