SDK di Places per le versioni di iOS

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 vuoi collegarti?

• Per le app mission-critical, esegui il collegamento alla versione più recente del punto della versione principale che stai utilizzando (X.*) ed esegui l'upgrade ogni anno alla nuova versione principale.

  Quando rilasci nuove versioni dell'applicazione nel corso dell'anno, puoi iniziare a utilizzare le nuove versioni dei punti dell'SDK Places per iOS. Ciò non richiederà aggiornamenti nella tua applicazione in quanto le nuove versioni dei punti sono compatibili con le versioni precedenti.

  Vantaggi:

  • Se rilevi problemi nell'SDK Places per 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 mobile. Non sarà necessario eseguire urgentemente l'upgrade a una versione incompatibile dell'SDK per usufruire delle correzioni.
  • Quando la tua app è già basata sull'ultima versione, le funzionalità e i miglioramenti più recenti sono facili da adottare.
  • 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 della versione principale.

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

  Vantaggi:

  • Lavori di manutenzione meno frequenti.
  • Le nuove versioni dell'app continuano a supportare i dispositivi degli utenti che eseguono sistemi operativi per dispositivi mobili meno recenti (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 sulle modifiche che influiscono su ciascuno dei loro progetti. Informati su aggiornamenti, ritiri e altre modifiche importanti.

Installazione

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>) perché può causare build imprevedibili e non ripetibili. L'SDK Places per iOS è conforme al controllo delle versioni semantico; inoltre, le nuove versioni principali includono modifiche che provocano errori.

Esempio di dipendenza di Podfile che utilizza la sintassi Podfile:

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

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.2.1'
end

Manutenzione e upgrade

Per usufruire degli ultimi miglioramenti, controlla regolarmente le versioni più recenti e aggiorna le specifiche della versione. Se esegui l'aggiornamento a una nuova versione principale, consulta le note di rilascio per verificare che le modifiche non siano compatibili con le versioni precedenti e come aggiornare il codice.

Utilizzo dei cocoapie

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 Places per iOS.
3. Se viene rilevata una versione più recente dell'SDK, aggiorna Podfile con questa nuova versione. Consulta la pagina Specificare le versioni dei pod per scoprire come impostare una versione specifica nella tua 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 release.
6. Ripulisci e ricrea il tuo progetto selezionando Prodotto > Pulisci, quindi Prodotto > Build

Manuale

Scarica il link ai file di origine più recenti per installare l'SDK.

Oltre ai sondaggi per le versioni più recenti, i proprietari dei progetti di Google Cloud ricevono email sulle 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 ciascuno dei tuoi progetti.