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 negli SDK mobile.

  • Per le app mission critical, collegati alla release più recente della versione principale che utilizzi (X.*) ed esegui l'upgrade ogni anno alla nuova versione principale.

    Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, puoi iniziare a utilizzare versioni più recenti dei punti dell'SDK Maps for iOS. Questo non richiederà aggiornamenti nella tua applicazione poiché le nuove versioni dei punti sono compatibili con le versioni precedenti.

    Vantaggi:

    • Se rilevi problemi in Maps SDK for iOS, le correzioni verranno fornite in modo compatibile con le versioni precedenti per 12 mesi dopo il rilascio iniziale della versione principale, in base alle norme relative all'assistenza per dispositivi mobili. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatible per usufruire delle correzioni.
    • Le funzionalità e i miglioramenti più recenti sono facili da adottare quando la tua app è già integrata nella versione più recente.
    • Gli aggiornamenti incrementali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare l'applicazione rispetto alla necessità di gestire modifiche incompatibili con le versioni precedenti introdotte in più release della versione principale.

  • Per le app non fondamentali, inserisci un link a qualsiasi versione corretta. Quando ricevi un avviso di ritiro per quella versione corretta, hai 12 mesi di tempo per rendere disponibile il codice aggiornato dell'app ai tuoi utenti.

    Vantaggi:

    • Lavori di manutenzione meno frequenti.
    • Le nuove versioni della tua app continuano a supportare i dispositivi degli utenti con sistemi operativi mobile meno recenti (fino a quando non devi eseguire l'upgrade a una nuova versione dell'SDK).

I proprietari del progetto con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Resta al corrente su importanti aggiornamenti, ritiri e altre modifiche.

Installazione

Gestione pacchetti Swift

Maps SDK for iOS può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso qualsiasi SDK Maps per iOS esistente.

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

  1. Apri Xcode project o workspace, quindi vai a File > Aggiungi dipendenze pacchetto.
  2. Inserisci https://github.com/googlemaps/ios-maps-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un elemento version specifico, imposta il campo Regola di dipendenza su una delle opzioni basate sulle versioni. Per i nuovi progetti, ti consigliamo di specificare la versione più recente e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
  4. Nella finestra Scegli prodotti nel pacchetto, verifica che GoogleMaps, GoogleMapsBase e GoogleMapsCore vengano aggiunti alla destinazione main designata. Al termine, fai clic su "Aggiungi pacchetto".
  5. Per verificare l'installazione, vai al riquadro General della destinazione. In Framework, librerie e contenuti incorporati dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Dipendenze pacchetto" di "Navigatore progetti" per verificare il pacchetto e la sua versione.

Per aggiornare package per un progetto esistente:

  1. Da Xcode, vai a "File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti".
  2. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Navigatore progetto per verificare il pacchetto e la relativa versione.

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

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

CocoaPods

Specifica sempre un numero di versione nelle dipendenze invece di utilizzare un operatore ottimistico (~>) poiché questo può portare a build imprevedibili e irripetibili. Maps SDK for iOS è conforme al controllo delle versioni semantico e le nuove versioni principali includono modifiche che provocano errori.

Un esempio di dipendenza Podfile utilizzando la sintassi 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 la presenza di versioni più recenti e aggiorna le specifiche della versione. Se stai eseguendo l'aggiornamento a una nuova versione principale, consulta le note di rilascio per conoscere le modifiche incompatibili con le versioni precedenti e sapere come aggiornare il codice.

Gestione pacchetti Swift

Per aggiornare package per un progetto esistente:

  1. Da Xcode, vai a "File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti".
  2. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Navigatore progetto per verificare il pacchetto e la relativa versione.

Cacaopo

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

    cd <path-to-project>
  2. Esegui pod outdated per verificare se è disponibile una versione più recente dell'SDK Maps for iOS.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna Podfile con la nuova versione. Consulta la sezione Specifica delle 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 a ogni release.
  6. Pulisci e ricrea il progetto selezionando Prodotto > Pulisci, quindi Prodotto > Build

Manuale

Ottieni il link ai file di origine più recenti nella pagina di installazione dell'SDK.

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