Le limitazioni relative all'orientamento e al ridimensionamento vengono ignorate

Con le app per Android che ora vengono eseguite su una varietà di dispositivi (come smartphone, tablet, pieghevoli, computer, auto e TV) e modalità di gestione delle finestre su schermi di grandi dimensioni (come schermo diviso e finestre delle app), gli sviluppatori devono creare app per Android che si adattino a qualsiasi dimensione dello schermo e della finestra, indipendentemente dall'orientamento del dispositivo. Paradigmi come la limitazione dell'orientamento e della ridimensionabilità sono troppo restrittivi nel mondo multi-dispositivo di oggi.

Ignora le limitazioni di orientamento, ridimensionamento e proporzioni

Per le app che hanno come target Android 17 (livello API 37) o versioni successive, le limitazioni relative a orientamento, ridimensionamento e proporzioni non si applicano più ai display con larghezza minima superiore a 600 dp. Le app riempiono l'intera finestra di visualizzazione, indipendentemente dalle proporzioni o dall'orientamento preferito dell'utente, e non viene utilizzato il pillarbox.

Android 17 rimuove la disattivazione temporanea per gli sviluppatori delle limitazioni di orientamento e ridimensionamento sui dispositivi con schermi grandi fornita in Android 16.

Questa modifica introduce un nuovo comportamento standard della piattaforma. Android sta adottando un modello in cui le app devono adattarsi a vari orientamenti, dimensioni del display e proporzioni. Limitazioni come l'orientamento fisso o la ridimensionabilità limitata ostacolano l'adattabilità dell'app. Rendi la tua app adattabile per offrire la migliore esperienza utente possibile.

Puoi anche testare questo comportamento utilizzando il framework di compatibilità delle app e attivando il flag di compatibilità UNIVERSAL_RESIZABLE_BY_DEFAULT.

Modifiche che provocano un errore comuni

Ignorare le limitazioni di orientamento, ridimensionamento e proporzioni potrebbe influire sulla UI della tua app su alcuni dispositivi, in particolare sugli elementi progettati per layout di piccole dimensioni bloccati in orientamento verticale. Ad esempio, le app potrebbero presentare problemi come layout allungati e animazioni e componenti fuori schermo. Qualsiasi ipotesi tu faccia sulle proporzioni o sull'orientamento può causare problemi visivi con la tua app. Scopri di più su come evitare questi problemi e migliorare il comportamento adattivo della tua app.

Un problema comune sui pieghevoli in modalità orizzontale o per i calcoli delle proporzioni in scenari come multi-finestra, finestre delle app o display collegati è quando l'anteprima della fotocamera appare allungata, ruotata o ritagliata. Questo problema si verifica spesso su dispositivi con schermi grandi e pieghevoli perché le app presuppongono relazioni fisse tra le funzionalità della fotocamera (come le proporzioni e l'orientamento del sensore) e le funzionalità del dispositivo (come l'orientamento del dispositivo e l'orientamento naturale). Scopri di più sulla gestione dell'anteprima della videocamera.

Consentire la rotazione del dispositivo comporta una maggiore ricreazione delle attività, il che può comportare la perdita dello stato dell'utente se non viene conservato correttamente. Scopri come salvare correttamente lo stato della UI in Salva gli stati della UI.

Dettagli di implementazione

I seguenti attributi del manifest e le seguenti API di runtime vengono ignorati sui dispositivi con schermi grandi nelle modalità a schermo intero e multi-finestra:

I seguenti valori per screenOrientation, setRequestedOrientation() e getRequestedOrientation() vengono ignorati:

  • portrait
  • reversePortrait
  • sensorPortrait
  • userPortrait
  • landscape
  • reverseLandscape
  • sensorLandscape
  • userLandscape

Per quanto riguarda la ridimensionabilità del display, android:resizeableActivity="false", android:minAspectRatio e android:maxAspectRatio non hanno alcun effetto.

Eccezioni

Le limitazioni di orientamento, ridimensionamento e proporzioni di Android 17 non si applicano nelle seguenti situazioni:

  • Giochi (in base al flag android:appCategory)
  • Utenti che attivano esplicitamente il comportamento predefinito dell'app nelle impostazioni delle proporzioni del dispositivo
  • Schermi con larghezza minima inferiore a sw600dp