Einschränkungen für Ausrichtung und Größe werden ignoriert

Android-Apps laufen jetzt auf einer Vielzahl von Geräten (z. B. Smartphones, Tablets, faltbare Geräte, Computer, Autos und Fernseher) und in verschiedenen Fenstermodi auf großen Bildschirmen (z. B. Split-Screen und Desktop-Fenster). Entwickler sollten Android-Apps entwickeln, die sich unabhängig von der Geräteausrichtung an jede Bildschirm- und Fenstergröße anpassen. Paradigmen wie die Einschränkung der Ausrichtung und Größenänderung sind in der heutigen Welt mit mehreren Geräten zu restriktiv.

Einschränkungen in Bezug auf Ausrichtung, Anpassbarkeit und Seitenverhältnis ignorieren

Bei Apps, die auf Android 17 (API-Level 37) oder höher ausgerichtet sind, gelten Einschränkungen für die Ausrichtung, Größenänderung und das Seitenverhältnis nicht mehr auf Displays, deren kleinste Breite größer als 600 dp ist. Apps füllen das gesamte Displayfenster aus, unabhängig vom Seitenverhältnis oder der bevorzugten Ausrichtung des Nutzers. Pillarboxing wird nicht verwendet.

In Android 17 wird die temporäre Deaktivierung für Entwickler von Einschränkungen für die Ausrichtung und Größenänderung auf Geräten mit großen Displays entfernt, die in Android 16 verfügbar war.

Mit dieser Änderung wird ein neues Standardplattformverhalten eingeführt. Android entwickelt sich zu einem Modell, in dem Apps an verschiedene Ausrichtungen, Displaygrößen und Seitenverhältnisse angepasst werden müssen. Einschränkungen wie eine feste Ausrichtung oder eine begrenzte Anpassungsfähigkeit der Größe beeinträchtigen die Anpassungsfähigkeit der App. Gestalten Sie Ihre App adaptiv, um eine optimale Nutzererfahrung zu bieten.

Sie können dieses Verhalten auch mit dem App-Kompatibilitätsframework testen und das Kompatibilitätsflag UNIVERSAL_RESIZABLE_BY_DEFAULT aktivieren.

Häufige funktionsgefährdende Änderungen

Wenn Sie die Einschränkungen für Ausrichtung, Größenänderung und Seitenverhältnis ignorieren, kann sich das auf einigen Geräten auf die Benutzeroberfläche Ihrer App auswirken, insbesondere auf Elemente, die für kleine Layouts im Hochformat entwickelt wurden. Apps können beispielsweise Probleme wie gestreckte Layouts und Animationen und Komponenten außerhalb des Bildschirms aufweisen. Alle Annahmen, die Sie in Bezug auf das Seitenverhältnis oder die Ausrichtung treffen, können zu visuellen Problemen in Ihrer App führen. Weitere Informationen dazu, wie Sie diese Probleme vermeiden und das adaptive Verhalten Ihrer App verbessern können

Ein häufiges Problem bei faltbaren Geräten im Querformat oder bei der Berechnung des Seitenverhältnisses in Szenarien wie dem Mehrfenstermodus, dem Desktop-Freiform-Fenster oder bei verbundenen Displays ist, wenn die Kameravorschau gestreckt, gedreht oder zugeschnitten dargestellt wird. Dieses Problem tritt häufig auf Geräten mit großem Display und faltbaren Geräten auf, da Apps von festen Beziehungen zwischen Kamerafunktionen (z. B. Seitenverhältnis und Sensorausrichtung) und Gerätefunktionen (z. B. Geräteausrichtung und natürliche Ausrichtung) ausgehen. Weitere Informationen zum Verwalten der Kameravorschau

Wenn Sie die Geräteausrichtung zulassen, wird die Aktivität häufiger neu erstellt. Das kann dazu führen, dass der Nutzerstatus verloren geht, wenn er nicht richtig beibehalten wird. Informationen zum korrekten Speichern des UI-Zustands finden Sie unter UI-Zustände speichern.

Details zur Implementierung

Die folgenden Manifestattribute und Laufzeit-APIs werden auf Geräten mit großen Displays im Vollbild- und Mehrfenstermodus ignoriert:

Die folgenden Werte für screenOrientation, setRequestedOrientation() und getRequestedOrientation() werden ignoriert:

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

Die Größenanpassung des Displays, android:resizeableActivity="false", android:minAspectRatio und android:maxAspectRatio haben keine Auswirkungen.

Ausnahmen

Die Einschränkungen für Ausrichtung, Größenänderung und Seitenverhältnis von Android 17 gelten in den folgenden Situationen nicht:

  • Spiele (basierend auf der Flagge android:appCategory)
  • Nutzer, die das Standardverhalten der App in den Einstellungen für das Seitenverhältnis des Geräts explizit aktivieren
  • Bildschirme, deren kleinste Breite kleiner als sw600dp ist