Orientamento, proporzioni e ridimensionamento delle app

Le app per Android vengono eseguite su dispositivi di tutti i tipi: smartphone, tablet, pieghevoli, dispositivi ChromeOS, auto, TV e persino XR. Per adattarsi a questo ambiente variegato, la tua app deve supportare tutti i fattori di forma e le dimensioni di visualizzazione dei dispositivi.

Android 16 (livello API 36) consente alle app di adattarsi a diversi fattori di forma e dimensioni del display eseguendo l'override delle limitazioni delle app relative all'orientamento dello schermo, alle proporzioni e al ridimensionamento. Gli override si applicano ai dispositivi con larghezza minima >= 600 dp, che definisce quanto segue:

  • Tablet
  • Display interni di pieghevoli con schermo grande
  • Finestre delle app (su tutti i fattori di forma)

Le app che hanno come target il livello API 36 sono ridimensionabili e possono attivare la modalità multi-finestra (equivalente a resizeableActivity="true") se la larghezza minima del display è >= 600 dp.

L'app è in formato letterbox su un dispositivo con schermo grande aperto con una versione precedente ad Android 16, ma è a schermo intero se ha come target Android 16. L'app mostra più notizie quando è a schermo intero rispetto a quando è in formato letterbox.
Figura 1. Il feed di notizie per gli sviluppatori, precedentemente visualizzato in formato letterbox sui dispositivi con schermi grandi (a sinistra), viene eseguito a schermo intero quando il target è Android 16 (a destra).

Android 16 applica un modello coerente di design adattivo delle app che ottimizza l'esperienza utente rispettando le preferenze dell'utente in termini di orientamento del dispositivo, proporzioni e dimensioni del display.

Modifiche

I seguenti attributi del manifest e le seguenti API vengono ignorati per le app che hanno come target Android 16 (livello API 36) su schermi di grandi dimensioni:

Attributo o API Valori ignorati
screenOrientation portrait, landscape, reversePortrait, reverseLandscape, sensorPortrait, sensorLandscape, userPortrait, userLandscape
resizeableActivity tutti
minAspectRatio tutti
maxAspectRatio tutti
setRequestedOrientation()

getRequestedOrientation()
portrait, landscape, reversePortrait, reverseLandscape, sensorPortrait, sensorLandscape, userPortrait, userLandscape

Eccezioni

Le eccezioni alle modifiche di Android 16 includono:

  • Display più piccoli di sw600dp (la maggior parte degli smartphone, dei dispositivi pieghevoli e dei display esterni dei pieghevoli con schermo grande)

  • Giochi, in base al flag android:appCategory

    Pubblica il tuo gioco utilizzando Android App Bundle e la firma dell'app di Google Play, consentendo a Google Play di gestire il flag e di fornire automaticamente i vantaggi degli app bundle. Consulta anche la panoramica del manifest dell'app.

  • L'utente attiva il comportamento predefinito dell'app nelle impostazioni delle proporzioni

Disattiva

Per disattivare il comportamento del livello API 36, dichiara la proprietà del manifest PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY.

Per disattivare una specifica attività, imposta la proprietà nell'elemento <activity>:

<activity ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</activity>

Per disattivare l'opzione per l'intera app, imposta la proprietà nell'elemento <application>:

<application ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</application>

Se la tua app ha come target Android 16 (livello API 36) o versioni successive, questa proprietà non blocca l'orientamento dello schermo né impedisce la rotazione dello schermo su display di grandi dimensioni.

Test

Per verificare se la tua app è interessata dalle modifiche di Android 16, utilizza gli emulatori delle serie Pixel Tablet e Pixel Fold in Android Studio e imposta targetSdkPreview = "Baklava" nel file build.gradle del modulo della tua app.

In alternativa, utilizza il framework di compatibilità delle app sui tuoi dispositivi di test attivando il flag UNIVERSAL_RESIZABLE_BY_DEFAULT (consulta Strumenti del framework di compatibilità).

Puoi automatizzare i test con il framework di test Espresso e le API di test di Jetpack Compose.

Guida all'implementazione

Le app che limitano l'orientamento del dispositivo, le proporzioni o la ridimensionabilità dell'app potrebbero presentare problemi di visualizzazione su Android 16, ad esempio layout sovrapposti. Per offrire un'esperienza utente ottimale su smartphone, pieghevoli, tablet, dispositivi ChromeOS e altro ancora, crea la tua app in modo che sia adattabile e reattiva.

Elenco di controllo relativo all'idoneità

Utilizza il seguente elenco di controllo per assicurarti che la tua app sia pronta per le modifiche di Android 16:

  • Evita componenti UI allungati: i layout progettati per gli schermi degli smartphone standard in modalità verticale potrebbero non adattarsi ad altre proporzioni. Ad esempio, gli elementi UI che riempiono l'intera larghezza del display possono apparire allungati nell'orientamento orizzontale. Aggiungi una larghezza massima ai componenti per evitare che si allunghino.
  • Attiva lo scorrimento dei layout: se i layout non scorrono, gli utenti potrebbero non essere in grado di accedere ai pulsanti o ad altri elementi UI fuori dallo schermo in orientamento orizzontale. Abilita lo scorrimento dei layout delle app per verificare che tutti i contenuti siano raggiungibili, indipendentemente dall'altezza del display.
  • Verifica la compatibilità della fotocamera in modalità verticale e orizzontale: le anteprime del mirino della fotocamera che presuppongono proporzioni e orientamento specifici rispetto al sensore della fotocamera possono generare anteprime allungate o capovolte su display non conformi. Verifica che i mirini ruotino correttamente con i cambiamenti di orientamento. Consenti ai mirini di adattarsi alle proporzioni della UI che differiscono da quelle del sensore.
  • Mantieni lo stato durante le modifiche alle dimensioni della finestra: la rimozione delle limitazioni relative all'orientamento e alle proporzioni può comportare frequenti modifiche alle dimensioni della finestra dell'app in risposta al modo in cui gli utenti preferiscono utilizzare un'app, ad esempio ruotando, piegando o aprendo un dispositivo o ridimensionando un'app in modalità multi-finestra o finestre delle app. Le modifiche alla configurazione, come i cambi di orientamento e il ridimensionamento delle finestre, causano la ricreazione dell'attività (per impostazione predefinita). Per offrire un'esperienza utente ottimale, conserva lo stato dell'app in modo che i dati (come l'input dei moduli) vengano conservati e gli utenti possano mantenere il contesto.
  • Utilizza le classi di dimensioni delle finestre: supporta diverse dimensioni e proporzioni delle finestre senza personalizzazioni specifiche per il dispositivo. Presumi che le dimensioni della finestra cambieranno di frequente. Utilizza le classi di dimensioni delle finestre per caratterizzare le dimensioni delle finestre, quindi applica un layout adattivo appropriato.
  • Crea layout adattabili: all'interno delle classi di dimensioni della finestra, i layout adattabili si adattano alle variazioni delle dimensioni del display per creare sempre una presentazione ottimale dell'app.

Per una guida pratica alla creazione di layout adattivi in Compose, consulta il codelab Crea app adattive con Jetpack Compose. Se stai eseguendo la migrazione di un'app che utilizza le visualizzazioni, consulta la strategia di adozione di Compose.

Cronologia

  • Android 16 (2025): il supporto di tutti gli orientamenti e le proporzioni e del ridimensionamento delle app è l'esperienza di base per i dispositivi con schermi di grandi dimensioni (larghezza minima dello schermo >= 600 dp) per le app che hanno come livello API target il livello API 36. Tuttavia, gli sviluppatori possono disattivare questa opzione.
Livello API target Dispositivi applicabili Disattivazione da parte dello sviluppatore consentita
36 (Android 16) Dispositivi con schermo grande (larghezza minima dello schermo >= 600 dp) Sì

Le scadenze per il targeting di livelli API specifici variano in base allo store. A partire da agosto 2026, Google Play richiederà alle app di avere come target il livello API 36.

Risorse aggiuntive