Questa pagina è stata tradotta dall'API Cloud Translation.

Modalità di compatibilità del dispositivo

Android attiva una modalità di compatibilità per le app che dichiarano l'orientamento o limitazioni di ridimensionabilità. La modalità di compatibilità garantisce un comportamento accettabile dell'app su dispositivi con schermi di grandi dimensioni e telefoni pieghevoli a conchiglia, ma con un'usabilità non ottimale.

Gli override per app consentono ai produttori di dispositivi di modificare comportamento delle app per migliorare l'esperienza utente o impedire che le app si interrompano dispositivi specifici.

Dispositivi di riferimento

I seguenti dispositivi potrebbero richiedere override per app a causa di insoliti configurazioni non ben supportate dalle app:

Tablet: l'orientamento naturale di alcuni tablet, come Pixel Tablet, orizzontale. Un dispositivo è nel suo orientamento naturale quando Resi: Display#getRotation() Surface.ROTATION_0. Se le app presuppongono che ROTATION_0 sia in verticale, i layout dell'app e l'anteprima della fotocamera potrebbero non corrispondere al display del dispositivo.
Pieghevoli in orizzontale:alcuni dispositivi pieghevoli, come Pixel Fold, sono in orientamento verticale quando è piegato e orientamento orizzontale quando è aperto. Se le app presuppongono che l'orientamento non piegato sia verticale, sfarfallio problemi di loop o di layout.
Telefoni a conchiglia pieghevoli:i telefoni a conchiglia aperti sono in genere in verticale orientamento. Una volta piegati, però, gli smartphone di solito hanno un piccolo display orientamento orizzontale. Le app devono identificare e soddisfare le diverse orientamenti dei display.

Problemi comuni di compatibilità

Le app presentano problemi di compatibilità più spesso a causa dell'orientamento dell'app restrizioni, ridimensionabilità e proporzioni, gestione errata delle orientamento dell'anteprima della fotocamera e uso improprio delle API.

Letterboxing

Il Letterbox posiziona l'app al centro dello schermo oppure, su schermi di grandi dimensioni, da un lato all'altro per facilitare l'accesso. Opaca (barre a tinta unita o sfocato) riempiono l'area di visualizzazione inutilizzata lungo i lati o in alto e nella parte inferiore dell'app.

Il Letterbox è spesso utilizzato sui dispositivi con schermi di grandi dimensioni perché le dimensioni e le proporzioni del display del dispositivo sono solitamente diverse da quelle delle smartphone compatibili con la maggior parte delle app.

Figura 1. L'app limitata all'orientamento verticale è in formato letterbox sui tablet con orientamento orizzontale e pieghevoli.

Problema

L'app non supporta tutte le configurazioni di visualizzazione perché sono state corrette orientamento, proporzioni fisse o non ridimensionabile.

Le impostazioni di configurazione che controllano l'orientamento e la ridimensionabilità dell'app includono: seguenti:

screenOrientation: specifica un orientamento fisso per un'app. Le app possono anche impostare l'orientamento in fase di runtime utilizzando Activity#setRequestedOrientation().
resizeableActivity: indica se il sistema può ridimensionare le app per adattarle a finestre di dimensioni diverse. Su Android 11 (livello API 30) e inferiore, specifica se le app supportano la modalità multi-finestra. Attivato Android 12 (livello API 31) e versioni successive specifica se le app supportano modalità multi-finestra su schermi piccoli (sw < 600 dp). Su Android 12 e superiore, le app supportano la modalità multi-finestra su schermi di grandi dimensioni (sw >= 600 dp) indipendentemente da questa impostazione.
maxAspectRatio: specifica le proporzioni massime supportate dall'app. Solo le app con resizeableActivity impostato su false possono imposta maxAspectRatio.
minAspectRatio: specifica le proporzioni minime supportate dall'app. Solo le app con resizeableActivity impostato su false possono imposta minAspectRatio.

App limitata all'orientamento verticale non utilizzabile sul dispositivo orizzontale.

Ottimizzazione

L'app deve supportare tutti gli orientamenti di visualizzazione dei dispositivi e della modalità multi-finestra e dimensioni. Rimuovi dalla tua app tutte le limitazioni relative all'orientamento e alle proporzioni fisse i layout e il file manifest dell'app.

L'app supporta tutti gli orientamenti del dispositivo.

Soluzione alternativa per la compatibilità

Se un'app con orientamento o proporzioni fisse viene eseguita in una finestra in cui l'app non supporta direttamente la dimensione o l'orientamento della finestra, Android l'app in formato letterbox per preservare la continuità.

a partire da Android 12 (livello API 31) e poi con 12L (livello API 32), la piattaforma applica una serie di miglioramenti alle app letterbox. Dispositivo i produttori implementano i miglioramenti dell'interfaccia utente. Non è necessario alcun intervento da parte tua sviluppo della tua app per trarre vantaggio dai miglioramenti.

Android 12 (livello API 31) introduce i seguenti miglioramenti estetici, che che possono essere configurati dai produttori di dispositivi:

Angoli arrotondati:gli angoli della finestra dell'app hanno un aspetto più raffinato.
Trasparenza della barra di sistema: le barre di stato e di navigazione, che si sovrappongono alla sono semitrasparenti, pertanto le icone delle barre sono sempre visibili sfondo letterbox.
Proporzioni configurabili: le proporzioni dell'app possono essere modificate. per migliorare l'aspetto dell'app.

Figura 2. App in formato Letterbox con miglioramenti dell'interfaccia utente.

12L (livello API 32) aggiunge i seguenti miglioramenti funzionali:

Posizionamento configurabile: su schermi di grandi dimensioni, i produttori di dispositivi possono posiziona l'app sul lato destro o sinistro del display, un'interazione più semplice.
Tasto di riavvio rinnovato:i produttori dei dispositivi possono attivare il riavvio. pulsante per la modalità di compatibilità dimensioni con un nuovo look per migliorare il riconoscimento da parte degli utenti.

Android 13 (livello API 33) aggiunge una finestra di dialogo informativa per gli utenti sul posizionamento app letterbox sullo schermo o contenente letterbox in modalità schermo diviso:

Figura 3. App in formato Letterbox con finestra di dialogo informativa per gli utenti.

Modalità di compatibilità delle dimensioni

La modalità di compatibilità delle dimensioni è letterbox che include un controllo di riavvio. La consente agli utenti di riavviare l'app e visualizzare di nuovo il display. Richiami Android modalità di compatibilità delle dimensioni per le app non ridimensionabili. Quando l'attività passa a un contenitore display incompatibile con dimensioni, il sistema può ridimensionare l'app per riempire il display del dispositivo almeno una dimensione.

Le modifiche alla configurazione del dispositivo che possono attivare la modalità di compatibilità delle dimensioni includono: le seguenti:

Rotazione del dispositivo
Dispositivo pieghevole che si piega o si apre
Passare dalla modalità di visualizzazione a schermo intero a quella a schermo diviso e viceversa

Problema

La modalità di compatibilità delle dimensioni si applica in genere alle attività che sono limitate in orientamento o proporzioni e sono configurati (o determinati dal sistema) per non sarà ridimensionabile.

La tua app è considerata ridimensionabile e non verrà posizionata modalità di compatibilità, se soddisfa uno dei seguenti criteri:

È ridimensionabile con resizeableActivity="true"
Supporta la modalità Picture in picture (PIP)
È incorporato
Ha l'override per app FORCE_RESIZE_APP applicato da Il produttore del dispositivo (le proprietà impostate dall'app vengono ignorate)

Se la tua app non soddisfa nessuna delle condizioni, viene considerata non ridimensionabili e potrebbero essere posizionate in modalità di compatibilità delle dimensioni.

L'app non ridimensionabile si arresta in modo anomalo in modalità multi-finestra.

Ottimizzazione

L'app deve supportare tutte le dimensioni di visualizzazione. Rendi la tua app ridimensionabile impostando Attributo android:resizeableActivity di <activity> o <application> a true nel manifest dell'app. Progetta layout reattivi/adattivi per la tua app. Per ulteriori informazioni le informazioni, vedi Supporta schermi di dimensioni diverse e Supporto multi-finestra.

L'app funziona con finestre di tutte le dimensioni.

Soluzione alternativa per la compatibilità

Android mette un'app in modalità di compatibilità delle dimensioni quando il sistema determina la visualizzazione dell'app in formato letterbox può essere migliorata ridimensionando l'app in modo che finestra in almeno una dimensione. Il sistema visualizza un controllo di riavvio che ricrea il processo dell'app, ricreando l'attività e ridisegnando display. Vedi anche Panoramica su processi e thread.

Letterbox dell'app solo verticale con orientamento orizzontale, ridimensionata dal controllo di riavvio.

Anelli sfarfallanti

Quando un'app non supporta tutti gli orientamenti del display, potrebbe verificarsi richiedere nuovi orientamenti quando si verifica una modifica della configurazione, creando ciclo infinito che fa sfarfallare il display o l'app ruota all'infinito.

Problema

Su Android 12 (livello API 31) e versioni successive, i produttori di dispositivi possono configurare sui dispositivi di ignorare le limitazioni di orientamento specificate dalle app applicare le modalità di compatibilità. Ad esempio, un dispositivo pieghevole potrebbe ignorare un android:screenOrientation="portrait" dell'attività quando l'attività viene visualizzata nelle dimensioni orizzontali del tablet del dispositivo, schermo interno.

Se le limitazioni di orientamento di un'app vengono ignorate, l'app può eseguire in modo programmatico impostane l'orientamento richiamando Activity#setRequestedOrientation(). La chiamata attiva il riavvio dell'app se non gestisce le modifiche alla configurazione (vedi Gestire le modifiche alla configurazione). Dopo il riavviare, i limiti di orientamento dell'app vengono nuovamente ignorati, l'app si ripete la chiamata a setRequestedOrientation(), la chiamata attiva il riavvio dell'app e e così via in un loop che si autoperpetra.

Un altro modo per farlo è quando orientamento naturale (il normale orientamento determinato da Android) dello schermo di un dispositivo è orizzontale (ovvero la chiamata Resi in Display#getRotation() Surface.ROTATION_0 quando il dispositivo è in orizzontale ). In passato, le app presupponevano che Display.getRotation() = Surface.ROTATION_0 indichi che il dispositivo sia in orientamento verticale, ma non è così come accade sempre, ad esempio sullo schermo interno di alcuni dispositivi pieghevoli su alcuni tablet.

Un'app con orientamento orizzontale su un display interno pieghevole potrebbe controllare le rotazione dello schermo, ricevi un valore di ROTATION_0, assume l'orientamento naturale del dispositivo è in verticale e chiama setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT ) per riconfigurare il layout dell'app. Dopo il riavvio dell'app (in orizzontale orientamento), potrebbe controllare di nuovo la rotazione dello schermo, ricevere il valore ROTATION_0, chiama setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) e per continuare il loop infinito.

L'app solo in orizzontale su display verticale effettua chiamate ripetute a `Activity#setRequestedOrientation()`.

Ottimizzazione

Le app non devono:

Imposta un orientamento predefinito con Activity#setRequestedOrientation() nella l'attività onCreate() perché la richiesta di orientamento può essere attivato in modo imprevisto da modifiche alla configurazione non gestite
Supponiamo che l'orientamento naturale del dispositivo (ROTATION_0) sia verticale
Imposta l'orientamento in base a indicatori non correlati alle dimensioni correnti della finestra, ad esempio come Display#getRotation(), la presenza di un FoldingFeature o API ritirate.

L'app gestisce la modifica della configurazione, non ha limitazioni di orientamento e non inserisce quindi in loop lo sfarfallio.

Soluzione alternativa per la compatibilità

Android ignora le chiamate a Activity#setRequestedOrientation() nei seguenti situazioni seguenti:

L'attività è già stata riavviata da una precedente chiamata al metodo o è stato abilitato il trattamento forzato di rotazione della fotocamera (vedi Fotocamera anteprima di seguito).

I produttori di dispositivi possono applicare questo comportamento a un'app con OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION.
L'attività ha effettuato più di due richieste di orientamento in un secondo, che indica che si è verificato un loop. Delle due richieste nel loop, Android utilizza quella che ingrandisce l'area di visualizzazione dell'app.

I produttori di dispositivi possono applicare questo comportamento a un'app con OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED.

Anteprima fotocamera

L'anteprima della fotocamera (o il mirino) delle app della fotocamera potrebbe essere disallineata o distorta su tablet, laptop e display pieghevoli.

Problema

Il Documento di definizione della compatibilità Android afferma che: il sensore fotografico della fotocamera "DEVE essere orientato in modo che la dimensione lunga del si allinea alla dimensione lunga dello schermo."

Le app spesso presuppongono che l'orientamento del dispositivo e l'orientamento del sensore della fotocamera siano verticale, un presupposto ragionevole per i telefoni cellulari standard. Ma l'orientamento naturale di tablet e laptop e i sensori della fotocamera possono essere in un paesaggio. Inoltre, nuovi fattori di forma come i pieghevoli possono avere molteplici orientamenti e diversi sensori della fotocamera con orientamenti diversi.

Avvio di un'attività con un orientamento della fotocamera non previsto dall'app o il passaggio da una fotocamera all'altra o da uno schermo del dispositivo all'altro (per i pieghevoli) può causare un'anteprima della fotocamera disallineata o distorta.

Anteprima della fotocamera disallineata e distorta su schermo pieghevole di grandi dimensioni.

Ottimizzazione

Le app Fotocamera devono identificare e gestire correttamente l'orientamento e la fotocamera del dispositivo orientato il sensore per presentare un'anteprima della fotocamera allineata e scalata correttamente. Le app devono calcolare la rotazione del dispositivo, la rotazione del sensore e lo schermo o la finestra proporzioni e applicare i risultati all'anteprima della fotocamera. Per dettagli indicazioni, vedi Anteprima della fotocamera e Presentazione della fotocamera Mirino.

Anteprima della fotocamera allineata e ridimensionata correttamente in tutti gli orientamenti del dispositivo.

Soluzione alternativa per la compatibilità

Un dispositivo è in orientamento naturale quando Display#getRotation() restituisce Surface.ROTATION_0. Il sistema calcola CameraCharacteristics.SENSOR_ORIENTATION dall'orientamento naturale del dispositivo. Android allinea la finestra verticale di app limitate per i contenuti verticali con l'orientamento naturale del dispositivo, che è ciò che si aspetta la maggior parte delle app. Android ritaglia l'immagine del sensore della fotocamera anche quando l'orientamento del sensore è orizzontale e l'anteprima della fotocamera è verticale. Lo specifico Ecco alcune soluzioni alternative:

Forza la rotazione delle anteprime della fotocamera per le app con limitazioni per la visualizzazione in verticale: app limitati all'orientamento verticale prevedono l'orientamento naturale del dispositivo e l'orientamento del sensore della fotocamera in modo che sia verticale. Tuttavia, su Android 12 (livello API 31) e versioni successive, le app possono essere eseguite con diversi orientamenti del dispositivo se I produttori di dispositivi ignorano le specifiche di orientamento.

Quando alla fotocamera viene collegata un'app con limitazioni per l'orientamento verticale, Android forza la ruota l'app per allineare la finestra verticale dell'app con la natura l'orientamento del dispositivo.

Su alcuni tablet (vedi i dispositivi di riferimento), l'app la finestra verticale viene ruotata a schermo intero per allinearla all'orientamento naturale del dispositivo. L'app occupa lo schermo intero dopo l'applicazione forzata la rotazione.

Tablet: forza la rotazione dell'app con limitazioni per l'orientamento verticale.

Sullo schermo interno orizzontale dei pieghevoli (vedi riferimento dispositivi mobili), le attività in modalità solo verticale vengono ruotate orizzontale per allinearsi all'orientamento naturale aperto. L'app è letterbox dopo la rotazione forzata.

Pieghevole: forza la rotazione dell'app con limitazioni per l'orientamento verticale. Anche l'app è in formato letterbox.

Nota: l'opzione Forza la rotazione non si verifica se la tua app è adattabile e gestisce orientamenti verticale e orizzontale.
Ritaglio della fotocamera anteriore interna: il sensore della fotocamera anteriore interna su alcuni i pieghevoli sono in orientamento orizzontale. Oltre a forzare la rotazione anteprima della fotocamera sul display interno pieghevole, Android ritaglia la parte anteriore interna Campo visivo della videocamera (orizzontale) in modo che il sensore catturi l'immagine opposta l'orientamento del dispositivo.
Forza l'aggiornamento delle anteprime della fotocamera: il sistema scorre le attività in sequenza. i metodi onStop() e onStart() (per impostazione predefinita) o onPause() e onResume() (applicato dal OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE l'override per app) dopo forza la rotazione per assicurarti che l'anteprima della fotocamera sia correttamente.
Ridimensionamento delle proporzioni: il sistema modifica in modo dinamico le proporzioni delle forza la rotazione dell'anteprima della fotocamera a proporzioni minime più elevate, assicura che l'anteprima della fotocamera sia ridimensionata correttamente.

Gli sviluppatori di app possono ignorare queste soluzioni alternative se le app gestiscono l'anteprima della fotocamera in modo corretto. Consulta Override per app.

API utilizzate spesso in modo improprio

Poiché Android ha aggiunto il supporto di funzionalità quali la modalità multi-finestra e come i pieghevoli, le API legacy sono state ritirate e sostituite API aggiornate che funzionano per tutte le dimensioni di visualizzazione e per tutti i tipi di dispositivi fattori. Tuttavia, le API ritirate sono ancora disponibili per le versioni precedenti la compatibilità.

Alcune API View sono progettate per scopi speciali che non sempre funzionano correttamente riconosciuti dagli sviluppatori.

Problema

Gli sviluppatori continuano a utilizzare le API Display deprecate e presuppongono erroneamente che Le API restituiscono i limiti delle app anziché i limiti dell'area di visualizzazione del dispositivo. O sviluppatori utilizzare erroneamente API di visualizzazione per scopi speciali per ottenere metriche generali della pubblicità display. Il risultato sono calcoli errati durante il riposizionamento degli elementi UI dopo la finestra dell'app di ridimensionamento degli eventi causando problemi di layout.

API display deprecate e utilizzate comunemente:

Per ulteriori informazioni, vedi Supporto multi-finestra.

API per le visualizzazioni utilizzate in modo improprio:

L'API deprecata calcola erroneamente i limiti delle app. I contenuti dell'app vengono rimossi dallo schermo.

Ottimizzazione

Non fare mai affidamento sulle dimensioni di visualizzazione fisica per il posizionamento degli elementi UI. Esegui la migrazione del tuo dell'app alle API in base a WindowMetrics, inclusi i seguenti WindowManager API:

Piattaforma:
- getCurrentWindowMetrics()
- getMaximumWindowMetrics()
Jetpack:
- WindowMetricsCalculator#computeCurrentWindowMetrics()
- WindowMetricsCalculator#computeMaximumWindowMetrics()

L'API calcola correttamente le metriche relative alla finestra dell'app.

Soluzione alternativa per la compatibilità

Due override modificano le API Display deprecate e hanno usato in modo improprio le API View per restituisce i limiti dell'app: ALWAYS_SANDBOX_DISPLAY_APIS per Display le API OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS per View API. Per impostazione predefinita, ALWAYS_SANDBOX_DISPLAY_APIS viene applicato anche a le app idonee per la modalità di compatibilità delle dimensioni.

Attività trasparenti

Le attività trasparenti sono il risultato di stili di sfondo trasparenti, ad esempio:

<style name="Transparent" parent="AppTheme">
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowBackground">@android:color/transparent</item>
</style>

I temi relativi alle finestre di dialogo, come Theme.MaterialComponents.Dialog, possono includi stili che rendono le attività trasparenti.

Le attività trasparenti non coprono tutto lo spazio di visualizzazione disponibile, il che rende difficili da gestire perché l'area di visualizzazione disponibile può cambiare in base modifiche alla configurazione, ad esempio rotazione e apertura e chiusura dei dispositivi modalità multi-finestra.

Problema

Un'attività trasparente deve essere conforme ai limiti della prima attività opaca sotto le attività trasparenti nello stack di attività delle attività. Tuttavia, un modello opaco che avvia una finestra di dialogo di autorizzazione può essere trampoline (un'attività che avvia un'altra attività e poi scompare); e quindi il sistema non è in grado di determinare i limiti dell'attività del trampolino ha avviato l'attività della finestra di dialogo delle autorizzazioni trasparente.

La finestra di dialogo è posizionata in modo errato perché l'attività è stata avviata da un trampolino.

Ottimizzazione

Le attività trasparenti ereditano i vincoli dall'opaco più in alto attività sottostanti nello stack di attività di un'attività. L'attività opaca deve essere disponibili per l'intero ciclo di vita dell'attività trasparente, dall'attività dalla creazione alla distruzione. Per questo motivo, non avviare richieste di autorizzazione da attività con trampolino.

Se un'attività con trampolino lancia una richiesta di autorizzazione, l'utente potrebbe non essere vedere la finestra di dialogo delle autorizzazioni perché l'attività del trampolino è stata viene eliminata prima che l'utente abbia avuto la possibilità di rispondere alla finestra di dialogo e le dimensioni e la posizione dell'attività della finestra di dialogo potrebbero essere state calcolate in modo errato.

Le app devono sempre avviare richieste di autorizzazione da attività che rimangono visibile finché l'utente non ha preso una decisione in merito all'autorizzazione.

Angoli arrotondati

Un'attività può essere trasparente a causa di uno stile che specifica lo sfondo trasparenza o poiché i contenuti dell'attività non riempiono di visualizzazione dei contenuti. Se lo spazio di visualizzazione disponibile è riempito da un'attività trasparente, automaticamente gli angoli arrotondati all'attività quando configurato dal produttore del dispositivo. Ma se un'attività trasparente (come una finestra di dialogo di autorizzazione) non riempie lo spazio disponibile, spetta a te decidere l'eventuale applicazione di angoli arrotondati.

Le finestre di dialogo di autorizzazione non occupano lo spazio di visualizzazione disponibile perché in genere utilizza LayoutParams.WRAP_CONTENT anziché LayoutParams.MATCH_PARENT.

Finestra di dialogo con angoli arrotondati correttamente posizionati sopra l'attività di avvio visibile.

Soluzione alternativa per la compatibilità

Mantieni visibili le attività che avviano le attività delle finestre di dialogo finché l'utente non lo ha ha risposto alla finestra di dialogo.

Il sistema garantisce che un'attività trasparente erediti tutti i vincoli la prima attività opaca sotto l'attività trasparente nello stack attività; inclusi i vincoli relativi a:

Modalità di compatibilità delle dimensioni
Orientamento
Proporzioni

Giochi Unity

I giochi Unity vengono eseguiti su Android a schermo intero o in modalità multi-finestra. Tuttavia, molti giochi Unity perdono lo stato attivo e smettono di disegnare contenuti quando l'app viene inserita modalità multi-finestra.

Problema

Unity ha aggiunto una Resizable Window in Unity 2019.4 per supportare la modalità multi-finestra su Android. Tuttavia, l'implementazione iniziale non ha reagito al ciclo di vita dell'attività in la modalità multi-finestra, generando UnityPlayer per sospendere la riproduzione quando l'app perde lo stato attivo. Il player ha visualizzato schermata nera o l'ultimo frame bloccato del gioco. Il gameplay è stato ripreso solo quando l'utente ha toccato lo schermo. Questo problema si verifica in molte app che utilizzano il motore Unity. vengono visualizzati come una finestra nera in modalità multi-finestra.

Il gioco non è più attivo in modalità multi-finestra e viene visualizzato come una finestra nera.

Ottimizzazione

Esegui l'upgrade di Unity alla versione 2019.4.40 o successiva ed esporta nuovamente il tuo gioco. Mantieni il valore Opzione Resizable Window selezionata in Impostazioni di Android Player, altrimenti il gioco si interrompe quando non è a fuoco, anche se il gioco è completamente visibile modalità multi-finestra.

Il gioco esegue il rendering dei contenuti correttamente in modalità multi-finestra anche quando non è a fuoco.

Soluzione alternativa per la compatibilità

I produttori di dispositivi possono applicare OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS di override per app per fornire un falso evento attivo a un'app in modalità multi-finestra. L'override consente all'attività di ridisegnare i contenuti non sia oscurato.

Testare l'app per verificare la presenza di problemi di compatibilità

Per testare la tua app e capire come si comporta nei diversi fattori di forma, sfrutta le seguenti risorse:

Streaming del dispositivo: per testare l'app su dispositivi di produzione (inclusi dispositivi di riferimento) ospitati nei data center Google, vedi Streaming di dispositivi Android, con tecnologia Firebase
Emulatori in Android Studio Hedgehog: per informazioni sulla creazione per i dispositivi di riferimento, consulta Creare e gestire dispositivi virtuali
Emulatore ridimensionabile di Android Studio: per informazioni sull'accesso ai servizi vedi Eseguire app sull'emulatore Android.

È letterbox

Verifica che ogni attività possa utilizzare tutto lo spazio di visualizzazione disponibile per l'app. Innanzitutto, dichiara il seguente codice nella cartella di test:

Kotlin

fun Activity.isLetterboxed() : Boolean {
    if (isInMultiWindowMode) return false

    val wmc = WindowMetricsCalculator.getOrCreate()
    val currentBounds = wmc.computeCurrentWindowMetrics(this).bounds
    val maxBounds = wmc.computeMaximumWindowMetrics(this).bounds

    val isScreenPortrait = maxBounds.height() > maxBounds.width()

    return if (isScreenPortrait) {
        currentBounds.height() < maxBounds.height()
    } else {
        currentBounds.width() < maxBounds.width()
    }
}

Java

public boolean isLetterboxed(Activity activity) {
    if (activity.isInMultiWindowMode()) {
        return false;
    }

    WindowMetricsCalculator wmc = WindowMetricsCalculator.getOrCreate();
    Rect currentBounds = wmc.computeCurrentWindowMetrics(activity).getBounds()
    Rect maxBounds = wmc.computeMaximumWindowMetrics(activity).getBounds();

    boolean isScreenPortrait = maxBounds.height() > maxBounds.width();

    return (isScreenPortrait)
        ? currentBounds.height() < maxBounds.height()
        : currentBounds.width() < maxBounds.width();
}

Poi esegui un test per affermare il comportamento e assicurati che l'attività target non sia letterbox:

Kotlin

@get:Rule
val activityRule = ActivityScenarioRule(MainActivity::class.java)

@Test
fun activity_launched_notLetterBoxed() {
    activityRule.scenario.onActivity {
        assertThat(it.isLetterboxed()).isFalse()
    }
}

Java

@Rule
public ActivityScenarioRule<MainActivity> rule = new ActivityScenarioRule<>(MainActivity.class);

public void activity_launched_notLetterBoxed() {
    try (ActivityScenario<MainActivity> scenario = ActivityScenario.launch(MainActivity.class)) {
        scenario.onActivity(activity -> {
            assertThat(isLetterboxed(activity)).isFalse();
        });
    }
}

L'ideale è eseguire questo tipo di test solo finché non viene superato e affermare che è occupano tutto lo spazio di visualizzazione disponibile per l'app. Testare l'app su tutti i tipi di dispositivi per garantire un comportamento coerente.

Override per app

Android fornisce override che modificano il comportamento configurato delle app. Per Ad esempio, l'override di FORCE_RESIZE_APP indica sistema per bypassare la modalità di compatibilità delle dimensioni e ridimensionare l'app per adattarla al display anche se resizeableActivity="false" è specificato nel file manifest dell'app.

I produttori di dispositivi applicano override per determinate app (o tutte le app) attive per determinati dispositivi con schermi grandi. Su Android 14 (livello API 34) e versioni successive, gli utenti possono applicare override alle app tramite le impostazioni del dispositivo.

Override per app per utente

Su Android 14 e versioni successive, un menu Impostazioni consente agli utenti di modificare l'aspetto percentuale di app. Dispositivi con schermi di grandi dimensioni come il riferimento dispositivi implementano il menu.

Il menu contiene un elenco di tutte le app installate sul dispositivo. Gli utenti scelgono e quindi imposta le proporzioni dell'app su 3:4, 1:1, a schermo intero o su un altro valore. configurate dal produttore del dispositivo. Gli utenti possono anche reimpostare le proporzioni su il valore predefinito dell'app, specificato nel file manifest dell'app.

Le app possono disattivare l'override della compatibilità impostando i seguenti tag PackageManager.Property:

PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE

Per disattivare la sostituzione della compatibilità delle proporzioni utente, aggiungi la proprietà al file manifest dell'app e imposta il valore su false:
```
<application>
    <property
        android:name="android.window.
        PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE"
        android:value="false" />
</application>
```
La tua app verrà esclusa dall'elenco di app nelle impostazioni del dispositivo. Utenti non potranno sostituire le proporzioni dell'app.

L'impostazione della proprietà su true non ha alcun effetto.
PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE

Per disattivare l'opzione a schermo intero della compatibilità delle proporzioni utente eseguire l'override, aggiungere la proprietà al file manifest dell'app e impostare il valore su false:
```
<application>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE"
        android:value="false" />
</application>
```
L'opzione a schermo intero viene rimossa dall'elenco delle opzioni per le proporzioni in impostazioni del dispositivo. Gli utenti non potranno applicare la sostituzione a schermo intero a la tua app.

Attenzione: se PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE è false, questa proprietà non ha alcun effetto.

L'impostazione di questa proprietà su true non ha alcun effetto.

Ottimizza l'app per tutti gli schermi: non impostare restrizioni sulle proporzioni nelle la tua app. Utilizza le classi di dimensioni delle finestre per supportare diverse layout in base alla quantità di spazio di visualizzazione disponibile.

Override per app del produttore del dispositivo

I produttori di dispositivi applicano gli override in base alle singole app su determinati dispositivi. I dispositivi di riferimento potrebbero applicare alcuni override a una diverse app per impostazione predefinita.

Le app possono disattivare la maggior parte delle sostituzioni (consulta la sezione Per app override riportata di seguito).

Puoi testare la tua app con gli override attivati o disattivati utilizzando la compatibilità (vedi Strumenti del framework di compatibilità). Quando l'opzione è attiva, gli override vengono applicati all'intera app.

Puoi anche utilizzare Android Debug Bridge (adb) per attivare o disattivare gli override e determinare quali override applicare alla tua app.

Attiva o disattiva gli override nel seguente modo:

adb shell am compat enable/disable <override name/id> <package>

Per i dispositivi di riferimento, verifica quali override si applicano ai la tua app:

adb shell dumpsys platform_compat | grep <package name>

La seguente tabella elenca le sostituzioni disponibili insieme a indicazioni su come ottimizzare l'app in modo che non debba fare affidamento su override. Puoi aggiungere al file manifest dell'app per disattivare alcuni override.

Override per app
Tipo	Nome	ID	Descrizione
Ridimensionabilità	FORCE_RESIZE_APP	174042936	Bypassa la modalità di compatibilità delle dimensioni per l'app quando viene modificata la configurazione.
	FORCE_NON_RESIZE_APP	181136395	Forza l'attivazione della modalità di compatibilità delle dimensioni nell'app in caso di modifiche alla configurazione.
Proporzioni	OVERRIDE_MIN_ASPECT_RATIO	174042980	Override gatekeeper che deve essere attivato per applicare eventuali altre sostituzioni delle proporzioni.
	OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY	203647190	Se questa opzione è abilitata (impostazione predefinita), limita l'ambito dell'override alle attività solo verticale.
	OVERRIDE_MIN_ASPECT_RATIO_MEDIUM	180326845	Modifica le proporzioni minime in 3:2.
	OVERRIDE_MIN_ASPECT_RATIO_LARGE	180326787	Modifica le proporzioni minime in 16:9.
	OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN	208648326	Modifica le proporzioni minime in modo che si adattino al 50% delle dimensioni del display (o alle proporzioni dello schermo diviso).
	OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN	218959984	Disattiva la sostituzione delle proporzioni minime in modo che le app siano a schermo intero quando il dispositivo è in verticale.
Orientamento	OVERRIDE_ANY_ORIENTATION	265464455	Consente di eseguire l'override di qualsiasi orientamento.
	OVERRIDE_ANY_ORIENTATION_TO_USER	310816437	Sostituisce le limitazioni di orientamento, ridimensionabilità e proporzioni.
	OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT	265452344	Consente di sostituire l'orientamento su verticale quando un'attività ha un orientamento non definito.
	OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR	265451093	Consente di sostituire l'orientamento su `nosensor` (utilizza l'orientamento naturale del dispositivo) quando un'attività ha un orientamento indefinito.
	OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE	266124927	Ruota le app in modalità orizzontale di 180 gradi.
	OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA	265456536	Limita l'ambito della sostituzione dell'orientamento al momento in cui l'app è connessa alla fotocamera.
	OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION	255940284	Imposta il display sull'orientamento naturale orizzontale fisso quando un'attività è a schermo intero (anche in formato letterbox).
	OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION	254631730	Ignora le richieste di orientamento dell'app per evitare loop infiniti di rotazione.
	OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED	273509367	Ignora le richieste di orientamento ripetute durante il riavvio di un'attività. Se Android rileva che un'app richiede almeno due nuovi orientamenti in un secondo, il sistema lo considera un ciclo infinito di rotazione e applica l'override.
	OVERRIDE_RESPECT_REQUESTED_ORIENTATION	236283604	Impedisce il letterbox disattivando l'impostazione della richiesta di orientamento che il produttore del dispositivo può ignorare.
API Sandbox	NEVER_SANDBOX_DISPLAY_APIS	184838306	Impedisce di modificare il comportamento delle API di visualizzazione.
	ALWAYS_SANDBOX_DISPLAY_APIS	185004937	Forza l'API `Display` nell'app a restituire i limiti dell'app. Le API `Display` restituiscono limiti dell'area di visualizzazione logici, ma a volte l'app presuppone che le API di `Display` restituiscano limiti dell'app, causando problemi nell'interfaccia utente.
	OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS	237531167	Forza l'API `View` utilizzata nell'app a restituire i limiti dell'app. Le API `View` restituiscono limiti dell'area di visualizzazione logici, ma a volte l'app presuppone che le API di `View` restituiscano limiti dell'app, causando problemi nell'interfaccia utente.
Compatibilità fotocamera	OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION	263959004	Disattiva la rotazione forzata. Per impostazione predefinita, tutte le app della fotocamera con orientamento fisso vengono ruotate forzatamente quando l'anteprima della fotocamera è aperta.
	OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH	264304459	Rimuove l'aggiornamento forzato predefinito applicato quando viene forzata la rotazione dell'anteprima della fotocamera.
	OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE	264301586	Imposta l'aggiornamento forzato su un aggiornamento leggero quando viene forzata la rotazione dell'anteprima della fotocamera, per preservare lo stato durante la rotazione forzata. Per impostazione predefinita, Android applica un aggiornamento forzato quando viene forzata la rotazione dell'anteprima della fotocamera. L'aggiornamento forzato può causare problemi di perdita dello stato o di oscuramento delle app, a seconda di come le app hanno memorizzato lo stato precedente nella cache.
	OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT	250678880	Ritaglia il buffer dell'immagine della fotocamera anteriore interna. Se l'override viene disattivato, il ritaglio della fotocamera anteriore interna viene rimosso e il campo visivo dell'anteprima della fotocamera viene aumentato. Per impostazione predefinita, su alcuni pieghevoli (vedi i dispositivi di riferimento), il sistema ritaglia l'anteprima della fotocamera di tutte le app della fotocamera quando viene utilizzata la fotocamera anteriore interna.
Vari	OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS	263259275	Impedisce che l'app venga oscurata quando perde lo stato attivo in modalità schermo diviso. L'app attende lo stato attivo prima di disegnarne i contenuti, causando il blocco o l'oscuramento dell'app. L'override consente ad Android di inviare un falso evento di stato attivo all'app, che indica all'app di iniziare di nuovo a tracciare i contenuti.

APP_FORCE_RESIZE

Forza il ridimensionamento dei pacchetti a cui viene applicato l'override. No cambia se l'app può essere impostata in modalità multi-finestra, ma consente per ridimensionare senza attivare la modalità di compatibilità delle dimensioni quando lo schermo viene ridimensionato.

In che modo le app possono ottenere lo stesso risultato dell'override

Nel file manifest dell'app, imposta Attributo android:resizeableActivity a true o a supporta il ridimensionamento durante la disattivazione della modalità multi-finestra con android:resizeableActivity=false, imposta android.supports_size_changes il flag di metadati su true.

Come ottimizzare le app

Usare layout adattabili/adattivi per consentire alle app di adattarsi a tutte le dimensioni di visualizzazione proporzioni. Consulta Supporto di schermi di dimensioni diverse.

Come disattivare o disattivare l'override

Imposta il flag della proprietà PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES su false.

Flag proprietà da modificare

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
  android:value="true|false"/>

Comandi adb per testare l'override

Per applicare l'override e rendere l'app ridimensionabile:

adb shell am compat enable FORCE_RESIZE_APP <package>

Per rimuovere la sostituzione:

adb shell am compat disable FORCE_RESIZE_APP <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

FORCE_NON_RESIZE_APP

Obbliga i pacchetti a cui viene applicato l'override come non ridimensionabili e entra in modalità di compatibilità delle dimensioni quando modifichi la configurazione.

In che modo le app possono ottenere lo stesso risultato dell'override

Imposta sia l'attributo android:resizeableActivity che il flag di metadati android.supports_size_changes per false nel file manifest dell'app; e dichiarare una limitazione di orientamento o proporzioni.

Come ottimizzare le app

Tutte le app che si comportano correttamente se ridimensionate dovrebbero avere android:resizeableActivity o android.supports_size_changes impostati su true. Le altre app dovrebbero essere migliorate per comportarsi bene quando vengono ridimensionate. Consulta android:resizeableActivity.

Come disattivare o disattivare l'override

Imposta il flag della proprietà PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES su false.

Flag proprietà da modificare

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
  android:value="true|false"/>

Comandi adb per testare l'override

Per applicare l'override e rendere l'app non ridimensionabile:

adb shell am compat enable FORCE_NON_RESIZE_APP <package>

Per rimuovere la sostituzione:

adb shell am compat disable FORCE_NON_RESIZE_APP <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO

Il gatekeeper per tutti gli override che forzano un determinato formato minimo.

In che modo le app possono ottenere lo stesso risultato dell'override

Imposta android:minAspectRatio a livello di attività o app.

Come ottimizzare le app

Non impostare limitazioni relative alle proporzioni nella tua app. Assicurati che la tua app supporti schermi di dimensioni diverse. Utilizzare le classi di dimensioni delle finestre per supportare layout diversi in base alla quantità di spazio a disposizione dell'app schermo. Vedi l'API Compose WindowSizeClass e Visualizza l'API WindowSizeClass.

Come disattivare o disattivare l'override

Specifica una limitazione per le proporzioni o imposta il flag della proprietà Da PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE a false.

Flag proprietà da modificare

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE"
  android:value="false"/>

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

Limita le impostazioni dell'app che forzano un determinato formato minimo per le attività con orientamento solo verticale. Attivato per impostazione predefinita e ha effetto solo se è abilitato anche OVERRIDE_MIN_ASPECT_RATIO.

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO_MEDIO

Imposta le proporzioni minime dell'attività su un valore medio (3:2)

In che modo le app possono ottenere lo stesso risultato dell'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come ottimizzare le app

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come disattivare o disattivare l'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Flag proprietà da modificare

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

Imposta le proporzioni minime dell'attività su un valore elevato (16:9)

In che modo le app possono ottenere lo stesso risultato dell'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come ottimizzare le app

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come disattivare o disattivare l'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Flag proprietà da modificare

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>`

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN

Consente di attivare l'utilizzo delle proporzioni dello schermo diviso. Consente a un'app di utilizzare tutte le di spazio disponibile in modalità schermo diviso, evitando il letterbox.

In che modo le app possono ottenere lo stesso risultato dell'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come ottimizzare le app

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come disattivare o disattivare l'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Flag proprietà da modificare

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

Disattiva la sostituzione delle proporzioni minime in modalità a schermo intero verticale per utilizzare tutte di spazio disponibile sullo schermo.

In che modo le app possono ottenere lo stesso risultato dell'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come ottimizzare le app

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Come disattivare o disattivare l'override

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Flag proprietà da modificare

Vedi OVERRIDE_MIN_ASPECT_RATIO.

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_ANY_ORIENTATION

Attiva le seguenti sostituzioni per eseguire l'override di qualsiasi orientamento:

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT
OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR
OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

In che modo le app possono ottenere lo stesso risultato dell'override

Imposta l'attributo del file manifest activity:screenOrientation, o utilizzare l'API Activity#setRequestedOrientation().

Come ottimizzare le app

L'app deve supportare tutti gli orientamenti. Per cambio di orientamento si intende di configurazione, che può essere gestita in due modi: lasciando che eliminare e ricreare l'app dal sistema oppure gestire le modifiche alla configurazione per te. Se gestisci autonomamente le modifiche alla configurazione, lo stato dell'app può essere conservati tramite ViewModel. In casi molto limitati, puoi decidere di bloccare orientato correttamente solo su display piccoli, anche se potrebbe non essere ridimensionato consentendo all'utente di ruotare l'app in base alle esigenze. Su Android 12L e versioni successive, l'orientamento fisso può essere sostituito dalla configurazione del dispositivo. Per ulteriori informazioni informazioni sulla gestione delle modifiche alla configurazione e sul supporto orientamenti. Consulta Gestire le modifiche alla configurazione. Panoramica di ViewModel e Orientamento app limitato su ma non sui dispositivi con schermi grandi.

Come disattivare o disattivare l'override

Imposta il flag della proprietà PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE a false.

Flag proprietà da modificare

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

Comandi adb per testare l'override

Per applicare l'override:

adb shell am compat enable OVERRIDE_ANY_ORIENTATION <package>

Per rimuovere la sostituzione:

adb shell am compat disable OVERRIDE_ANY_ORIENTATION <package>

Nota:i comandi applicano o rimuovono l'override solo temporaneamente.

OVERRIDE_ANY_ORIENTATION_TO_USER

Consente all'app di riempire lo spazio di visualizzazione disponibile. Sostituisce qualsiasi orientamento, ridimensionabilità e proporzioni specificate nel file manifest dell'app. Inoltre ignora tutte le chiamate a Activity#setRequestedOrientation().

In che modo le app possono ottenere lo stesso risultato dell'override

Non impostare il file manifest di android:screenOrientation oppure imposta l'attributo su "user".
Impostare il manifest di android:resizeableActivity a true.

Nota: le impostazioni per android:minAspectRatio e android:maxAspectRatio vengono ignorati se resizeableActivity è impostato su true.
Su schermi piccoli, per supportare il ridimensionamento delle app durante la disattivazione della modalità multi-finestra con android:resizeableActivity=false, imposta Flag di metadati android.supports_size_changes in true. Non impostare minAspectRatio e maxAspectRatio.

Nota: su Android 12 (livello API 31), tutte le app vengono eseguite in modalità multi-finestra schermi grandi (sw >= 600 dp) a prescindere dalla configurazione dell'app. Consulta Supporto multi-finestra.

Come ottimizzare le app

Consenti alla tua app di supportare tutti gli orientamenti. non impostare un screenOrientation nel file manifest dell'app. Supporta la ridimensionabilità delle app, modalità multi-finestra e tutte le proporzioni di visualizzazione impostando la Attributo android:resizeableActivity nel file manifest dell'app a true. Consulta Supporto di schermi di dimensioni diverse.

Modalità di compatibilità del dispositivo

Dispositivi di riferimento

Problemi comuni di compatibilità

Letterboxing

Problema

App limitata all'orientamento verticale non utilizzabile sul dispositivo orizzontale.

Ottimizzazione

L'app supporta tutti gli orientamenti del dispositivo.

Soluzione alternativa per la compatibilità

Modalità di compatibilità delle dimensioni

Problema

L'app non ridimensionabile si arresta in modo anomalo in modalità multi-finestra.

Ottimizzazione

L'app funziona con finestre di tutte le dimensioni.

Soluzione alternativa per la compatibilità

Letterbox dell'app solo verticale con orientamento orizzontale, ridimensionata dal controllo di riavvio.

Anelli sfarfallanti

Problema

L'app solo in orizzontale su display verticale effettua chiamate ripetute a Activity#setRequestedOrientation().

Ottimizzazione

L'app gestisce la modifica della configurazione, non ha limitazioni di orientamento e non inserisce quindi in loop lo sfarfallio.

Soluzione alternativa per la compatibilità

Anteprima fotocamera

Problema

Anteprima della fotocamera disallineata e distorta su schermo pieghevole di grandi dimensioni.

Ottimizzazione

Anteprima della fotocamera allineata e ridimensionata correttamente in tutti gli orientamenti del dispositivo.

Soluzione alternativa per la compatibilità

Tablet: forza la rotazione dell'app con limitazioni per l'orientamento verticale.

Pieghevole: forza la rotazione dell'app con limitazioni per l'orientamento verticale. Anche l'app è in formato letterbox.

API utilizzate spesso in modo improprio

Problema

L'API deprecata calcola erroneamente i limiti delle app. I contenuti dell'app vengono rimossi dallo schermo.

Ottimizzazione

L'API calcola correttamente le metriche relative alla finestra dell'app.

Soluzione alternativa per la compatibilità

Attività trasparenti

Problema

La finestra di dialogo è posizionata in modo errato perché l'attività è stata avviata da un trampolino.

Ottimizzazione

Angoli arrotondati

Finestra di dialogo con angoli arrotondati correttamente posizionati sopra l'attività di avvio visibile.

Soluzione alternativa per la compatibilità

Giochi Unity

Problema

Il gioco non è più attivo in modalità multi-finestra e viene visualizzato come una finestra nera.

Ottimizzazione

Il gioco esegue il rendering dei contenuti correttamente in modalità multi-finestra anche quando non è a fuoco.

Soluzione alternativa per la compatibilità

Testare l'app per verificare la presenza di problemi di compatibilità

È letterbox

Kotlin

Java

Kotlin

Java

Override per app

Override per app per utente

Override per app del produttore del dispositivo

APP_FORCE_RESIZE

In che modo le app possono ottenere lo stesso risultato dell'override

Come ottimizzare le app

Come disattivare o disattivare l'override

Flag proprietà da modificare

Comandi adb per testare l'override

FORCE_NON_RESIZE_APP

In che modo le app possono ottenere lo stesso risultato dell'override

Come ottimizzare le app

Come disattivare o disattivare l'override

Flag proprietà da modificare

Comandi adb per testare l'override

OVERRIDE_MIN_ASPECT_RATIO

In che modo le app possono ottenere lo stesso risultato dell'override

Come ottimizzare le app

Come disattivare o disattivare l'override

Flag proprietà da modificare

Comandi adb per testare l'override

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

In che modo le app possono ottenere lo stesso risultato dell'override

Come ottimizzare le app

Come disattivare o disattivare l'override

L'app solo in orizzontale su display verticale effettua chiamate ripetute a `Activity#setRequestedOrientation()`.