Norme per il supporto delle versioni dei sistemi operativi mobile
Man mano che i sistemi operativi mobile si evolvono e che lanciamo funzionalità e aggiornamenti di Google Maps Platform, blocchiamo il supporto per le versioni precedenti dei sistemi operativi mobile.
Il blocco del supporto delle versioni degli SDK Google Maps Platform per versioni specifiche di Android e iOS aiuta Google a definire l'ambito e a scalare i test degli SDK.
Questa sezione descrive le norme di supporto di Google Maps Platform per le piattaforme mobile. Queste norme riguardano solo i prodotti con disponibilità generale (GA).
I blocchi del supporto dei sistemi operativi non sono coperti dal periodo di preavviso di 12 mesi per l'interruzione dei servizi, come definito nei Termini di servizio di Google Maps Platform.
I proprietari dei progetti ricevono notifiche proattive sulle modifiche che interessano ciascuno dei loro progetti. Rimani aggiornato su aggiornamenti principali, ritiri e altre modifiche.
Terminologia
Riepilogo della tabella di supporto della versione minima del sistema operativo Android
| Ultima versione dell'SDK che viene compilata con questa versione del sistema operativo (data di rilascio) | ||||||
|---|---|---|---|---|---|---|
| Versione di Android | SDK Maps (libreria client) | SDK Navigation | Places SDK | SDK Driver | SDK Consumer | |
| Android Nougat - Livello API 24 (2016) | Più recenti | Più recenti | Più recenti | Più recenti | Più recenti | |
| Android Marshmallow - Livello API 23 (2015) | Più recenti | 6.3 (18/06/2025) | 4.4.1 (06/07/2025) | 6.2 (18/06/2025) | Più recenti | |
| Android Lollipop - Livello API 21 (2014) | 19.2.0 (14/04/2025) | 4.99 (06/07/2023) | 3.5.0 (28/05/2024) | 4.99 (09/08/ 2023) | 1.99.1 (31/ 08/ 2023) | |
| Android KitKat - Livello API 19 (2013) | 18.2(18/10/2023) | 3.2(07/10/2021) | 2.7.0(11/01/2021) | 3.0.4 (28/07/2021) | 0.9.28 (18/05/ 2021) | |
Riepilogo della tabella di supporto della versione minima del sistema operativo iOS
| Ultima versione dell'SDK che viene compilata con questa versione del sistema operativo (data di rilascio) | ||||
|---|---|---|---|---|
| Versione iOS | SDK Maps e Navigation | Places SDK | SDK Consumer e Driver | |
| 16 (2022) e versioni successive | Più recenti | Più recenti | Più recenti | |
| 15 (2021) | 9.4 (18/03/2025) | 9.4 (10/03/2025) | 9.2.1 (28/03/2025) | |
| 14 (2020) | 8.5 (01/04/2024) | 8.5 (01/04/2024) | 3.3.0 (06/03/2024) | |
| 13 (2019) | 7.4 (27/02/2023) | 7.4 (27/02/2023) | 2.2.1 (17/04/2023) | |
| 12 (2018) | 6.2 (25/04/2022) | 6.2 (25/04/2022) | ||
Norme di supporto del sistema operativo Android
Le nuove release degli SDK Google Maps Platform per Android supportano una versione del sistema operativo Android (livello API come 29 e 30) per almeno 6 anni dopo il rilascio iniziale di quella versione del sistema operativo. I blocchi del sistema operativo possono essere introdotti senza incrementare il numero della versione principale.
Ad esempio, per una versione di Android rilasciata nel 2020, le nuove release di Places SDK for Android supporteranno quella versione almeno fino al 2026.
Di tanto in tanto, quando l'utilizzo di un sistema operativo Android di almeno 6 anni fa diminuisce in modo sufficiente:
-
Google bloccherà il supporto per quella versione del sistema operativo Android, rendendo la versione successiva la versione minima supportata del sistema operativo nelle nuove release degli SDK per Android.
-
Di conseguenza, dovrai decidere se:
- Adottare l'ultima versione dell'SDK e aumentare la versione minima supportata del sistema operativo per le nuove versioni dell'app e specificare di conseguenza le versioni delle dipendenze di build.
- Oppure rimanere alla versione precedente dell'SDK, che può limitare la tua capacità di ricevere correzioni di bug in modo retrocompatibile in base alla sezione Supporto degli SDK.
Ad esempio, Google potrebbe bloccare il supporto di Android 7 (livello API 25, rilasciato nel 2016), rendendo Android 8 (livello API 26) la versione minima supportata del sistema operativo nelle nuove versioni degli SDK Google Maps Platform per Android. Le versioni delle app create con le versioni precedenti dell'SDK continueranno a essere eseguite sui dispositivi con Android 7, mentre le versioni delle app create con le versioni dell'SDK rilasciate dopo questo punto non potranno essere eseguite sui dispositivi con Android 7.
L'eccezione alla pianificazione del blocco della versione del sistema operativo è Maps SDK for Android, che viene fornito come parte di Google Play Services.
Maps SDK for Android
Maps SDK for Android non rientra in queste norme di supporto della versione del sistema operativo. Il runtime di Maps SDK for Android è incluso in Google Play Services (noto anche come "Google Mobile Services" o "GMS Core"), necessario per eseguire le app Google sui dispositivi Android. Poiché Google Play Services segue la propria pianificazione di supporto del livello API Android (come illustrato in questo annuncio), la pianificazione di supporto di Maps SDK for Android dipende dal supporto del sistema operativo di Google Play Services. Per informazioni sulle versioni dell'API Android su cui viene eseguito Google Play Services, consulta Configurazione di Google Play Services.
Tuttavia, la libreria client (facciata API) di Maps SDK for Android che funziona con il runtime delle mappe su Google Play Services è versionata e supportata su livelli API Android specifici in base alle norme di supporto del sistema operativo Android. Quando creano app con Maps SDK for Android, gli sviluppatori impostano la versione della libreria client come dipendenza.
Se un'app utilizza una versione più recente della libreria client, ma viene eseguita su un dispositivo con una versione precedente di Google Play Services, le funzionalità più recenti chiamate non funzioneranno su questi dispositivi. Non si verificano arresti anomali o eccezioni dell'app.
Di tanto in tanto, Google Play Services potrebbe limitare il rilascio di applicazioni create con versioni precedenti della libreria client (facciata API). In questo caso, riceverai un avviso al momento della pubblicazione dell'applicazione nel Play Store e potresti non essere in grado di effettuare ulteriori release finché la libreria non viene aggiornata. Scopri di più nel Centro assistenza Play Console.
Per ulteriori informazioni sulle release di Android, consulta le release della piattaforma SDK Android.
Norme di supporto di iOS
Le nuove release degli SDK Google Maps Platform per iOS supportano una versione di iOS per almeno 3 anni dopo il rilascio iniziale di quella versione del sistema operativo. I blocchi del sistema operativo possono essere introdotti senza incrementare il numero della versione principale. Per esempi, consulta Norme di supporto del sistema operativo Android.
Supporto degli SDK
Quando Google rilascia una nuova versione di un SDK mobile di Google Maps Platform:
- Google ha testato questa versione rispetto alle versioni del sistema operativo fino alla versione minima supportata del sistema operativo indicata.
- Le future correzioni dell'SDK entro 12 mesi dal rilascio principale iniziale di questa versione saranno retrocompatibili* con questa versione.
- * Esclusi 1. Incompatibilità con le versioni precedenti che potrebbero essere introdotte dalle dipendenze dell'SDK, ad es. Kotlin; e 2. Incompatibilità con le versioni precedenti dovute alla versione minima supportata del sistema operativo. Queste modifiche possono essere introdotte senza aumentare il numero della versione principale.
- Oltre 12 mesi dopo la data di rilascio principale iniziale di questa versione, le correzioni dell'SDK potrebbero non essere retrocompatibili con questa versione.
- Google correggerà i problemi di backend causati dai servizi Google Maps Platform fino al ritiro della versione dell'SDK.
Supporto IDE
Gli SDK Google Maps Platform per iOS sono compatibili con lo sviluppo per iOS nell'ambiente di sviluppo integrato Xcode di Apple. Le diverse versioni di Xcode includono versioni diverse del linguaggio di programmazione Swift, nonché SDK per versioni diverse dei sistemi operativi Apple.
Google aumenta periodicamente la versione minima di Xcode supportata nelle nuove versioni principali degli SDK Google Maps Platform per iOS. Consulta le note di rilascio e gli argomenti relativi al software supportato per visualizzare la versione minima supportata di Xcode per la versione dell'SDK con cui vuoi creare.
Supporto browser
L'API Maps JavaScript e l'API Maps Embed supportano i seguenti browser web:
Computer- La versione attuale di Microsoft Edge (Windows), escluso il modo IE.
- Le due versioni principali stabili più recenti di Firefox (Windows, macOS, Linux).
- Le due versioni principali stabili più recenti di Chrome (Windows, macOS, Linux).
- Le due versioni principali stabili più recenti di Safari (macOS).
- La versione attuale di Chrome su Android 4.1 e versioni successive.
- Chrome WebView su Android 4.4 e versioni successive.
- Mobile Safari sulle versioni principali attuale e precedente di iOS.
- UIWebView e WKWebView sulle versioni principali attuale e precedente di iOS.
- La versione attuale di Chrome per iOS.