Come le release precedenti, Android 17 include modifiche al comportamento che potrebbero influire sulla tua app. Le seguenti modifiche al comportamento si applicano esclusivamente alle app che hanno come target Android 17 o versioni successive. Se la tua app ha come target Android 17 o versioni successive, devi modificarla per supportare questi comportamenti, ove applicabile.
Assicurati di esaminare anche l'elenco delle modifiche al comportamento che interessano tutte le app
in esecuzione su Android 17, indipendentemente dal targetSdkVersion della tua app.
Funzionalità di base
Android 17 include le seguenti modifiche che modificano o espandono varie funzionalità di base del sistema Android.
Nuova implementazione senza blocchi di MessageQueue
Beginning with Android 17, apps targeting Android 17 (API level 37)
or higher receive a new lock-free implementation of
android.os.MessageQueue. The new implementation improves performance and
reduces missed frames, but may break clients that reflect on MessageQueue
private fields and methods.
For more information, including mitigation strategies, see MessageQueue behavior change guidance.
I campi finali statici ora non sono modificabili
Apps running on Android 17 or higher that target
Android 17 (API level 37) or higher cannot change static final fields. If
an app attempts to change a static final field by using reflection, it will
cause an IllegalAccessException. Attempting to modify one of these fields
through JNI APIs (such as SetStaticLongField()) will cause the app to crash.
Accessibilità
Android 17 apporta le seguenti modifiche per migliorare l'accessibilità.
Supporto dell'accessibilità per la digitazione complessa della tastiera fisica IME
Questa funzionalità introduce nuove AccessibilityEvent e TextAttribute
API per migliorare il feedback vocale dello screen reader per l'input di lingue CJKV. Le app IME CJKV ora possono segnalare se è stato selezionato un candidato alla conversione del testo durante la composizione del testo. Le app con campi di modifica possono specificare i tipi di modifiche del testo quando inviano eventi di accessibilità relativi alla modifica del testo.
Ad esempio, le app possono specificare che si è verificata una modifica del testo durante la composizione del testo o che una modifica del testo è il risultato di un commit.
In questo modo, i servizi di accessibilità come gli screen reader possono fornire un feedback più preciso in base alla natura della modifica del testo.
Adozione di app
App IME: quando impostano la composizione del testo nei campi di modifica, gli IME possono utilizzare
TextAttribute.Builder.setTextSuggestionSelected()per indicare se è stato selezionato un candidato alla conversione specifico.App con campi di modifica: le app che gestiscono un
InputConnectionpersonalizzato possono recuperare i dati di selezione dei candidati chiamandoTextAttribute.isTextSuggestionSelected(). Queste app devono quindi chiamareAccessibilityEvent.setTextChangeTypes()quando inviano eventiTYPE_VIEW_TEXT_CHANGED. Questa funzionalità è attivata per impostazione predefinita nelle app destinate ad Android 17 (livello API 37) che utilizzanoTextViewstandard. Ovvero,TextViewgestirà il recupero dei dati dall'IME e l'impostazione dei tipi di modifiche del testo quando invia eventi ai servizi di accessibilità.Servizi di accessibilità: i servizi di accessibilità che elaborano gli eventi
TYPE_VIEW_TEXT_CHANGEDpossono chiamareAccessibilityEvent.getTextChangeTypes()per identificare la natura della modifica e adeguare di conseguenza le proprie strategie di feedback.
Privacy
Android 17 include le seguenti modifiche per migliorare la privacy degli utenti.
ECH (Encrypted Client Hello) abilitato in modo opportunistico
Android 17 introduce il supporto della piattaforma per Encrypted Client Hello (ECH), un'estensione TLS che migliora la privacy degli utenti criptando l'indicazione del nome del server (SNI) nell'handshake TLS. Questa crittografia impedisce agli osservatori di rete di identificare facilmente il dominio specifico a cui si connette la tua app.
Per le app che hanno come target Android 17 (livello API 37) o versioni successive, ECH viene utilizzato in modo opportunistico per le connessioni TLS. ECH è attivo solo se la libreria di rete utilizzata dall'app (ad esempio HttpEngine, WebView o OkHttp) ha integrato il supporto ECH e se anche il server remoto supporta il protocollo ECH. Se non è possibile negoziare ECH, la connessione torna automaticamente a un handshake TLS standard senza crittografia SNI.
Per consentire alle app di personalizzare questo comportamento, Android 17 aggiunge un nuovo
<domainEncryption> elemento al file di configurazione della sicurezza di rete.
Gli sviluppatori possono utilizzare <domainEncryption> all'interno dei tag <base-config> o
<domain-config> per selezionare una modalità ECH (ad esempio,
"opportunistic", "enabled" o "disabled") a livello globale o per dominio
basis.
Per saperne di più, consulta la documentazione di Encrypted Client Hello.
Autorizzazione di accesso alla rete locale richiesta per le app che hanno come target Android 17
Android 17 introduce l'autorizzazione di runtime ACCESS_LOCAL_NETWORK
per proteggere gli utenti da accessi non autorizzati alla rete locale. Poiché rientra
nel gruppo di autorizzazioni NEARBY_DEVICES esistente, agli utenti che hanno già
concesso altre autorizzazioni NEARBY_DEVICES non viene richiesto di nuovo. Questo nuovo
requisito impedisce alle app dannose di sfruttare l'accesso illimitato alla rete locale
per il monitoraggio utenti e il fingerprinting. Se dichiara e richiede
questa autorizzazione, la tua app può rilevare e connettersi a dispositivi sulla rete
locale (LAN), come dispositivi per la smart home o ricevitori di trasmissione.
Le app che hanno come target Android 17 (livello API 37) o versioni successive ora hanno due modi per mantenere la comunicazione con i dispositivi LAN: adottare selettori di dispositivi che tutelano la privacy e sono mediati dal sistema per saltare la richiesta di autorizzazione oppure richiedere esplicitamente questa nuova autorizzazione in fase di runtime per mantenere la comunicazione con la rete locale.
Per saperne di più, consulta la documentazione relativa all'autorizzazione di accesso alla rete locale.
Nascondi le password dai dispositivi fisici
If an app targets Android 17 (API level 37) or higher and the user is using
a physical input device (for example, an external keyboard), the Android
operating system applies the new show_passwords_physical setting to all
characters in the password field. By default, that setting hides all password
characters.
The Android system shows the last-typed password character to help the user see if they mistyped the password. However, this is much less necessary with larger external keyboards. In addition, devices with external keyboards often have larger displays, which increases the danger of someone seeing the typed password.
If the user is using the device's touchscreen, the system applies the new
show_passwords_touch setting.
Sicurezza
Android 17 apporta i seguenti miglioramenti alla sicurezza di dispositivi e app.
Sicurezza attività
In Android 17, the platform continues its shift toward a "secure-by-default" architecture, introducing a suite of enhancements designed to mitigate high-severity exploits such as phishing, interaction hijacking, and confused deputy attacks. This update requires developers to explicitly opt in to new security standards to maintain app compatibility and user protection.
Key impacts for developers include:
- BAL hardening & improved opt-in: We are refining Background Activity
Launch (BAL) restrictions by extending protections to
IntentSender. Developers must migrate away from the legacyMODE_BACKGROUND_ACTIVITY_START_ALLOWEDconstant. Instead, you should adopt granular controls likeMODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE, which restricts activity starts to scenarios where the calling app is visible, significantly reducing the attack surface. - Adoption tools: Developers should utilize strict mode and updated lint checks to identify legacy patterns and ensure readiness for future target SDK requirements.
Attiva CT per impostazione predefinita
Se un'app ha come target Android 17 (livello API 37) o versioni successive, la trasparenza dei certificati (CT) è attivata per impostazione predefinita. (Su Android 16, la CT è disponibile, ma le app dovevano attivare la funzionalità.)
Safer Native DCL—C
Se la tua app ha come target Android 17 (livello API 37) o versioni successive, la protezione Safer Dynamic Code Loading (DCL) introdotta in Android 14 per i file DEX e JAR ora si estende alle librerie native.
Tutti i file nativi caricati utilizzando System.load() devono essere contrassegnati come di sola lettura.
In caso contrario, il sistema genera UnsatisfiedLinkError.
Ti consigliamo di evitare il caricamento dinamico del codice nelle app, quando possibile, in quanto aumenta notevolmente il rischio che un'app possa essere compromessa da un'iniezione di codice o da un'alterazione del codice.
Limitare i campi PII nella visualizzazione dei dati CP2
Per le app che hanno come target Android 17 (livello API 37) e versioni successive, Provider di contatti 2 (CP2) limita la visualizzazione di determinate colonne contenenti informazioni che consentono l'identificazione personale (PII). Quando questa modifica è abilitata, queste colonne vengono rimosse dalla visualizzazione dei dati per migliorare la privacy degli utenti. Le colonne con limitazioni includono:
Le app che utilizzano queste colonne da ContactsContract.Data
possono estrarle da ContactsContract.RawContacts
invece, unendole a RAW_CONTACT_ID.
Applica controlli SQL rigorosi in CP2
Per le app che hanno come target Android 17 (livello API 37) e versioni successive, Provider di contatti 2 (CP2) applica una convalida rigorosa delle query SQL quando si accede alla tabella ContactsContract.Data senza l'autorizzazione READ_CONTACTS.
Con questa modifica, se un'app non ha READ_CONTACTS
autorizzazione, StrictColumns e
StrictGrammar opzioni vengono impostate quando si esegue una query
sulla tabella ContactsContract.Data. Se una query utilizza un pattern non compatibile con queste opzioni, verrà rifiutata e verrà generata un'eccezione.
Media
Android 17 include le seguenti modifiche al comportamento dei contenuti multimediali.
Protezione dell'audio in background
Beginning with Android 17, the audio framework enforces restrictions on background audio interactions including audio playback, audio focus requests, and volume change APIs to ensure that these changes are started intentionally by the user.
Some audio restrictions apply to all apps. However, the restrictions are more stringent if an app targets Android 17 (API level 37). If one of these apps interacts with audio while it is in the background, it must have a foreground service running. In addition, the app must meet one or both of these requirements:
- The foreground service must have while-in-use (WIU) capabilities.
- The app must have the exact alarm permission and be interacting with
USAGE_ALARMaudio streams.
For more information, including mitigation strategies, see Background audio hardening.
Fattori di forma dei dispositivi
Android 17 include le seguenti modifiche per migliorare l'esperienza utente su una gamma di dimensioni e fattori di forma dei dispositivi.
Modifiche all'API della piattaforma per ignorare i vincoli di orientamento, ridimensionamento e proporzioni su schermi di grandi dimensioni (sw>=600 dp)
In Android 16 abbiamo introdotto modifiche all'API della piattaforma per ignorare le limitazioni relative a orientamento, proporzioni e ridimensionamento sugli schermi grandi (sw >= 600 dp) per le app che hanno come target il livello API 36 o versioni successive. Gli sviluppatori hanno la possibilità di disattivare queste modifiche con l'SDK 36, ma questa opzione non sarà più disponibile per le app che hanno come target Android 17 (livello API 37) o versioni successive.
Per ulteriori informazioni, consulta Le limitazioni relative a orientamento e ridimensionamento vengono ignorate.
Connettività
Android 17 introduce la seguente modifica per migliorare la coerenza e
allinearsi al comportamento standard di Java InputStream per i socket RFCOMM Bluetooth.
Comportamento di lettura() di BluetoothSocket coerente per RFCOMM
For apps targeting Android 17 (API level 37), the
read() method of the InputStream obtained from an
RFCOMM-based BluetoothSocket now returns -1 when the
socket is closed or the connection is dropped.
This change makes RFCOMM socket behavior consistent with LE CoC sockets and
aligns with the standard InputStream.read()
documentation, which states that -1 is returned when the end of the stream is
reached.
Apps that rely solely on catching an IOException to break out of a read loop may
be impacted by this change and should update the BluetoothSocket read loops to
explicitly check for a return value of -1. This ensures the loop terminates
correctly when the remote device disconnects or the socket is closed. For an
example of the recommended implementation, see the
code snippet in the Transfer Bluetooth data
guide.