SDK Driver per le versioni 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 mobile.

  • Per le app mission-critical, collegati all'ultima versione secondaria della versione principale che stai utilizzando (X.*) ed esegui l'upgrade annuale alla nuova versione principale.

    Quando rilasci nuove versioni della tua applicazione durante l'anno, potresti iniziare a utilizzare versioni secondarie più recenti di Driver SDK for iOS. Non sarà necessario aggiornare l'applicazione, poiché le nuove versioni secondarie sono compatibili con le versioni precedenti.

    Vantaggi:

    • Se riscontri problemi in Driver SDK for 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 di assistenza per dispositivi mobile policy. Non dovrai eseguire urgentemente l'upgrade a una versione dell'SDK incompatibile per usufruire delle correzioni.
    • È facile adottare i miglioramenti e le funzionalità più recenti quando l'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 incompatibili con le versioni precedenti introdotte in più versioni principali.

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

    Vantaggi:

    • Lavoro di manutenzione meno frequente.
    • Le nuove versioni dell'app continuano a supportare più a lungo i dispositivi degli utenti che eseguono sistemi operativi mobile meno recenti (finché non devi 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é può portare a build imprevedibili e non ripetibili. Driver SDK per iOS rispetta il controllo delle versioni semantiche e le nuove versioni principali includono modifiche che causano interruzioni.

CocoaPods

Un esempio di dipendenza 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

Swift Package Manager

Driver SDK può essere installato tramite Swift Package Manager. Per aggiungere l'SDK, assicurati di aver rimosso eventuali dipendenze Driver SDK esistenti.

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

  1. Apri il project o workspace di Xcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
  2. Inserisci https://github.com/googlemaps/ios-driver-sdk come URL, premi Invio per estrarre il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
  3. Per installare una version specifica, imposta il campo Dependency Rule su una delle le opzioni basate sulla versione. Per i nuovi progetti, ti consigliamo di specificare l'ultima versione e di utilizzare l'opzione "Exact Version" (Versione esatta). Al termine, fai clic su "Add Package" (Aggiungi pacchetto).

Per aggiornare il package di un progetto esistente:

  1. Per verificare l'installazione, vai alla sezione Package Dependencies (Dipendenze pacchetto) di Project Navigator per verificare il pacchetto e la relativa versione.

Manutenzione e upgrade

Per creare con i miglioramenti più recenti, 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 le modifiche incompatibili con le versioni precedenti e per scoprire come aggiornare il codice.

Cocoapods

  1. Apri un terminale e vai alla directory contenente il Podfile:

    cd <path-to-project>
  2. Esegui pod outdated per verificare se è disponibile una versione più recente di Driver SDK for iOS.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna il Podfile con questa nuova versione. Consulta la sezione Specificare le versioni dei pod per scoprire come impostare una versione specifica nel 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. Pulisci e ricompila il progetto selezionando Product > Clean e poi Product > Build

Installazione manuale

Per il link ai file di origine più recenti consulta la sezione Installare l'SDK.

Oltre a eseguire il polling per le versioni più recenti, i proprietari dei progetti 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 il ruolo di proprietario con un indirizzo email monitorato per ciascuno dei tuoi progetti.