SDK Maps per le versioni iOS

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.
Seleziona piattaforma: Android iOS JavaScript

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 i dispositivi mobili.

  • Per le app mission critical, collegati all'ultima release di punti della versione principale che stai utilizzando (X.*) ed esegui l'upgrade alla nuova versione principale ogni anno.

    Man mano che rilasci nuove versioni della tua applicazione nel corso dell'anno, potresti iniziare a utilizzare le versioni più recenti del punto dell'SDK Maps per iOS. Ciò non richiederà aggiornamenti nell'applicazione, poiché le nuove versioni dei punti sono compatibili con le versioni precedenti.

    Vantaggi:

    • In caso di problemi nell'SDK Maps per iOS, le correzioni saranno 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. Non sarà necessario eseguire urgentemente l'upgrade a una versione SDK incompatibile per beneficiare delle correzioni.
    • Gli aggiornamenti e le funzionalità più recenti sono facili da adottare quando la tua app è già basata sull'ultima versione.
    • Gli aggiornamenti annuali annuali alla versione principale più recente dell'SDK potrebbero richiedere meno lavoro per adattare, riscrivere e testare l'applicazione rispetto a dover gestire le modifiche incompatibili con le versioni precedenti introdotte in più release di versioni principali.

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

    Vantaggi:

    • Lavori di manutenzione meno frequenti.
    • Le nuove versioni della tua app continuano a supportare gli utenti' i dispositivi con sistemi operativi per dispositivi mobili meno recenti rimangono più a lungo (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 interessano ciascuno dei loro progetti. Rimani al corrente dei principali aggiornamenti, ritiri e altre modifiche.

Installazione

Specifica sempre un numero di versione nelle dipendenze anziché utilizzare un operatore ottimista (~>), che può portare a build imprevedibili e non ripetibili. L'SDK Maps per iOS è conforme al controllo delle versioni semantico e le nuove versioni principali includono modifiche che provocano un errore.

Utilizzare CocoaPods

Esempio di dipendenza di Podfile che utilizza la sintassi Podfile:

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

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.2.0'
end

Utilizzo di Cartagine

Esempio di dipendenza Cartfile con la sintassi Cartfile:

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

Manutenzione e upgrade

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

Utilizzare i cocoapod

  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 Maps per iOS.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna il Podfile con questa nuova versione. Consulta la pagina 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 l'elenco delle modifiche in ogni release.
  6. Ripulisci e ricostruisci il tuo progetto selezionando Prodotto > Pulisci, quindi Prodotto > Build

Utilizzo di Cartagine

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

    cd <path-to-project>
  2. Esegui carthage outdated per verificare se è disponibile una versione più recente di Maps SDK for iOS.
  3. Se viene trovata una versione più recente dell'SDK, aggiorna il Cartfile con questa nuova versione. Consulta la pagina Requisiti di versione per scoprire come impostare una versione specifica in Cartfile.
  4. Esegui carthage update.
  5. Apporta le modifiche necessarie in seguito all'upgrade. Consulta le Note di rilascio per l'elenco delle modifiche in ogni release.
  6. Ripulisci e ricostruisci il tuo progetto selezionando Prodotto > Pulisci, quindi Prodotto > Build

Manuale

Ottieni il link ai file di origine più recenti al momento dell'installazione dell'SDK.

Oltre ai sondaggi per le versioni più recenti, i proprietari dei 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 con un indirizzo email monitorato per ciascuno dei tuoi progetti.