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.
Quale versione collegare?
-
Per le app mission-critical, inserisci un link all'ultima release di punti della versione principale che utilizzi (X.*) ed esegui l'upgrade annuale alla nuova versione principale.
Man mano che rilasci nuove versioni dell'applicazione durante l'anno, puoi iniziare a utilizzare le versioni più recenti dell'SDK Driver per iOS. Ciò non richiederà aggiornamenti nella tua applicazione poiché le nuove versioni dei punti sono compatibili con le versioni precedenti.
Vantaggi:
- Se rilevi 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 all'assistenza per i dispositivi mobili. Per beneficiare delle correzioni, non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatibile.
- Gli aggiornamenti e le funzionalità più recenti sono facili da adottare quando l'app è già basata sulla versione più recente.
- Gli aggiornamenti incrementali annuali alla versione principale più recente dell'SDK possono richiedere meno lavoro per adattarsi, riscrivere e testare l'applicazione, rispetto alla necessità di gestire 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 riceverai un avviso di ritiro di questa 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 della tua app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi per dispositivi mobili meno recenti (finché non dovrai eseguire l'upgrade a una nuova versione dell'SDK).
I proprietari del progetto con indirizzo email monitorato ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Informati sui principali aggiornamenti, ritiri e altre modifiche.
Installazione
Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimistico (~>
) che può generare build imprevedibili e non ripetibili. L'SDK Driver per iOS aderisce al controllo delle versioni semantico e le nuove versioni della versione principale includono modifiche che provocano un errore.
Utilizzo di CocoaPods
Esempio di dipendenza del podfile con la sintassi Podfile:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver', '2.0.0' end
Un esempio di dipendenza del podfile per l'utilizzo di una versione beta dell'SDK del driver:
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver', '2.1.0-beta01.0' end
Manutenzione e upgrade
Per sviluppare le funzionalità più recenti, controlla regolarmente le versioni più recenti e aggiorna le specifiche. Se esegui l'aggiornamento a una nuova versione principale, consulta le note di rilascio per verificare se sono presenti modifiche incompatibili con le versioni precedenti e come aggiornare il codice.
Utilizzo dei Cocoapod
-
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 pagina Specificare le versioni dei pod per scoprire come impostare una versione specifica inPodfile
. - Esegui
pod update
. - Apporta le modifiche necessarie in seguito all'upgrade. Consulta le Note di rilascio per un elenco delle modifiche di ogni release.
- Pulisci e ricrea il progetto selezionando Prodotto > Pulito e poi Prodotto > Build
Manuale
Scarica il link ai file di origine più recenti durante l'installazione dell'SDK.
Oltre ai sondaggi per le versioni più recenti, i proprietari di progetti Google Cloud ricevono email sulle 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 di proprietario a un indirizzo email monitorato per ciascuno dei tuoi progetti.