設定無邊框螢幕

如要允許應用程式完全控管內容的繪製位置,請按照下列設定步驟操作。如果沒有這些步驟,應用程式可能會在系統 UI 後方繪製黑色或實心顏色,或無法與軟體鍵盤同步動畫。

  1. 指定 Android 15 (API 級別 35) 以上版本為目標,即可在 Android 15 以上版本強制執行無邊框模式。應用程式顯示在系統 UI 後方。您可以處理插邊,調整應用程式的 UI。
  2. (選用) 在 Activity.onCreate() 中呼叫 enableEdgeToEdge(),讓應用程式在舊版 Android 上無邊框顯示。
  3. 在活動的 AndroidManifest.xml 項目中設定 android:windowSoftInputMode="adjustResize"。這項設定可讓應用程式將軟體輸入法編輯器的大小當做插邊接收,有助於在應用程式中顯示及隱藏輸入法編輯器時,套用適當的版面配置和邊框間距。

    <!-- In your AndroidManifest.xml file: -->
    <activity
      android:name=".ui.MainActivity"
      android:label="@string/app_name"
      android:windowSoftInputMode="adjustResize"
      android:theme="@style/Theme.MyApplication"
      android:exported="true">
    
  4. 處理插邊,避免重要 UI 與系統資訊列或螢幕凹口重疊。您可以使用尺規邊框間距修飾符插邊大小修飾符處理插邊。 部分 Material 元件會自動處理插邊,或提供參數來協助處理插邊,例如 ScaffoldPaddingValues 參數。選擇其中一種插邊處理方式。舉例來說,您可以使用 ScaffoldModifier.safeDrawingPadding()Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current),因為這些方法通常可以互換。