應用程式方向、顯示比例和大小調整功能

Android 應用程式可在各種裝置上執行,包括手機、平板電腦、折疊式裝置、ChromeOS 裝置、車輛、電視,甚至是 XR。為適應這種多樣化的環境,應用程式應支援所有裝置板型規格和螢幕大小。

Android 16 (API 級別 36) 可讓應用程式覆寫螢幕方向、顯示比例和大小調整功能的限制,適應不同的板型規格和螢幕大小。覆寫設定適用於最小寬度 >= 600dp 的裝置,定義如下:

  • 平板電腦
  • 大螢幕摺疊式裝置的內螢幕
  • 電腦分割視窗 (適用於所有板型規格)

指定目標 API 級別 36 的應用程式可調整大小,並能進入多視窗模式 (相當於 resizeableActivity="true"),如果螢幕的最小寬度 >= 600dp。

在 Android 16 之前,應用程式在展開的大螢幕裝置上會以上下黑邊模式顯示,但指定 Android 16 時會以全螢幕模式顯示。應用程式在全螢幕模式下顯示的新聞項目,比在上下黑邊模式下多。
圖 1. 開發人員新聞動態消息先前在大螢幕裝置上採用上下黑邊 (左),指定 Android 16 時則以全螢幕執行 (右)。

Android 16 強制採用一致的自動調整應用程式設計模型,根據使用者對裝置方向、顯示比例和螢幕大小的偏好設定,提供最佳使用者體驗。

變更

如果應用程式指定 Android 16 (API 級別 36) 為目標版本,在大螢幕上會忽略下列資訊清單屬性和 API:

屬性或 API 忽略的值
screenOrientation portrait,landscape,reversePortrait,reverseLandscape,sensorPortrait,sensorLandscape,userPortrait,userLandscape
resizeableActivity 全部
minAspectRatio 全部
maxAspectRatio 全部
setRequestedOrientation()

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

例外狀況

Android 16 變更的例外狀況包括:

  • 小於 sw600dp 的螢幕 (大多數手機、折疊式裝置,以及大螢幕折疊式裝置的外螢幕)

  • 遊戲,根據 android:appCategory 旗標

    使用 Android App Bundle 和 Play 應用程式簽署功能發布遊戲,讓 Google Play 管理標記,並自動提供應用程式套件的優點。另請參閱「應用程式資訊清單總覽」。

  • 使用者在顯示比例設定中,選擇加入應用程式的預設行為

停用

如要停用 API 級別 36 的行為,請宣告 PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY 資訊清單屬性。

如要停用特定活動,請在 <activity> 元素中設定屬性:

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

如要為整個應用程式停用,請在 <application> 元素中設定屬性:

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

如果應用程式指定 Android 16 (API 級別 36) 以上版本,則這項屬性不會鎖定螢幕方向,也不會防止大螢幕旋轉。

測試

如要測試應用程式是否受到 Android 16 異動影響,請在 Android Studio 中使用 Pixel Tablet 和 Pixel Fold 系列模擬器,並在應用程式模組的 build.gradle 檔案中設定 targetSdkPreview = "Baklava"。

您也可以在測試裝置上使用應用程式相容性架構,方法是啟用 UNIVERSAL_RESIZABLE_BY_DEFAULT 旗標 (請參閱「相容性架構工具」)。

您可以使用 Espresso 測試架構和 Jetpack Compose 測試 API 自動執行測試。

導入指南

如果應用程式限制裝置螢幕方向、顯示比例或應用程式大小調整功能,在 Android 16 上可能會有顯示問題,例如版面配置重疊。如要在手機、摺疊式裝置、平板電腦、ChromeOS 裝置等裝置上提供最佳使用者體驗,請將應用程式建構為回應式和自動調整式。

準備度檢查清單

請參考下列檢查清單,確保應用程式已準備好因應 Android 16 的變更:

  • 避免 UI 元件拉伸:專為標準直向手機螢幕設計的版面配置,可能無法配合其他顯示比例。舉例來說,填滿整個螢幕寬度的 UI 元素在橫向模式下可能會顯得過於拉長。為元件設定寬度上限,避免元件拉伸。
  • 啟用版面配置捲動功能:如果版面配置無法捲動,使用者可能無法存取橫向模式下螢幕外的按鈕或其他 UI 元素。啟用應用程式版面配置捲動功能,確認無論螢幕高度為何,都能存取所有內容。
  • 驗證相機在直向和橫向模式下的相容性:如果相機觀景窗預覽畫面假設相對於鏡頭感應有特定顯示比例和螢幕方向,可能會在不符合規定的螢幕上導致預覽畫面延展或翻轉。確認觀景窗會隨著方向變更正確旋轉。 啟用觀景窗,調整與感應器顯示比例不同的 UI 顯示比例。
  • 在視窗大小變更時保留狀態:移除螢幕方向和顯示比例限制後,應用程式視窗大小可能會頻繁變更,以因應使用者偏好的應用程式使用方式,例如旋轉、摺疊或展開裝置,或是在多視窗模式或電腦分割視窗模式下調整應用程式大小。設定變更 (例如方向變更和視窗大小調整) 會導致活動重建 (預設)。為提供最佳使用者體驗,請保留應用程式狀態,讓應用程式保留資料 (例如表單輸入內容),並讓使用者能維持情境。
  • 使用視窗大小類別:支援不同的視窗大小和顯示比例,不需針對特定裝置進行自訂。假設視窗大小會頻繁變更。使用視窗大小類別來描述視窗尺寸,然後套用適當的自動調整式版面配置。
  • 建構回應式版面配置:在視窗大小類別中,回應式版面配置會根據螢幕尺寸變化進行調整,一律以最佳方式呈現應用程式。

如需在 Compose 中建構自動調整式版面配置的操作指南,請參閱「使用 Jetpack Compose 建構自動調整式應用程式」程式碼實驗室。如果您要遷移使用檢視畫面的應用程式,請參閱「Compose 採用策略」。

時間軸

  • Android 16 (2025):如果應用程式指定目標 API 級別 36,則必須支援所有螢幕方向和顯示比例,以及應用程式大小調整功能,才能在大螢幕裝置 (最小螢幕寬度 >= 600dp) 上提供基本體驗。不過,開發人員可以選擇不採用。
目標 API 級別 適用裝置 允許開發人員選擇不採用
36 (Android 16) 大螢幕裝置 (最小螢幕寬度 >= 600dp) 是

指定特定 API 級別的期限因應用程式商店而異。自 2026 年 8 月起,Google Play 將要求應用程式指定 API 級別 36。

其他資源