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, collegati alla versione più recente della versione principale in uso (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 con punti più recenti dell'SDK Driver per iOS. Questa operazione non richiederà aggiornamenti nell'applicazione poiché le nuove versioni .dotte sono compatibili con le versioni precedenti.
Vantaggi:
- Se vengono rilevati problemi nell'SDK Driver 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 al supporto mobile. Non sarà necessario eseguire urgentemente l'upgrade 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, inserisci un link a qualsiasi versione fissa. Quando ricevi un avviso di ritiro per la versione corretta, hai 12 mesi di tempo per rendere disponibile il codice dell'app aggiornato ai 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 dei progetti con indirizzi email monitorati ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Rimani aggiornato su aggiornamenti importanti, ritiri e altre modifiche.
Installazione
Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>
), poiché ciò può portare a build imprevedibili e irripetibili. L'SDK Driver per iOS rispetta il controllo delle versioni semantico e le nuove release principali delle versioni includono modifiche che provocano un errore.
CocoaPods
Esempio di dipendenza del podfile che utilizza la sintassi Podfile:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver', '2.0.0' end
Gestore pacchetti Swift
L'SDK Driver può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso tutte le dipendenze esistenti dell'SDK del driver.
Per aggiungere l'SDK a un progetto nuovo o esistente:
-
Apri il file Xcode
project
oworkspace
, quindi vai a File > Aggiungi dipendenze pacchetto. - Inserisci https://github.com/googlemaps/ios-driver-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Aggiungi pacchetto".
-
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:
- Per verificare l'installazione, vai alla sezione Dipendenze del pacchetto di Project Navigator per verificare il pacchetto e la relativa versione.
Manutenzione e upgrade
Per eseguire build con i miglioramenti più recenti, controlla regolarmente la disponibilità di versioni più recenti e aggiornate 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.
Cocoapods
-
Apri un terminale e vai alla directory contenente
Podfile
:cd <path-to-project>
- Esegui
pod outdated
per verificare se è disponibile una versione più recente dell'SDK Driver per iOS. - 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 inPodfile
. - Esegui
pod update
. - Apporta le modifiche necessarie a seguito dell'upgrade. Consulta le Note di rilascio per un elenco delle modifiche in ciascuna release.
- 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 durante l'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 interessare i loro progetti. Per ricevere una notifica proattiva sulle modifiche incompatibili con le versioni precedenti, assegna al ruolo di proprietario un indirizzo email monitorato per ciascuno dei tuoi progetti.