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.

A quale versione collegare?

• 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 di Maps SDK for iOS. Ciò non richiederà aggiornamenti nella tua applicazione, poiché le nuove versioni secondarie 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 la release iniziale della versione principale, in base alle norme per il supporto dei dispositivi mobili. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK non compatibile per usufruire delle correzioni.
  • I miglioramenti e le funzionalità più recenti sono facili da adottare quando la tua 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 delle modifiche incompatibili con le versioni precedenti introdotte in più release di versioni principali.

• Per le app non critiche, collega a qualsiasi versione fissa. Quando ricevi una notifica di ritiro per la versione fissa, avrai 12 mesi di tempo per rendere disponibile agli utenti il codice dell'app aggiornato.

  Vantaggi:

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

I Project Owner con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Rimani al corrente di aggiornamenti principali, 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 tutte le dipendenze esistenti di Maps SDK for iOS.

Per aggiungere l'SDK a un progetto nuovo o esistente, segui questi passaggi:

1. Apri il tuo Xcode project o workspace, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
2. Inserisci https://github.com/googlemaps/ios-maps-sdk come URL, premi Invio per inserire il pacchetto e fai clic su "Add Package" (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 l'ultima versione e di utilizzare l'opzione "Versione esatta". Al termine, fai clic su "Aggiungi pacchetto".
4. Nella finestra Scegli i prodotti del pacchetto, verifica che GoogleMaps (per le versioni precedenti alla 9.0.0, verifica GoogleMaps, GoogleMapsBase e GoogleMapsCore) venga aggiunto al target main designato. Al termine, fai clic su "Aggiungi pacchetto".
5. Per verificare l'installazione, vai al riquadro Generale della destinazione. Nella sezione Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati) dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione "Package Dependencies" (Dipendenze del pacchetto) di "Project Navigator" (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Per aggiornare package per un progetto esistente, segui questi passaggi:

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 saperne di più, consulta le note di rilascio della versione 9.0.0.

   Nelle impostazioni di configurazione del progetto Xcode, individua Frameworks, Libraries, and Embedded Content (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 ultime versioni dei pacchetti).
3. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze del pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Importante: a volte non è possibile risolvere gli artefatti o possono verificarsi errori. In questo caso, seleziona "File > Packages > Reset Package Cache" (File > Pacchetti > Reimposta cache pacchetti).

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 Xcode workspace se non li utilizzi per nient'altro oltre a CocoaPods.

Manutenzione e upgrade

Per eseguire la build con i miglioramenti più recenti, controlla regolarmente la disponibilità di nuove versioni e aggiorna le specifiche della versione. Se stai eseguendo l'aggiornamento a una nuova versione principale, consulta le note di rilascio per verificare la presenza di modifiche incompatibili con le versioni precedenti e scoprire come aggiornare il codice.

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

Installazione manuale

Scarica il link ai file di origine 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 alle modifiche incompatibili con le versioni precedenti che potrebbero interessare i loro progetti. Per ricevere notifiche proattive sulle modifiche incompatibili con le versioni precedenti, assegna il ruolo Proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.