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 dagli SDK per dispositivi mobili.

  • Per le app mission-critical, crea un link all'ultima versione secondaria della versione principale che stai utilizzando (X.*) ed esegui l'upgrade annuale alla nuova versione principale.

    Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, potresti iniziare a utilizzare versioni secondarie più recenti dell'SDK Maps per iOS. Ciò non richiederà aggiornamenti nella tua applicazione, poiché le nuove versioni secondarie sono compatibili con le versioni precedenti.

    Vantaggi:

    • Se riscontri problemi in Maps SDK for iOS, le correzioni verranno fornite in modo retrocompatibile per 12 mesi dopo il rilascio iniziale della versione principale, in conformità alle norme di assistenza mobile. Non dovrai eseguire l'upgrade urgente a una versione dell'SDK incompatibile per usufruire delle correzioni.
    • I miglioramenti e le funzionalità più recenti sono facili da adottare quando l'app è già basata sull'ultima versione.
    • Gli aggiornamenti incrementali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare l'applicazione rispetto alla gestione di modifiche non compatibili con le versioni precedenti introdotte in più release di versioni principali.

  • Per le app non critiche, collega una versione corretta. Quando ricevi una notifica di ritiro per quella versione corretta, hai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato ai tuoi utenti.

    Vantaggi:

    • Lavoro di manutenzione meno frequente.
    • Le nuove versioni della tua app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi mobili 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. Rimani al corrente di aggiornamenti importanti, ritiri e altre modifiche.

Installazione

Swift Package Manager

Maps SDK for iOS può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze esistenti di Maps SDK for iOS.

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

  1. Apri Xcode project o workspace, poi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
  2. Inserisci https://github.com/googlemaps/ios-maps-sdk come URL, premi Invio per importare il pacchetto e fai clic su "Aggiungi pacchetto".
  3. Per installare un version specifico, imposta il campo Regola di dipendenza su una delle opzioni basate sulla versione. 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".

Per aggiornare il package di un progetto esistente:

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

    Nelle impostazioni di configurazione del progetto Xcode, trova Framework, librerie 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. In Xcode, vai a "File > Packages > Update To Latest Package Versions" (File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti).
  3. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

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

  1. Chiudi lo spazio 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 Xcode workspace se non li utilizzi per altro oltre a CocoaPods.

CocoaPods

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>), in quanto ciò può portare a build imprevedibili e non ripetibili. Maps SDK per iOS rispetta il controllo delle versioni semantico e le nuove versioni principali includono modifiche che causano interruzioni.

Un esempio di dipendenza Podfile che utilizza la sintassi Podfile:

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

platform :ios, '16.0'

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

Manutenzione e upgrade

Per creare con i miglioramenti più recenti, controlla regolarmente le versioni più recenti e aggiorna le specifiche della versione. Se esegui l'aggiornamento a una nuova versione principale, controlla le note di rilascio per le modifiche incompatibili con le versioni precedenti e come aggiornare il codice.

Swift Package Manager

Per aggiornare il package di un progetto esistente:

  1. Per verificare l'installazione, vai alla sezione Dipendenze pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

Cocoapods

  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 di Maps SDK for iOS.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna Podfile con questa nuova versione. Consulta la sezione Specifica delle versioni dei pod per scoprire come impostare una versione specifica nel tuo Podfile.
  4. Esegui pod update.
  5. Apporta le modifiche necessarie in seguito all'upgrade. Consulta le note di rilascio per un elenco delle modifiche apportate a ogni versione.
  6. Pulisci e ricompila il progetto selezionando Prodotto > Pulisci e poi Prodotto > Compila.

Installazione manuale

Ottieni il link ai file sorgente più recenti in Installazione dell'SDK.

Oltre a eseguire il polling per le versioni più recenti, i proprietari dei progetti Google Cloud ricevono email relative a modifiche incompatibili con le versioni precedenti che potrebbero influire sui loro progetti. Per ricevere una notifica proattiva sulle modifiche incompatibili con le versioni precedenti, assegna il ruolo Proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.