SDK di Places per le versioni di iOS

Seleziona la piattaforma: Android iOS JavaScript

Nota: le funzionalità dell'SDK Places per iOS disponibili nella tua app sono determinate da una combinazione del numero di versione dell'SDK specificato nella configurazione dell'app e delle API abilitate sulla tua chiave API. Per ulteriori informazioni, consulta Scegliere la versione dell'SDK.

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 sui kit di sviluppo software mobile.

A quale versione collegarsi?

• Per le app mission-critical, esegui il collegamento all'ultima release con il punto della versione principale in uso (X.*) ed esegui l'upgrade annuale alla nuova versione principale.

  Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, puoi iniziare a utilizzare le versioni con punti più recenti di Places SDK for iOS. Per questo non è necessario aggiornare l'applicazione, in quanto le nuove versioni dei punti sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se vengono rilevati problemi in Places 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 relative al supporto mobile. Non è necessario 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 se la tua app è già basata sulla 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 gestione delle modifiche non compatibili con le versioni precedenti introdotte in più release della versione principale.

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

  Vantaggi:

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

I proprietari di progetti con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che influiscono su ciascuno dei loro progetti. Rimani aggiornato su aggiornamenti importanti, ritiri e altre modifiche.

Installazione

Swift Package Manager

L'SDK Places per iOS può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze dell'SDK Places per iOS esistenti.

Importante: queste istruzioni presuppongono l'utilizzo di Xcode 15 o versioni successive, ma dovrebbero essere simili per le versioni precedenti di Xcode.

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

1. Apri Xcode project o workspace, quindi vai a File > Aggiungi dipendenze del pacchetto.
2. Inserisci https://github.com/googlemaps/ios-places-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".
4. Nella finestra Scegli i prodotti del pacchetto, verifica che GooglePlaces, GooglePlacesSwift o entrambi vengano aggiunti al target principale designato. Al termine, fai clic su Aggiungi pacchetto.

   Se stai aggiornando Google Places Swift

   Importante: l'URL di GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui è stato eseguito l'accesso tramite il vecchio URL, https://github.com/googlemaps/ios-places-swift-sdk, rimuovila dalla sezione delle dipendenze del pacchetto di Xcode.

5. Per verificare l'installazione, vai al riquadro Generale del target. In Framework, librerie e contenuti incorporati, dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione. Xcode mostra la versione di GitHub, che corrisponde alla versione di GooglePlaces (ad esempio 9.2.0), ma non alla versione di GooglePlacesSwift (ad esempio 0.3.0).

Per aggiornare il package di un progetto esistente:

1. In Xcode, vai a "File > Pacchetti > Aggiorna alle versioni più recenti dei pacchetti".

   Se stai aggiornando Google Places Swift

   Importante: l'URL di GitHub per accedere a Google Places Swift è cambiato a partire dalla versione 0.3.0. Se stai aggiornando una versione di GooglePlacesSwift a cui è stato eseguito l'accesso tramite il vecchio URL, https://github.com/googlemaps/ios-places-swift-sdk, rimuovila dalla sezione delle dipendenze del pacchetto di Xcode.

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

Importante: a volte gli elementi non possono essere risolti o possono verificarsi errori. In questo caso, seleziona "File > Pacchetti > Ripristina cache dei pacchetti".

CocoaPods

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>), poiché ciò può portare a build imprevedibili e irripetibili. Il SDK Places per iOS è conforme al versionamento semantico e le nuove release delle versioni principali includono modifiche che comportano interruzioni.

Un esempio di dipendenza del file Podfile che utilizza la sintassi di Podfile:

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end

Manutenzione e upgrade

Per eseguire build con i miglioramenti più recenti, controlla regolarmente la disponibilità di versioni più recenti e aggiorna le specifiche della versione. Se esegui l'aggiornamento a una nuova versione principale, consulta le note di rilascio per conoscere le modifiche non compatibili 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 del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.

Importante: a volte gli elementi non possono essere risolti o possono verificarsi errori. In questo caso, seleziona "File > Pacchetti > Ripristina cache dei pacchetti".

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

Installazione manuale

Ottieni il link ai file di origine più recenti nella sezione Installazione dell'SDK.

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