如要允許應用程式完全控管內容的繪製位置,請按照下列設定步驟操作。如果沒有這些步驟,應用程式可能會在系統 UI 後方繪製黑色或實心顏色,或無法與軟體鍵盤同步動畫。
- 指定 Android 15 (API 級別 35) 以上版本為目標,即可在 Android 15 以上版本強制執行無邊框模式。應用程式顯示在系統 UI 後方。您可以處理插邊,調整應用程式的 UI。
- (選用) 在
Activity.onCreate()中呼叫enableEdgeToEdge(),讓應用程式在舊版 Android 上無邊框顯示。 在活動的
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">處理插邊,避免重要 UI 與系統資訊列或螢幕凹口重疊。您可以使用尺規、邊框間距修飾符或插邊大小修飾符處理插邊。 部分 Material 元件會自動處理插邊,或提供參數來協助處理插邊,例如
Scaffold的PaddingValues參數。選擇其中一種插邊處理方式。舉例來說,您可以使用Scaffold、Modifier.safeDrawingPadding()或Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current),因為這些方法通常可以互換。