Thiết lập chế độ hiển thị tràn viền

Để cho phép ứng dụng của bạn toàn quyền kiểm soát vị trí vẽ nội dung, hãy làm theo các bước thiết lập sau. Nếu không thực hiện các bước này, ứng dụng của bạn có thể vẽ màu đen hoặc màu đơn sắc phía sau giao diện người dùng hệ thống hoặc không tạo hiệu ứng động đồng bộ với bàn phím phần mềm.

  1. Nhắm đến Android 15 (API cấp 35) trở lên để thực thi chế độ hiển thị tràn viền trên Android 15 trở lên. Ứng dụng của bạn hiển thị phía sau giao diện người dùng hệ thống. Bạn có thể điều chỉnh giao diện người dùng của ứng dụng bằng cách xử lý phần lồng ghép.
  2. Bạn có thể gọi enableEdgeToEdge() trong Activity.onCreate(). Thao tác này cho phép ứng dụng của bạn hiển thị tràn viền trên các phiên bản Android trước.
  3. Đặt android:windowSoftInputMode="adjustResize" trong mục AndroidManifest.xml của Hoạt động. Chế độ cài đặt này cho phép ứng dụng của bạn nhận kích thước của IME phần mềm dưới dạng phần lồng ghép, giúp bạn áp dụng bố cục và khoảng đệm thích hợp khi IME xuất hiện và biến mất trong ứng dụng.

    <!-- 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. Xử lý phần lồng ghép để giao diện người dùng quan trọng của bạn không chồng lên thanh hệ thống hoặc vết cắt trên màn hình. Bạn có thể xử lý phần lồng ghép bằng thước, các đối tượng sửa đổi khoảng đệm hoặc các đối tượng sửa đổi kích thước phần lồng ghép. Một số Thành phần Material tự động xử lý phần lồng ghép hoặc có các tham số để hỗ trợ việc xử lý phần lồng ghép như tham số PaddingValues của Scaffold. Chọn một phương pháp xử lý phần lồng ghép. Ví dụ: hãy dùng Scaffold, Modifier.safeDrawingPadding() hoặc Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current) vì những phương pháp này thường có thể thay thế cho nhau.