Modifiche del comportamento: tutte le app

La piattaforma Android 12 include modifiche del comportamento che potrebbero influire sulla tua app. Le seguenti modifiche del comportamento si applicano a tutte le app quando vengono eseguite su Android 12, indipendentemente da targetSdkVersion. Devi testare l'app e poi modificarla in base alle esigenze per supportarle correttamente, ove applicabile.

Assicurati di esaminare anche l'elenco delle modifiche del comportamento che interessano solo le app che hanno come target Android 12.

Esperienza utente

Allunga effetto overscroll

Sui dispositivi con Android 12 e versioni successive, il comportamento visivo degli eventi overscroll cambia.

Su Android 11 e versioni precedenti, un evento overscroll fa sì che gli elementi visivi abbiano un bagliore; su Android 12 e versioni successive, gli elementi visivi si allungano e si rimbalzano durante un evento di trascinamento e scorrono e si rimbalzano su un evento fling.

Per ulteriori informazioni, consulta la guida all'animazione dei gesti di scorrimento.

Schermate iniziali delle app

Se in precedenza hai implementato una schermata iniziale personalizzata in Android 11 o versioni precedenti, devi eseguire la migrazione della tua app all'API SplashScreen per assicurarti che venga visualizzata correttamente a partire da Android 12. Se non esegui la migrazione dell'app, l'esperienza di avvio dell'app sarà ridotta o non intenzionale.

Per istruzioni, vedi Eseguire la migrazione dell'implementazione della schermata iniziale esistente ad Android 12.

Inoltre, a partire da Android 12, il sistema applica sempre la nuova schermata iniziale predefinita del sistema Android ad avvii a freddo e a caldo per tutte le app. Per impostazione predefinita, questa schermata iniziale predefinita di sistema viene creata utilizzando l'elemento icona in Avvio applicazioni dell'app e l'elemento windowBackground del tuo tema (se è di un solo colore).

Per maggiori dettagli, consulta la guida per gli sviluppatori sulle schermate iniziali.

Risoluzione dell'intent web

A partire da Android 12 (livello API 31), un intent web generico si risolve in un'attività nella tua app solo se quest'ultima è approvata per il dominio specifico contenuto nell'intent web. Se la tua app non viene approvata per il dominio, l'intent web viene invece risolto nell'app browser predefinita dell'utente.

Le app possono ottenere questa approvazione in uno dei seguenti modi:

• Verifica il dominio utilizzando Link per app Android.

  Nelle app destinate ad Android 12 o versioni successive, il sistema cambia la modalità di verifica automatica dei link per app Android dell'app. Nei filtri per intent della tua app, verifica di includere la categoria BROWSABLE e di supportare lo schema https.

  Su Android 12 o versioni successive, puoi verificare manualmente i link per app Android della tua app per testare l'impatto di questa logica aggiornata sulla tua app.

• Richiedi all'utente di associare la tua app al dominio nelle impostazioni di sistema.

Se la tua app richiama intent web, valuta la possibilità di aggiungere una richiesta o una finestra di dialogo per chiedere all'utente di confermare l'azione.

Miglioramenti alla modalità immersiva per la navigazione tramite gesti

Android 12 consolida il comportamento esistente per consentire agli utenti di eseguire più facilmente i comandi di navigazione tramite gesti in modalità immersiva. Inoltre, Android 12 offre un comportamento di compatibilità con le versioni precedenti per la modalità immersiva fissa.

Display#getRealSize e getRealMetrics: deprecazione e vincoli

I dispositivi Android sono disponibili in molti fattori di forma diversi, ad esempio schermi di grandi dimensioni, tablet e pieghevoli. Per visualizzare i contenuti in modo appropriato per ogni dispositivo, l'app deve determinare le dimensioni dello schermo o del display. Nel tempo, Android ha fornito API diverse per recuperare queste informazioni. In Android 11, abbiamo introdotto l'API WindowMetrics e abbiamo ritirato i seguenti metodi:

• Display.getSize()
• Display.getMetrics()

In Android 12 continuiamo a consigliare l'utilizzo di WindowMetrics e stiamo ritirando i seguenti metodi:

• Display.getRealSize()
• Display.getRealMetrics()

Per mitigare il comportamento delle applicazioni che utilizzano le API Display per recuperare i limiti dell'applicazione, Android 12 vincola i valori restituiti dalle API per le app che non sono completamente ridimensionabili. Questa operazione potrebbe avere un impatto sulle app che usano queste informazioni con MediaProjection.

Le app devono usare le API WindowMetrics per eseguire query sui limiti della finestra e Configuration.densityDpi per eseguire query sulla densità attuale.

Per una compatibilità più ampia con le versioni precedenti di Android, puoi utilizzare la libreria Jetpack WindowManager, che include una classe WindowMetrics che supporta Android 4.0 (livello API 14) e versioni successive.

Esempi di come utilizzare WindowMetrics

Innanzitutto, assicurati che le attività dell'app siano completamente ridimensionabili.

Un'attività deve basarsi su WindowMetrics da un contesto dell'attività per qualsiasi lavoro relativo all'interfaccia utente, in particolare WindowManager.getCurrentWindowMetrics() o WindowMetricsCalculator.computeCurrentWindowMetrics() di Jetpack.

Se l'app crea un elemento MediaProjection, i limiti devono essere dimensionati correttamente perché la proiezione acquisisce la partizione di visualizzazione su cui è in esecuzione l'app di proiettore.

Se l'app è completamente ridimensionabile, il contesto dell'attività restituisce i limiti corretti, in questo modo:

val projectionMetrics: WindowMetrics = activityContext
      .getSystemService(WindowManager::class.java).maximumWindowMetrics

WindowMetrics projectionMetrics = activityContext
      .getSystemService(WindowManager.class).getMaximumWindowMetrics();

Se l'app non è completamente ridimensionabile, deve eseguire una query da un'istanza WindowContext e recuperare il valore WindowMetrics dei limiti di attività utilizzando WindowManager.getMaximumWindowMetrics() o il metodo Jetpack WindowMetricsCalculator.computeMaximumWindowMetrics().

val windowContext = context.createWindowContext(mContext.display!!,
      WindowManager.LayoutParams.TYPE_APPLICATION, null)
val projectionMetrics = windowContext.getSystemService(WindowManager::class.java)
      .maximumWindowMetrics

Context windowContext = context.createWindowContext(mContext.getDisplay(),
      WindowManager.LayoutParams.TYPE_APPLICATION, null);
WindowMetrics projectionMetrics = windowContext.getSystemService(WindowManager.class)
      .getMaximumWindowMetrics();

Tutte le app in modalità multi-finestra

Android 12 utilizza il comportamento standard della modalità multi-finestra.

Su schermi di grandi dimensioni (sw >= 600 dp), la piattaforma supporta tutte le app in modalità multi-finestra, indipendentemente dalla configurazione dell'app. Se resizeableActivity="false", l'app viene attivata in modalità di compatibilità quando necessario per adattarsi alle dimensioni di visualizzazione.

Su schermi piccoli (sw < 600 dp), il sistema controlla minWidth e minHeight di un'attività per determinare se l'attività può essere eseguita in modalità multi-finestra. Se resizeableActivity="false", l'app non può essere eseguita in modalità multi-finestra a prescindere dalla larghezza e dall'altezza minime.

Per ulteriori informazioni, consulta la sezione Supporto multi-finestra.

Anteprima della fotocamera su schermi di grandi dimensioni

Le app fotocamera in genere presuppongono una relazione fissa tra l'orientamento del dispositivo e le proporzioni dell'anteprima della fotocamera. Tuttavia, i fattori di forma su schermi di grandi dimensioni, come i dispositivi pieghevoli, e le modalità di visualizzazione come multi-finestra e multi-display, mettono in discussione questa ipotesi.

Su Android 12, le app della fotocamera che richiedono un orientamento specifico dello schermo e non sono ridimensionabili (resizeableActivity="false") entrano automaticamente in modalità Ritratto, che garantisce l'orientamento e le proporzioni corretti dell'anteprima della fotocamera. Sui dispositivi pieghevoli e su altri dispositivi dotati di HAL (hardware), una rotazione aggiuntiva viene applicata all'output della videocamera per compensare l'orientamento del sensore della videocamera, mentre l'output della fotocamera viene ritagliato per corrispondere alle proporzioni dell'anteprima della fotocamera dell'app. Il ritaglio e la rotazione extra assicurano la corretta presentazione dell'anteprima della fotocamera indipendentemente dall'orientamento del dispositivo e dallo stato del dispositivo piegato o non piegato.

Ritardo UX per le notifiche dei servizi in primo piano

Per offrire un'esperienza semplificata per i servizi in primo piano a breve esecuzione, i dispositivi che eseguono Android 12 o versioni successive possono ritardare la visualizzazione delle notifiche dei servizi in primo piano di 10 secondi, con alcune eccezioni. Questa modifica consente di completare attività di breve durata prima che vengano visualizzate le relative notifiche.

Esibizione

Bucket standby dell'app limitato

Android 11 (livello API 30) ha introdotto il bucket con restrizioni come bucket di standby delle app. A partire da Android 12, questo bucket è attivo per impostazione predefinita. Il bucket limitato ha la priorità più bassa (e le restrizioni massime) di tutti i bucket. I bucket in ordine di priorità, dalla più alta alla più bassa, sono:

1. Attiva: l'app è attualmente in uso o è stata utilizzata molto di recente.
2. Set di lavoro: l'app è in uso regolare.
3. Frequente: l'app viene utilizzata spesso, ma non tutti i giorni.
4. Raro: l'app non viene utilizzata di frequente.
5. Con limitazioni: l'app utilizza una grande quantità di risorse di sistema o può presentare un comportamento indesiderato.

Il sistema prende in considerazione il comportamento della tua app, oltre ai pattern di utilizzo, per decidere se posizionare l'app nel bucket con limitazioni.

La tua app ha meno probabilità di essere inserita nel bucket con restrizioni se utilizza le risorse di sistema in modo più responsabile. Inoltre, il sistema inserisce la tua app in un bucket meno restrittivo se l'utente interagisce direttamente con l'app.

Controllare se l'app si trova nel bucket con limitazioni

Per verificare se il sistema ha inserito la tua app nel bucket con limitazioni, chiama getAppStandbyBucket(). Se il valore restituito di questo metodo è STANDBY_BUCKET_RESTRICTED, l'app si trova nel bucket con limitazioni.

Testa il comportamento del bucket limitato

Per verificare il comportamento dell'app quando il sistema la inserisce nel bucket con restrizioni, puoi spostarla manualmente in quel bucket. Per farlo, esegui questo comando in una finestra del terminale:

adb shell am set-standby-bucket PACKAGE_NAME restricted

Sicurezza e privacy

Posizione approssimativa

Sui dispositivi con Android 12 o versioni successive, gli utenti possono richiedere che la tua app abbia accesso solo alle informazioni sulla posizione approssimativa.

Se la tua app richiede l'autorizzazione di runtime ACCESS_FINE_LOCATION, devi richiedere anche l'autorizzazione ACCESS_COARSE_LOCATION per gestire il caso in cui l'utente conceda l'accesso alla posizione approssimativa per la tua app. Devi includere entrambe le autorizzazioni in un'unica richiesta di runtime.

La finestra di dialogo delle autorizzazioni di sistema include le seguenti opzioni per l'utente, come mostrato nella figura 1:

• Esatta: fornisce l'accesso a informazioni sulla posizione esatta.
• Approssimativa: fornisce l'accesso solo a informazioni sulla posizione approssimativa.

Attivazione/disattivazione di microfono e fotocamera

I dispositivi supportati con Android 12 o versioni successive consentono agli utenti di attivare e disattivare l'accesso alla fotocamera e al microfono per tutte le app sul dispositivo premendo un'unica opzione di attivazione/disattivazione. Gli utenti possono accedere alle opzioni attivabili dalle Impostazioni rapide, come mostrato nella Figura 1, o dalla schermata Privacy nelle impostazioni di sistema.

Scopri di più su questi attivatori e su come verificare che la tua app rispetti le best practice relative alle autorizzazioni CAMERA e RECORD_AUDIO.

Indicatori microfono e fotocamera

Sui dispositivi con Android 12 o versioni successive, quando un'app accede al microfono o alla fotocamera, nella barra di stato viene visualizzata un'icona.

Scopri di più su questi indicatori e su come verificare che la tua app rispetti le best practice relative alle autorizzazioni CAMERA e RECORD_AUDIO.

Visibilità del pacchetto di autorizzazioni

Sui dispositivi con Android 12 o versioni successive, le app destinate ad Android 11 (livello API 30) o versioni successive che chiamano uno dei seguenti metodi ricevono un insieme filtrato di risultati, in base alla visibilità dei pacchetti dell'app in altre app:

• getAllPermissionGroups()
• getPermissionGroupInfo()
• getPermissionInfo()
• queryPermissionsByGroup()

Implementazione di BouncyCastle rimossa

Android 12 rimuove molte implementazioni BouncyCastle di algoritmi di crittografia precedentemente deprecati, inclusi tutti gli algoritmi AES. Il sistema utilizza invece le implementazioni Conscrypt di questi algoritmi.

Questa modifica interessa la tua app se si verifica una delle seguenti condizioni:

• L'app utilizza dimensioni della chiave a 512 bit. Conscrypt non supporta questa dimensione della chiave. Se necessario, aggiorna la logica di crittografia dell'app in modo da utilizzare chiavi di dimensioni diverse.

• La tua app utilizza dimensioni della chiave non valide con KeyGenerator. L'implementazione di Conscrypt di KeyGenerator esegue una convalida aggiuntiva sui parametri chiave rispetto a BouncyCastle. Ad esempio, Conscrypt non consente alla tua app di generare una chiave AES a 64 bit perché AES supporta solo chiavi a 128, 192 e 256 bit.

  BouncyCastle consente di generare chiavi di dimensioni non valide, ma in seguito non riesce se queste chiavi vengono utilizzate con un elemento Cipher. Prima la crittografia non riesce.

• Inizializza le crittografie Galois/Counter Mode (GCM) utilizzando una dimensione diversa da 12 byte. L'implementazione di Conscrypt di GcmParameterSpec richiede un'inizializzazione di 12 byte, consigliata dal NIST.

Notifiche di accesso agli appunti

Su Android 12 e versioni successive, quando un'app chiama getPrimaryClip() per accedere ai dati dei clip da un'altra app per la prima volta, un messaggio toast avvisa l'utente di questo accesso agli appunti.

Il testo all'interno del messaggio toast contiene il seguente formato: APP pasted from your clipboard.

Informazioni sul testo nella descrizione del clip

Su Android 12 e versioni successive, getPrimaryClipDescription() può rilevare i seguenti dettagli:

• Testo stilizzato utilizzando isStyledText().
• Classificazioni diverse del testo, ad esempio URL, utilizzando getConfidenceScore().

Le app non possono chiudere le finestre di dialogo di sistema

Per migliorare il controllo utente durante l'interazione con le app e il sistema, l'azione di intent ACTION_CLOSE_SYSTEM_DIALOGS è deprecata a partire da Android 12. Ad eccezione di alcuni casi speciali, quando la tua app tenta di richiamare un intent contenente questa azione, il sistema effettua una delle seguenti operazioni in base alla versione dell'SDK target dell'app:

• Se la tua app ha come target Android 12 o versioni successive, si verifica un SecurityException.

• Se la tua app ha come target Android 11 (livello API 30) o versioni precedenti, l'intent non viene eseguito e in Logcat viene visualizzato il seguente messaggio:

  E ActivityTaskManager Permission Denial: \
  android.intent.action.CLOSE_SYSTEM_DIALOGS broadcast from \
  com.package.name requires android.permission.BROADCAST_CLOSE_SYSTEM_DIALOGS, \
  dropping broadcast.
  

Eccezioni

Nei seguenti casi, un'app può comunque chiudere le finestre di dialogo di sistema su Android 12 o versioni successive:

• La tua app sta eseguendo un test di strumentazione.

• L'app ha come target Android 11 o versioni precedenti e mostra una finestra nella parte superiore del riquadro a scomparsa delle notifiche.

• La tua app ha come target Android 11 o versioni precedenti. Inoltre, l'utente ha interagito con una notifica, utilizzando eventualmente i pulsanti di azione della notifica, e la tua app elabora un servizio o un ricevitore di trasmissione in risposta all'azione dell'utente.

• La tua app è destinata ad Android 11 o versioni precedenti e ha un servizio di accessibilità attivo. Se la tua app ha come target Android 12 e vuoi chiudere la barra delle notifiche, utilizza invece l'azione di accessibilità GLOBAL_ACTION_DISMISS_NOTIFICATION_SHADE.

Gli eventi tocco non attendibili sono bloccati

Per preservare la sicurezza del sistema e una buona esperienza utente, Android 12 impedisce alle app di utilizzare eventi touch in cui un overlay oscura l'app in modo non sicuro. In altre parole, il sistema blocca i tocchi che passano attraverso determinate finestre, con alcune eccezioni.

App interessate

Questa modifica interessa le app che scelgono di consentire i tocchi attraverso le finestre, ad esempio utilizzando il flag FLAG_NOT_TOUCHABLE. Alcuni esempi, senza alcuna limitazione, sono:

• Gli overlay che richiedono l'autorizzazione SYSTEM_ALERT_WINDOW, ad esempio le finestre che utilizzano TYPE_APPLICATION_OVERLAY e il flag FLAG_NOT_TOUCHABLE.
• Finestre di attività che usano il flag FLAG_NOT_TOUCHABLE.

Eccezioni

Nei seguenti casi sono consentiti i tocchi "pass-through":

• Interazioni all'interno dell'app. L'app mostra l'overlay e quest'ultimo viene visualizzato soltanto quando l'utente interagisce con l'app.

• Finestre attendibili. Queste finestre includono, a titolo esemplificativo:

  • Finestre di accessibilità
  • Finestre IME (Input Method Editor)
  • Finestre dell'assistente

• Finestre invisibili. La vista principale della finestra è GONE o INVISIBLE.

• Finestre completamente trasparenti. La proprietà alpha è 0,0 per la finestra.

• Finestre di avviso di sistema sufficientemente traslucide. Il sistema considera sufficientemente traslucidi un insieme di finestre di avviso di sistema quando l'opacità combinata è inferiore o uguale all'opacità massima di occultamento del sistema per i tocchi. In Android 12, l'opacità massima è pari a 0,8 per impostazione predefinita.

Rileva quando un tocco non attendibile viene bloccato

Se un'azione tocco viene bloccata dal sistema, Logcat registra il seguente messaggio:

Untrusted touch due to occlusion by PACKAGE_NAME

Testa la modifica

I tocchi non attendibili sono bloccati per impostazione predefinita sui dispositivi con Android 12 o versioni successive. Per consentire i tocchi non attendibili, esegui questo comando ADB in una finestra del terminale:

# A specific app
adb shell am compat disable BLOCK_UNTRUSTED_TOUCHES com.example.app

# All apps
# If you'd still like to see a Logcat message warning when a touch would be
# blocked, use 1 instead of 0.
adb shell settings put global block_untrusted_touches 0

Per ripristinare il comportamento predefinito (i tocchi non attendibili sono bloccati), esegui questo comando:

# A specific app
adb shell am compat reset BLOCK_UNTRUSTED_TOUCHES com.example.app

# All apps
adb shell settings put global block_untrusted_touches 2

Ciclo di vita dell'attività

Le attività di Avvio applicazioni non vengono più terminate con la pressione indietro

Android 12 modifica la gestione predefinita del sistema Indietro nelle attività di Avvio app che sono alla base delle loro attività. Nelle versioni precedenti, il sistema terminava queste attività alla pressione sul retro. In Android 12, il sistema ora sposta l'attività e la relativa attività in background anziché completarla. Il nuovo comportamento corrisponde a quello attuale quando esci da un'app utilizzando il pulsante Home o il gesto.

Per la maggior parte delle app, questa modifica significa che gli utenti che utilizzano Indietro per uscire dall'app possono riprendere più rapidamente l'app da uno stato caldo, anziché dover riavviare completamente l'app da uno stato a freddo.

Ti consigliamo di testare le tue app con questa modifica. Se al momento la tua app esegue l'override di onBackPressed() per gestire la navigazione a ritroso e completare Activity, aggiorna l'implementazione per eseguire la chiamata a super.onBackPressed() anziché terminare. La chiamata di super.onBackPressed() sposta l'attività e la sua attività in background quando opportuno e offre un'esperienza di navigazione più coerente agli utenti tra le app.

Tieni inoltre presente che, in generale, consigliamo di utilizzare le API AndroidX Activity per fornire una navigazione a ritroso personalizzata, anziché eseguire l'override di onBackPressed(). Le API AndroidX Activity si rifanno automaticamente al comportamento del sistema appropriato se non ci sono componenti che intercettano il sistema Backpress.

Elementi grafici e immagini

Miglioramento del cambio della frequenza di aggiornamento

In Android 12, le modifiche alla frequenza di aggiornamento tramite setFrameRate() possono avvenire indipendentemente dal fatto che il display supporti una transizione senza interruzioni alla nuova frequenza di aggiornamento; una transizione senza interruzioni è quella che non presenta interruzioni visive, ad esempio uno schermo nero per un secondo o due. In precedenza, se il display non supportava una transizione perfetta, in genere continuava a utilizzare la stessa frequenza di aggiornamento dopo la chiamata di setFrameRate(). Per determinare in anticipo se la transizione al nuovo aggiornamento sarà probabilmente semplice, chiama getAlternativeRefreshRates(). In genere, il callback onDisplayChanged() viene chiamato una volta completato il cambio di frequenza di aggiornamento, ma per alcuni display collegati esternamente viene chiamato durante una transizione fluida.

Ecco un esempio di come implementare questa funzionalità:

// Determine whether the transition will be seamless.
// Non-seamless transitions may cause a 1-2 second black screen.
val refreshRates = this.display?.mode?.alternativeRefreshRates
val willBeSeamless = Arrays.asList<FloatArray>(refreshRates).contains(newRefreshRate)

// Set the frame rate even if the transition will not be seamless.
surface.setFrameRate(newRefreshRate, FRAME_RATE_COMPATIBILITY_FIXED_SOURCE, CHANGE_FRAME_RATE_ALWAYS)

// Determine whether the transition will be seamless.
// Non-seamless transitions may cause a 1-2 second black screen.
Display display = context.getDisplay(); // API 30+
Display.Mode mode = display.getMode();
float[] refreshRates = mode.getAlternativeRefreshRates();
boolean willBeSeamless = Arrays.asList(refreshRates).contains(newRefreshRate);

// Set the frame rate even if the transition will not be seamless.
surface.setFrameRate(newRefreshRate, FRAME_RATE_COMPATIBILITY_FIXED_SOURCE, CHANGE_FRAME_RATE_ALWAYS);

Connettività

Aggiornamenti passpoint

In Android 12 vengono aggiunte le seguenti API:

• isPasspointTermsAndConditionsSupported(): Termini e condizioni sono una funzionalità di passpoint che consente ai deployment di rete di sostituire i captive portal non sicuri, che utilizzano reti aperte, con una rete Passpoint sicura. Viene visualizzata una notifica all'utente quando è necessario accettare Termini e condizioni. Le app che suggeriscono reti Passpoint controllate da termini e condizioni devono prima chiamare questa API per assicurarsi che il dispositivo supporti la funzionalità. Se il dispositivo non supporta la funzionalità, non potrà connettersi a questa rete ed è necessario suggerire una rete alternativa o legacy.

• isDecoratedIdentitySupported(): quando esegui l'autenticazione nelle reti con decorazione del prefisso, il prefisso di identità decorato consente agli operatori di rete di aggiornare il Network Access Identifier (NAI) in modo che esegua il routing esplicito tramite più proxy all'interno di una rete AAA (per saperne di più, consulta RFC 7542).

  Android 12 implementa questa funzionalità in conformità alla specifica WBA per le estensioni PPS-MO. Le app che suggeriscono reti Passpoint che richiedono un'identità modificata devono prima chiamare questa API per assicurarsi che il dispositivo supporti la funzionalità. Se il dispositivo non supporta la funzionalità, l'identità non verrà modificata e l'autenticazione sulla rete potrebbe non riuscire.

Per creare un suggerimento di Passpoint, le app devono utilizzare le classi PasspointConfiguration, Credential e HomeSp. Queste classi descrivono il profilo Passpoint, definito nella specifica Wi-Fi Alliance Passpoint.

Per ulteriori informazioni, vedi API di suggerimento Wi-Fi per la connettività a internet.

Limitazioni aggiornate relative all'interfaccia non SDK

Android 12 include elenchi aggiornati di interfacce non SDK limitate in base alla collaborazione con sviluppatori Android e agli ultimi test interni. Se possibile, ci assicuriamo che siano disponibili alternative pubbliche prima di limitare le interfacce non SDK.

Se la tua app non ha come target Android 12, alcune di queste modifiche potrebbero non riguardarti immediatamente. Tuttavia, anche se al momento puoi utilizzare alcune interfacce non SDK (a seconda del livello API target della tua app), l'utilizzo di qualsiasi metodo o campo non SDK comporta sempre un rischio elevato di danneggiare la tua app.

Se non hai la certezza che la tua app utilizzi interfacce non SDK, puoi testarla per scoprirlo. Se la tua app si basa su interfacce non SDK, dovresti iniziare a pianificare una migrazione a alternative SDK. Tuttavia, sappiamo che alcune app hanno casi d'uso validi per l'utilizzo di interfacce non SDK. Se non riesci a trovare un'alternativa all'utilizzo di un'interfaccia non SDK per una funzionalità nella tua app, devi richiedere una nuova API pubblica.

Per scoprire di più sulle modifiche in questa release di Android, consulta gli aggiornamenti alle limitazioni relative all'interfaccia non SDK in Android 12. Per scoprire di più sulle interfacce non SDK in generale, consulta Restrizioni relative alle interfacce non SDK.