Trang này được dịch bởi Cloud Translation API.

Thay đổi về hành vi: Ứng dụng nhắm đến Android 15 trở lên

Giống như các bản phát hành trước, Android 15 có các thay đổi về hành vi có thể ảnh hưởng đến ứng dụng của bạn. Những thay đổi về hành vi sau đây chỉ áp dụng cho ứng dụng nhắm đến Android 15 trở lên. Nếu ứng dụng của bạn nhắm đến Android 15 trở lên, bạn nên sửa đổi ứng dụng để hỗ trợ những hành vi này cho phù hợp (nếu cần).

Ngoài ra, hãy nhớ tham khảo danh sách thay đổi về hành vi ảnh hưởng đến tất cả ứng dụng chạy trên Android 15 bất kể targetSdkVersion của ứng dụng.

Chức năng cốt lõi

Android 15 sửa đổi hoặc mở rộng nhiều tính năng cốt lõi của hệ thống Android.

Các thay đổi đối với các dịch vụ trên nền trước

Chúng tôi sẽ thực hiện những thay đổi sau đây đối với các dịch vụ trên nền trước trong Android 15.

Loại dịch vụ mới trên nền trước để xử lý nội dung nghe nhìn
Quy định hạn chế đối với broadcast receiver BOOT_COMPLETED khởi chạy dịch vụ trên nền trước

Hành vi hết thời gian chờ của dịch vụ trên nền trước đồng bộ hoá dữ liệu

Android 15 ra mắt hành vi hết thời gian chờ mới cho dataSync đối với ứng dụng nhắm đến Android 15 trở lên. Hành vi này cũng áp dụng với loại dịch vụ trên nền trước mediaProcessing mới.

Hệ thống cho phép các dịch vụ dataSync của ứng dụng chạy tổng cộng 6 giờ trong khoảng thời gian 24 giờ, sau đó, hệ thống sẽ gọi phương thức Service.onTimeout(int, int) của dịch vụ đang chạy (ra mắt trong Android 15). Hiện tại, dịch vụ có vài giây để gọi Service.stopSelf(). Khi Service.onTimeout() được gọi, dịch vụ này không còn được coi là dịch vụ trên nền trước. Nếu dịch vụ không gọi Service.stopSelf(), lỗi sẽ xảy ra với thông báo lỗi sau: "Dịch vụ trên nền trước của <fgs_type> không dừng trong thời gian chờ: <component_name>". Ở Phiên bản Beta 2, thông báo lỗi sẽ hiển thị dưới dạng lỗi ANR, nhưng trong bản phát hành Beta trong tương lai, thông báo lỗi này sẽ gửi một trường hợp ngoại lệ tuỳ chỉnh.

Để tránh các sự cố với thay đổi hành vi này, bạn có thể làm theo một hoặc nhiều cách sau:

Yêu cầu dịch vụ của bạn triển khai phương thức Service.onTimeout(int, int) mới. Khi ứng dụng của bạn nhận được lệnh gọi lại, hãy nhớ gọi stopSelf() trong vòng vài giây. (Nếu bạn không dừng ứng dụng ngay lập tức, hệ thống sẽ tạo ra lỗi.)
Đảm bảo các dịch vụ dataSync của ứng dụng không chạy quá tổng 6 giờ trong khoảng thời gian 24 giờ bất kỳ (trừ phi người dùng tương tác với ứng dụng, đặt lại bộ tính giờ).
Chỉ bắt đầu các dịch vụ trên nền trước dataSync do hoạt động tương tác trực tiếp của người dùng; vì ứng dụng của bạn chạy ở nền trước khi dịch vụ bắt đầu, nên dịch vụ của bạn sẽ có toàn bộ 6 giờ kể từ khi ứng dụng chuyển sang chạy ở chế độ nền.
Thay vì dùng dịch vụ trên nền trước dataSync, hãy dùng API thay thế.

Nếu các dịch vụ trên nền trước dataSync của ứng dụng đã chạy được 6 giờ trong 24 giờ qua, thì bạn không thể bắt đầu một dịch vụ dataSync trên nền trước khác trừ phi người dùng đã đưa ứng dụng của bạn lên nền trước (đặt lại bộ tính giờ). Nếu bạn cố gắng bắt đầu một dịch vụ trên nền trước dataSync khác, hệ thống sẽ gửi ForegroundServiceStartNotAllowedException kèm theo một thông báo lỗi như "Thời hạn đã hết thời gian cho loại dịch vụ trên nền trước dataSync".

Loại dịch vụ trên nền trước mới cho tính năng xử lý nội dung đa phương tiện

Android 15 ra mắt một loại dịch vụ trên nền trước mới là mediaProcessing. Loại dịch vụ này thích hợp cho các thao tác như chuyển mã tệp nội dung nghe nhìn. Ví dụ: một ứng dụng đa phương tiện có thể tải một tệp âm thanh xuống và cần chuyển đổi tệp đó sang một định dạng khác trước khi phát tệp đó. Bạn có thể sử dụng dịch vụ mediaProcessing trên nền trước để đảm bảo quá trình chuyển đổi vẫn tiếp tục ngay cả khi ứng dụng chạy ở chế độ nền.

Hệ thống cho phép các dịch vụ mediaProcessing của một ứng dụng chạy tổng cộng 6 giờ trong khoảng thời gian 24 giờ, sau đó, hệ thống sẽ gọi phương thức Service.onTimeout(int, int) của dịch vụ đang chạy (ra mắt trong Android 15). Hiện tại, dịch vụ có vài giây để gọi Service.stopSelf(). Nếu dịch vụ không gọi Service.stopSelf(), thì lỗi sẽ xảy ra với thông báo lỗi sau: "Dịch vụ trên nền trước của <fgs_type> không dừng lại trong thời gian chờ: <component_name>". Ở Phiên bản Beta 2, thông báo lỗi sẽ hiển thị dưới dạng lỗi ANR, nhưng trong bản phát hành Beta trong tương lai, thông báo lỗi này sẽ gửi một trường hợp ngoại lệ tuỳ chỉnh.

Để tránh gặp lỗi ANR, bạn có thể làm theo một trong những cách sau:

Yêu cầu dịch vụ của bạn triển khai phương thức Service.onTimeout(int, int) mới. Khi ứng dụng của bạn nhận được lệnh gọi lại, hãy nhớ gọi stopSelf() trong vòng vài giây. (Nếu bạn không dừng ứng dụng ngay lập tức, hệ thống sẽ tạo ra lỗi.)
Đảm bảo các dịch vụ mediaProcessing của ứng dụng chỉ chạy tổng cộng 6 giờ trong khoảng thời gian 24 giờ bất kỳ (trừ phi người dùng tương tác với ứng dụng, đặt lại bộ tính giờ).
Chỉ bắt đầu các dịch vụ trên nền trước mediaProcessing do hoạt động tương tác trực tiếp của người dùng; vì ứng dụng của bạn chạy ở nền trước khi dịch vụ bắt đầu, nên dịch vụ của bạn sẽ có toàn bộ 6 giờ kể từ khi ứng dụng chuyển sang chạy ở chế độ nền.
Thay vì dùng dịch vụ trên nền trước mediaProcessing, hãy dùng một API thay thế, chẳng hạn như WorkManager.

Nếu các dịch vụ trên nền trước mediaProcessing của ứng dụng đã chạy được 6 giờ trong 24 giờ qua, thì bạn sẽ không thể bắt đầu một dịch vụ mediaProcessing trên nền trước khác trừ phi người dùng đã đưa ứng dụng của bạn lên nền trước (đặt lại bộ tính giờ). Nếu bạn cố bắt đầu một mediaProcessing dịch vụ trên nền trước khác, hệ thống sẽ gửi ForegroundServiceStartNotAllowedException kèm theo một thông báo lỗi như "Time limit already for for background service type mediaprocessing".

Để biết thêm thông tin về loại dịch vụ mediaProcessing, hãy xem bài viết Các thay đổi đối với loại dịch vụ trên nền trước cho Android 15: Xử lý nội dung nghe nhìn.

Quy định hạn chế đối với broadcast receiver `BOOT_COMPLETED` đang chạy các dịch vụ trên nền trước

Có những hạn chế mới đối với broadcast receiver BOOT_COMPLETED chạy các dịch vụ trên nền trước. Bộ thu BOOT_COMPLETED không được phép chạy các loại dịch vụ trên nền trước sau đây:

dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone (chúng tôi đã áp dụng quy định hạn chế này cho microphone kể từ Android 14)

Nếu receiver BOOT_COMPLETED cố gắng chạy bất kỳ loại dịch vụ nào trên nền trước trong số đó, thì hệ thống sẽ gửi ForegroundServiceStartNotAllowedException.

Hạn chế việc bắt đầu các dịch vụ trên nền trước trong khi một ứng dụng có quyền `SYSTEM_ALERT_WINDOW`

Trước đây, nếu một ứng dụng có quyền SYSTEM_ALERT_WINDOW, thì ứng dụng đó có thể chạy một dịch vụ trên nền trước ngay cả khi ứng dụng đó đang chạy ở chế độ nền (như đã thảo luận trong phần miễn trừ khỏi các hạn chế khi khởi động ở chế độ nền).

Nếu một ứng dụng nhắm đến Android 15 thì quy định miễn trừ này nay đã hẹp hơn. Ứng dụng hiện cần có quyền SYSTEM_ALERT_WINDOW và cũng có một cửa sổ lớp phủ hiển thị. Điều này nghĩa là ứng dụng cần chạy cửa sổ TYPE_APPLICATION_OVERLAY trước tiên và cửa sổ cần hiển thị trước khi bạn bắt đầu dịch vụ trên nền trước.

Nếu ứng dụng của bạn cố gắng bắt đầu một dịch vụ trên nền trước từ chế độ nền mà không đáp ứng các yêu cầu mới này (và không có một số trường hợp miễn trừ khác), thì hệ thống sẽ gửi ForegroundServiceStartNotAllowedException.

Nếu ứng dụng của bạn khai báo quyền SYSTEM_ALERT_WINDOW và chạy các dịch vụ trên nền trước từ chế độ nền, thì thay đổi này có thể ảnh hưởng đến ứng dụng của bạn. Nếu ứng dụng của bạn nhận được ForegroundServiceStartNotAllowedException, hãy kiểm tra thứ tự hoạt động của ứng dụng và đảm bảo rằng ứng dụng đã có cửa sổ lớp phủ đang hoạt động trước khi cố gắng bắt đầu dịch vụ trên nền trước từ chế độ nền. Bạn có thể kiểm tra xem cửa sổ lớp phủ hiện có hiển thị hay không bằng cách gọi View.getWindowVisibility() hoặc bạn có thể ghi đè View.onWindowVisibilityChanged() để nhận thông báo bất cứ khi nào chế độ hiển thị thay đổi.

Các thay đổi về thời điểm ứng dụng có thể sửa đổi trạng thái chung của chế độ Không làm phiền

Các ứng dụng nhắm đến Android 15 không thể thay đổi trạng thái chung hoặc chính sách của chế độ Không làm phiền (DND) trên thiết bị nữa (bằng cách sửa đổi chế độ cài đặt của người dùng hoặc tắt chế độ Không làm phiền). Thay vào đó, các ứng dụng phải đóng góp một AutomaticZenRule. Hệ thống sẽ kết hợp mô hình này thành một chính sách toàn cầu với cơ chế tối đa hoá chính sách cùng thắng hiện tại. Các lệnh gọi đến các API hiện có từng ảnh hưởng đến trạng thái chung (setInterruptionFilter, setNotificationPolicy) sẽ dẫn đến việc tạo hoặc cập nhật AutomaticZenRule ngầm ẩn, được bật/tắt tuỳ thuộc vào chu kỳ gọi của các lệnh gọi API đó.

Lưu ý rằng thay đổi này chỉ ảnh hưởng đến hành vi có thể quan sát được nếu ứng dụng đang gọi setInterruptionFilter(INTERRUPTION_FILTER_ALL) và dự kiến lệnh gọi đó sẽ huỷ kích hoạt một AutomaticZenRule mà trước đó chủ sở hữu đã kích hoạt.

Các thay đổi OpenJDK 17

Android 15 tiếp tục công cuộc làm mới các thư viện cốt lõi của Android để phù hợp với các tính năng trong bản phát hành LTS OpenJDK mới nhất.

Một trong những thay đổi sau có thể ảnh hưởng đến khả năng tương thích của ứng dụng đối với các ứng dụng nhắm đến Android 15:

Thay đổi đối với API định dạng chuỗi: Việc xác thực chỉ mục đối số, cờ, chiều rộng và độ chính xác hiện đã nghiêm ngặt hơn khi sử dụng các API String.format() và Formatter.format() sau:
Ví dụ: trường hợp ngoại lệ sau đây được gửi khi sử dụng chỉ mục đối số là 0 (%0 trong chuỗi định dạng):
```
IllegalFormatArgumentIndexException: Illegal format argument index = 0
```
Trong trường hợp này, bạn có thể khắc phục vấn đề bằng cách sử dụng chỉ mục đối số là 1 (%1 trong chuỗi định dạng).
Các thay đổi đối với loại thành phần của Arrays.asList(...).toArray(): Khi sử dụng Arrays.asList(...).toArray(), loại thành phần của mảng thu được hiện là Object – chứ không phải loại phần tử của mảng cơ bản. Vì vậy, mã sau đây sẽ gửi ClassCastException:
```
String[] elements = (String[]) Arrays.asList("one", "two").toArray();
```
Trong trường hợp này, để duy trì String làm loại thành phần trong mảng thu được, bạn có thể sử dụng Collection.toArray(Object[]):
```
String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
```
Thay đổi về cách xử lý mã ngôn ngữ: Khi sử dụng API Locale, mã ngôn ngữ cho tiếng Do Thái, tiếng Yiddish và tiếng Indonesia không còn được chuyển đổi sang dạng lỗi thời (tiếng Do Thái: iw, tiếng Yiddish: ji và tiếng Indonesia: in). Khi chỉ định mã ngôn ngữ cho một trong các ngôn ngữ này, hãy dùng mã theo ISO 639-1 (tiếng Do Thái: he, tiếng Yiddish: {10/ tiếng Indonesia} và tiếng Indonesia: yi}.id
Thay đổi đối với chuỗi số nguyên ngẫu nhiên: Sau những thay đổi được thực hiện trong https://bugs.openjdk.org/browse/JDK-8301574, các phương thức Random.ints() sau đây hiện trả về một chuỗi số khác với các phương thức Random.nextInt():
Nhìn chung, thay đổi này sẽ không dẫn đến hành vi gây lỗi ứng dụng, nhưng mã nguồn của bạn sẽ không trông đợi trình tự được tạo từ các phương thức Random.ints() khớp với Random.nextInt().

Bảo mật

Android 15 có những thay đổi thúc đẩy khả năng bảo mật hệ thống để giúp bảo vệ ứng dụng và người dùng khỏi ứng dụng độc hại.

Khởi chạy hoạt động được bảo mật ở chế độ nền

Android 15 bảo vệ người dùng khỏi ứng dụng độc hại và cho phép họ kiểm soát thiết bị tốt hơn bằng cách bổ sung các thay đổi giúp ngăn ứng dụng nền độc hại đưa ứng dụng khác lên nền trước, nâng cao đặc quyền và lợi dụng hoạt động tương tác của người dùng. Các hoạt động chạy ở chế độ nền bị hạn chế kể từ Android 10 (API cấp 29).

Chặn các ứng dụng không khớp với UID trên cùng trong ngăn xếp khởi chạy các hoạt động

Ứng dụng độc hại có thể chạy hoạt động của một ứng dụng khác trong cùng một nhiệm vụ, sau đó tự phủ lên trên, tạo ảo giác là ứng dụng đó. Cuộc tấn công "xâm nhập nhiệm vụ" này né tránh các hạn chế hiện tại về việc chạy ở chế độ nền vì tất cả đều diễn ra trong cùng một nhiệm vụ hiển thị. Để giảm thiểu rủi ro này, Android 15 thêm một cờ sẽ chặn các ứng dụng không khớp với UID trên cùng trong ngăn xếp khởi chạy các hoạt động. Để chọn tham gia tất cả hoạt động của ứng dụng, hãy cập nhật thuộc tính allowCrossUidActivitySwitchFromBelow trong tệp AndroidManifest.xml của ứng dụng:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

Các biện pháp bảo mật mới có hiệu lực nếu tất cả các điều kiện sau đây đều được áp dụng:

Ứng dụng thực hiện hoạt động phát hành nhắm đến Android 15.
Ứng dụng ở đầu ngăn xếp tác vụ nhắm đến Android 15.
Mọi hoạt động hiển thị đều đã chọn sử dụng các biện pháp bảo vệ mới

Nếu các biện pháp bảo mật được bật, thì các ứng dụng có thể trở về màn hình chính thay vì ứng dụng hiển thị gần đây nhất nếu các ứng dụng đó hoàn thành nhiệm vụ của riêng mình.

Các thay đổi khác

Ngoài các quy định hạn chế về việc so khớp UID, những thay đổi khác sau đây cũng bao gồm:

Thay đổi nhà sáng tạo PendingIntent để chặn hoạt động chạy trong nền theo mặc định. Điều này giúp ngăn các ứng dụng vô tình tạo một PendingIntent có thể bị đối tượng ác ý lợi dụng.
Không đưa ứng dụng lên nền trước trừ phi người gửi PendingIntent cho phép. Thay đổi này nhằm ngăn các ứng dụng độc hại lợi dụng khả năng bắt đầu hoạt động ở chế độ nền. Theo mặc định, các ứng dụng không được phép đưa ngăn xếp tác vụ lên nền trước, trừ phi nhà sáng tạo cho phép đặc quyền khởi chạy hoạt động ở chế độ nền hoặc người gửi có đặc quyền khởi chạy hoạt động ở chế độ nền.
Kiểm soát cách hoạt động trên cùng của ngăn xếp tác vụ có thể hoàn thành tác vụ của nó. Nếu hoạt động trên cùng hoàn thành một tác vụ, Android sẽ quay lại tác vụ hoạt động gần đây nhất. Hơn nữa, nếu một hoạt động không ở trên cùng hoàn tất tác vụ, Android sẽ quay lại màn hình chính; nó sẽ không chặn việc kết thúc hoạt động không ở trên cùng này.
Ngăn việc khởi chạy các hoạt động tuỳ ý từ các ứng dụng khác vào tác vụ của riêng bạn. Thay đổi này ngăn các ứng dụng độc hại lừa đảo người dùng bằng cách tạo ra các hoạt động có vẻ như của các ứng dụng khác.
Chặn các cửa sổ không hiển thị được xem xét việc khởi chạy hoạt động ở chế độ nền. Điều này giúp ngăn các ứng dụng độc hại lợi dụng các lần khởi chạy hoạt động trong nền để hiển thị nội dung không mong muốn hoặc độc hại cho người dùng.

Ý định an toàn hơn

Android 15 giới thiệu các biện pháp bảo mật mới để giúp ý định trở nên an toàn và mạnh mẽ hơn. Những thay đổi này nhằm ngăn chặn các lỗ hổng bảo mật tiềm ẩn và hành vi sử dụng sai ý định có thể bị các ứng dụng độc hại khai thác. Có 2 điểm cải tiến chính về tính bảo mật của ý định trong Android 15:

Khớp với bộ lọc ý định mục tiêu:Những ý định nhắm đến các thành phần cụ thể phải khớp chính xác với thông số kỹ thuật bộ lọc ý định của mục tiêu. Nếu bạn gửi ý định chạy hoạt động của một ứng dụng khác, thì thành phần ý định mục tiêu cần phải phù hợp với bộ lọc ý định đã khai báo của hoạt động nhận.
Ý định phải có thao tác: Những ý định không có thao tác sẽ không khớp với bất kỳ bộ lọc ý định nào. Điều này có nghĩa là ý định dùng để bắt đầu hoạt động hoặc dịch vụ phải có hành động được xác định rõ ràng.

Kotlin


fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

Java


public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

Trải nghiệm người dùng và giao diện người dùng hệ thống

Android 15 có một số thay đổi nhằm mang lại trải nghiệm nhất quán và trực quan hơn cho người dùng.

Các thay đổi về phần lồng ghép cửa sổ

Có 2 thay đổi liên quan đến các phần lồng ghép cửa sổ trong Android 15: tính năng cạnh này được thực thi theo mặc định và cũng có các thay đổi về cấu hình, chẳng hạn như cấu hình mặc định của thanh hệ thống.

Thực thi toàn diện

Theo mặc định, các ứng dụng sẽ tràn viền trên các thiết bị chạy Android 15 nếu ứng dụng đó nhắm đến Android 15.

Một ứng dụng nhắm đến Android 14 và không tràn viền trên thiết bị Android 15.

Một ứng dụng nhắm đến Android 15 và tràn viền trên thiết bị Android 15. Ứng dụng này chủ yếu sử dụng Thành phần Compose Material 3 có chức năng tự động áp dụng các phần lồng ghép. Màn hình này không chịu ảnh hưởng tiêu cực của tính năng thực thi tràn viền của Android 15.

Đây là một thay đổi có thể gây lỗi có thể ảnh hưởng tiêu cực đến giao diện người dùng của ứng dụng. Những thay đổi này ảnh hưởng đến các khu vực giao diện người dùng sau:

Thanh điều hướng bằng cử chỉ
- Trong suốt theo mặc định.
- Độ lệch dưới cùng bị tắt nên nội dung sẽ vẽ phía sau thanh điều hướng hệ thống trừ phi áp dụng các phần lồng ghép.
- setNavigationBarColor và R.attr#navigationBarColor không được dùng nữa và không ảnh hưởng đến thao tác bằng cử chỉ.
- setNavigationBarContrastEnforced và R.attr#navigationBarContrastEnforced tiếp tục không ảnh hưởng đến thao tác bằng cử chỉ.
Thao tác bằng 3 nút
- Theo mặc định, độ mờ được đặt thành 80%, với màu có thể khớp với nền cửa sổ.
- Tắt tính năng bù trừ dưới cùng để nội dung vẽ phía sau thanh điều hướng hệ thống trừ phi áp dụng các phần lồng ghép.
- Theo mặc định, setNavigationBarColor và R.attr#navigationBarColor được thiết lập để khớp với nền của cửa sổ. Nền cửa sổ phải là một màu có thể vẽ để áp dụng chế độ mặc định này. API này không được dùng nữa nhưng vẫn tiếp tục ảnh hưởng đến thao tác bằng 3 nút.
- setNavigationBarContrastEnforced và R.attr#navigationBarContrastEnforced có giá trị true theo mặc định, giúp thêm 80% nền mờ trong thao tác bằng 3 nút.
Thanh trạng thái
- Trong suốt theo mặc định.
- Độ lệch trên cùng bị tắt nên nội dung sẽ vẽ phía sau thanh trạng thái trừ phi áp dụng phần lồng ghép.
- setStatusBarColor và R.attr#statusBarColor không được dùng nữa và không có hiệu lực trên Android 15.
- setStatusBarContrastEnforced và R.attr#statusBarContrastEnforced không được dùng nữa nhưng vẫn có hiệu ứng trên Android 15.
Vết cắt trên màn hình
- layoutInDisplayCutoutMode của cửa sổ không nổi phải là LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. SHORT_EDGES, NEVER và DEFAULT được diễn giải là ALWAYS để người dùng không thấy Thanh màu đen do vết cắt trên màn hình gây ra và hiển thị tràn viền.

Ví dụ sau đây cho thấy một ứng dụng trước và sau khi nhắm đến Android 15, cũng như trước và sau khi áp dụng phần lồng ghép.

Một ứng dụng nhắm đến Android 15 và tràn viền trên thiết bị chạy Android 15. Tuy nhiên, nhiều phần tử hiện bị che khuất bởi thanh trạng thái, thanh điều hướng 3 nút hoặc vết cắt trên màn hình do các biện pháp thực thi tràn viền của Android 15. Giao diện người dùng bị che khuất bao gồm thanh ứng dụng trên cùng của Material 2, các nút hành động nổi và các mục trong danh sách.

Một ứng dụng nhắm đến Android 15, xuất hiện nhiều cạnh trên một thiết bị Android 15 và áp dụng các phần lồng ghép để giao diện người dùng không bị che khuất.

Những điều cần kiểm tra xem ứng dụng của bạn đã tràn viền hay chưa

Nếu ứng dụng của bạn đã tràn viền và áp dụng các phần lồng ghép, thì hầu như bạn sẽ không bị ảnh hưởng, ngoại trừ các trường hợp sau. Tuy nhiên, ngay cả khi cho rằng mình không bị ảnh hưởng, bạn vẫn nên kiểm thử ứng dụng.

Bạn có một cửa sổ không nổi, chẳng hạn như Activity sử dụng SHORT_EDGES, NEVER hoặc DEFAULT thay vì LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. Nếu ứng dụng của bạn gặp sự cố khi khởi chạy, thì nguyên nhân có thể là do màn hình chờ. Bạn có thể nâng cấp phần phụ thuộc màn hình chờ chính lên 1.2.0-alpha01 trở lên hoặc đặt window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
Có thể có những màn hình có lưu lượng truy cập thấp hơn với giao diện người dùng bị che khuất. Xác minh rằng những màn hình ít truy cập hơn này không có giao diện người dùng bị che. Màn hình có lưu lượng truy cập thấp hơn bao gồm:
- Màn hình giới thiệu hoặc màn hình đăng nhập
- Trang cài đặt

Những điều cần kiểm tra nếu ứng dụng của bạn chưa hiển thị tràn viền

Nếu ứng dụng của bạn chưa tràn viền, thì rất có thể bạn sẽ bị ảnh hưởng. Ngoài các trường hợp đối với các ứng dụng hiển thị cạnh nhau, bạn nên cân nhắc những điều sau:

Nếu ứng dụng của bạn dùng Thành phần Material 3 (androidx.compose.material3) trong Compose, chẳng hạn như TopAppBar, BottomAppBar và NavigationBar, thì các thành phần này có thể không bị ảnh hưởng vì chúng tự động xử lý các phần lồng ghép.
Nếu ứng dụng của bạn đang dùng Thành phần Material 2 (androidx.compose.material) trong Compose, thì các thành phần này sẽ không tự động xử lý các phần lồng ghép. Tuy nhiên, bạn có thể truy cập vào các phần lồng ghép và áp dụng theo cách thủ công. Trong androidx.compose.material 1.6.0 trở lên, hãy dùng tham số windowInsets để áp dụng các phần lồng ghép theo cách thủ công cho BottomAppBar, TopAppBar, BottomNavigation và NavigationRail. Tương tự, hãy sử dụng tham số contentWindowInsets cho Scaffold.
Nếu ứng dụng của bạn dùng khung hiển thị và Thành phần Material (com.google.android.material), thì hầu hết Thành phần Material dựa trên khung hiển thị (chẳng hạn như BottomNavigationView, BottomAppBar, NavigationRailView hoặc NavigationView) sẽ xử lý các phần lồng ghép và không cần làm gì thêm. Tuy nhiên, bạn cần thêm android:fitsSystemWindows="true" nếu sử dụng AppBarLayout.
Đối với thành phần kết hợp tuỳ chỉnh, hãy áp dụng các phần lồng ghép làm khoảng đệm theo cách thủ công. Nếu nội dung của bạn nằm trong Scaffold, bạn có thể sử dụng các phần lồng ghép bằng cách sử dụng giá trị khoảng đệm Scaffold. Nếu không, hãy áp dụng khoảng đệm bằng một trong các WindowInsets.
Nếu ứng dụng của bạn đang dùng thành phần hiển thị và BottomSheet, SideSheet hoặc vùng chứa tuỳ chỉnh, hãy áp dụng khoảng đệm bằng cách sử dụng ViewCompat.setOnApplyWindowInsetsListener. Đối với RecyclerView, hãy áp dụng khoảng đệm bằng trình nghe này và thêm clipToPadding="false".

Những điều cần kiểm tra xem ứng dụng của bạn có bắt buộc phải cung cấp tính năng bảo vệ nền tuỳ chỉnh hay không

Nếu phải cung cấp chế độ bảo vệ tuỳ chỉnh ở chế độ nền cho thao tác bằng 3 nút hoặc thanh trạng thái, thì bạn nên đặt một thành phần kết hợp hoặc khung hiển thị phía sau thanh hệ thống bằng cách sử dụng WindowInsets.Type#tappableElement() để lấy chiều cao của thanh điều hướng bằng 3 nút hoặc WindowInsets.Type#statusBars.

Các tài nguyên toàn diện bổ sung

Hãy xem hướng dẫn về Khung hiển thị Edge to Edge và Edge to Edge Compose để cân nhắc thêm về việc áp dụng các phần lồng ghép.

API không dùng nữa

Các API sau đây hiện không còn được dùng nữa:

Cấu hình ổn định

Nếu ứng dụng của bạn nhắm đến Android 15 trở lên, thì Configuration sẽ không còn loại trừ các thanh hệ thống nữa. Nếu sử dụng kích thước màn hình trong lớp Configuration để tính toán bố cục, bạn nên thay thế bằng các giải pháp thay thế tốt hơn như ViewGroup, WindowInsets hoặc WindowMetricsCalculator phù hợp tuỳ theo nhu cầu của bạn.

Configuration được cung cấp kể từ API 1. Giá trị này thường được lấy từ Activity.onConfigurationChanged. Thành phần này cung cấp các thông tin như mật độ, hướng và kích thước cửa sổ. Một đặc điểm quan trọng về kích thước cửa sổ được trả về từ Configuration là trước đây, kích thước này đã loại trừ các thanh hệ thống.

Kích thước cấu hình thường được dùng để lựa chọn tài nguyên, chẳng hạn như /res/layout-h500dp và đây vẫn là một trường hợp sử dụng hợp lệ. Tuy nhiên, bạn không nên sử dụng bố cục này để tính toán bố cục. Nếu làm vậy, bạn nên ngừng sử dụng ngay bây giờ. Bạn nên thay thế việc sử dụng Configuration bằng một công cụ nào đó phù hợp hơn tuỳ thuộc vào trường hợp sử dụng của bạn.

Nếu bạn dùng đối tượng này để tính toán bố cục, hãy sử dụng ViewGroup thích hợp, chẳng hạn như CoordinatorLayout hoặc ConstraintLayout. Nếu bạn sử dụng thuộc tính này để xác định chiều cao của thanh điều hướng hệ thống, hãy sử dụng WindowInsets. Nếu bạn muốn biết kích thước hiện tại của cửa sổ ứng dụng, hãy sử dụng computeCurrentWindowMetrics.

Danh sách sau đây mô tả các trường chịu ảnh hưởng của thay đổi này:

Kích thước Configuration.screenWidthDp và screenHeightDp không còn loại trừ thanh hệ thống nữa.
Configuration.smallestScreenWidthDp chịu ảnh hưởng gián tiếp của các thay đổi đối với screenWidthDp và screenHeightDp.
Configuration.orientation chịu ảnh hưởng gián tiếp của các thay đổi đối với screenWidthDp và screenHeightDp trên các thiết bị gần vuông.
Display.getSize(Point) chịu ảnh hưởng gián tiếp của những thay đổi trong Configuration. Tính năng này không được dùng nữa kể từ API cấp 30.
Display.getMetrics() đã hoạt động như thế này kể từ API cấp 33.

Thuộc tính paymentsTextHeight mặc định là true

Đối với các ứng dụng nhắm đến Android 15, thuộc tính elegantTextHeight TextView sẽ trở thành true theo mặc định, thay thế phông chữ nhỏ gọn được sử dụng theo mặc định bằng một số tập lệnh có chỉ số dọc lớn bằng một tập lệnh dễ đọc hơn nhiều. Ra mắt phông chữ nhỏ gọn để ngăn bố cục làm hỏng bố cục; Android 13 (API cấp 33) ngăn chặn nhiều sự cố này bằng cách cho phép bố cục văn bản kéo dài chiều cao theo chiều dọc bằng cách sử dụng thuộc tính fallbackLineSpacing.

Trong Android 15, phông chữ thu gọn vẫn còn trong hệ thống, vì vậy, ứng dụng của bạn có thể đặt elegantTextHeight thành false để có hành vi tương tự như trước đây, nhưng có thể sẽ không được hỗ trợ trong các bản phát hành sắp tới. Vì vậy, nếu ứng dụng của bạn hỗ trợ các chữ viết sau: tiếng Ả Rập, tiếng Lào, tiếng Myanmar, tiếng Tamil, tiếng Gujarati, tiếng Kannada, tiếng Malayalam, tiếng Oriya, tiếng Telugu hoặc tiếng Thái, hãy kiểm thử ứng dụng bằng cách đặt elegantTextHeight thành true.

Hành vi `elegantTextHeight` đối với ứng dụng nhắm đến Android 14 (API cấp 34) trở xuống.

Hành vi của `elegantTextHeight` đối với ứng dụng nhắm đến Android 15.

Thay đổi chiều rộng của TextView cho các hình dạng chữ cái phức tạp

Trong các phiên bản Android trước, một số phông chữ chữ thảo hoặc ngôn ngữ có hình dạng phức tạp có thể vẽ các chữ cái trong vùng của ký tự trước đó hoặc tiếp theo. Trong một số trường hợp, các chữ cái đó bị cắt ở vị trí đầu hoặc cuối. Kể từ Android 15, TextView sẽ phân bổ chiều rộng để vẽ đủ không gian cho các chữ cái đó và cho phép ứng dụng yêu cầu khoảng đệm bổ sung ở bên trái để ngăn tình trạng cắt.

Vì thay đổi này ảnh hưởng đến cách TextView quyết định chiều rộng, nên TextView sẽ phân bổ nhiều chiều rộng hơn theo mặc định nếu ứng dụng nhắm đến Android 15 trở lên. Bạn có thể bật hoặc tắt hành vi này bằng cách gọi API setUseBoundsForWidth trên TextView.

Vì việc thêm khoảng đệm bên trái có thể gây ra tình trạng không thẳng hàng cho bố cục hiện có, nên khoảng đệm không được thêm theo mặc định, ngay cả đối với các ứng dụng nhắm đến Android 15 trở lên. Tuy nhiên, bạn có thể thêm khoảng đệm bổ sung để ngăn tình trạng cắt xén bằng cách gọi setShiftDrawingOffsetForStartOverhang.

Các ví dụ sau đây cho thấy cách những thay đổi này có thể cải thiện bố cục văn bản đối với một số phông chữ và ngôn ngữ.

Bố cục tiêu chuẩn cho văn bản tiếng Anh bằng phông chữ chữ thảo. Một số chữ cái bị cắt bớt. Sau đây là tệp XML tương ứng:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Bố cục cho cùng một văn bản tiếng Anh với chiều rộng và khoảng đệm bổ sung. Sau đây là tệp XML tương ứng:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Bố cục chuẩn cho văn bản tiếng Thái. Một số chữ cái đã bị cắt bớt. Sau đây là tệp XML tương ứng:

<TextView
    android:text="คอมพิวเตอร์" />

Bố cục cho cùng một văn bản tiếng Thái với thêm chiều rộng và khoảng đệm. Sau đây là tệp XML tương ứng:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Chiều cao dòng mặc định nhận biết ngôn ngữ cho EditText

Trong các phiên bản Android trước, bố cục văn bản đã kéo giãn chiều cao của văn bản để đáp ứng chiều cao dòng của phông chữ khớp với ngôn ngữ hiện tại. Ví dụ: nếu nội dung bằng tiếng Nhật, vì chiều cao dòng của phông chữ tiếng Nhật lớn hơn một chút so với phông chữ Latinh, nên chiều cao của văn bản sẽ lớn hơn một chút. Tuy nhiên, bất kể sự khác biệt về chiều cao dòng, phần tử EditText có kích thước đồng nhất, bất kể ngôn ngữ đang được sử dụng, như minh hoạ trong hình ảnh sau đây:

Ba hộp tượng trưng cho các phần tử `EditText` có thể chứa văn bản bằng tiếng Anh (en), tiếng Nhật (ja) và tiếng Miến Điện (my). Chiều cao của `EditText` giống nhau, mặc dù chiều cao dòng của 2 ngôn ngữ này không giống nhau.

Đối với ứng dụng nhắm mục tiêu đến Android 15, chiều cao dòng tối thiểu hiện được dành riêng cho EditText để khớp với phông chữ tham chiếu cho Ngôn ngữ được chỉ định, như trong hình sau:

Ba hộp tượng trưng cho các phần tử `EditText` có thể chứa văn bản bằng tiếng Anh (en), tiếng Nhật (ja) và tiếng Miến Điện (my). Chiều cao của `EditText` hiện đã chứa đủ không gian để chứa chiều cao dòng mặc định cho phông chữ của các ngôn ngữ này.

Nếu cần, ứng dụng của bạn có thể khôi phục hành vi trước đó bằng cách chỉ định thuộc tính useLocalePreferredLineHeightForMinimum cho false, đồng thời ứng dụng có thể đặt các chỉ số dọc tối thiểu tuỳ chỉnh bằng cách sử dụng API setMinimumFontMetrics trong Kotlin và Java.

Máy ảnh và nội dung nghe nhìn

Android 15 thực hiện những thay đổi sau đây đối với hành vi của máy ảnh và nội dung nghe nhìn đối với các ứng dụng nhắm đến Android 15 trở lên.

Quy định hạn chế về việc yêu cầu quyền phát âm thanh

Các ứng dụng nhắm đến Android 15 phải là ứng dụng hàng đầu hoặc chạy dịch vụ trên nền trước liên quan đến âm thanh để yêu cầu quyền phát âm thanh. Nếu một ứng dụng cố gắng yêu cầu tiêu điểm khi không đáp ứng một trong các yêu cầu sau, thì lệnh gọi sẽ trả về AUDIOFOCUS_REQUEST_FAILED.

Dịch vụ trên nền trước sẽ được xem là có liên quan đến âm thanh nếu kiểu dịch vụ đó là mediaPlayback, camera, microphone hoặc phoneCall.

Bạn có thể tìm hiểu thêm về quyền phát âm thanh trong bài viết Quản lý quyền phát âm thanh.

Các quy tắc hạn chế mới cập nhật đối với yếu tố ngoài SDK

Android 15 cung cấp danh sách mới cập nhật về các giao diện không phải SDK bị hạn chế dựa trên khả năng cộng tác với nhà phát triển Android và kiểm thử nội bộ mới nhất. Bất cứ khi nào có thể, chúng tôi phải đảm bảo việc cung cấp các phương án thay thế công khai trước khi hạn chế giao diện không phải SDK.

Nếu ứng dụng của bạn không nhắm đến Android 15, thì một số thay đổi này có thể sẽ không ảnh hưởng ngay. Tuy nhiên, mặc dù ứng dụng có thể truy cập một số giao diện không phải SDK tuỳ thuộc vào cấp độ API mục tiêu của ứng dụng, nhưng việc sử dụng phương thức hoặc trường không phải SDK luôn có nguy cơ cao làm hỏng ứng dụng.

Nếu không chắc ứng dụng của mình có sử dụng giao diện không phải SDK hay không, bạn có thể kiểm tra ứng dụng để tìm hiểu. Nếu ứng dụng của bạn dựa vào giao diện không phải SDK, thì bạn nên bắt đầu lập kế hoạch di chuyển sang SDK làm giải pháp thay thế. Tuy nhiên, chúng tôi hiểu rằng vẫn có một số trường hợp sử dụng hợp lệ cho việc sử dụng giao diện không phải SDK. Nếu không tìm được giải pháp thay thế việc sử dụng giao diện không phải SDK cho một tính năng trong ứng dụng, thì bạn nên yêu cầu một API công khai mới.

Để tìm hiểu thêm về những thay đổi trong bản phát hành Android này, hãy xem bài viết Thông tin cập nhật đối với những hạn chế về giao diện không phải SDK trong Android 15. Để tìm hiểu tổng quan thêm về giao diện không phải SDK, hãy xem Hạn chế đối với giao diện không phải SDK.