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 điều chỉnh ứ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 các 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 chức năng cốt lõi của hệ thống Android.
Thay đổi đối với 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.
- Hành vi hết thời gian chờ của dịch vụ đồng bộ hoá dữ liệu trên nền trước
- Loại dịch vụ trên nền trước mới để xử lý nội dung nghe nhìn
- Các hạn chế đối với bộ thu phát sóng
BOOT_COMPLETEDkhởi chạy dịch vụ trên nền trước - Các hạn chế khi khởi động dịch vụ trên nền trước trong khi ứng dụng có quyền
SYSTEM_ALERT_WINDOW
Hành vi hết thời gian chờ của dịch vụ đồng bộ hoá dữ liệu trên nền trước
对于以 Android 15（API 级别 35）或更高版本为目标平台的应用，Android 15 为 dataSync 引入了新的超时行为。此行为也适用于新的 mediaProcessing 前台服务类型。
系统允许应用的 dataSync 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，该服务有几秒钟时间来调用 Service.stopSelf()。调用 Service.onTimeout() 后，该服务将不再被视为前台服务。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"
为避免因行为变更而导致问题，您可以执行以下一项或多项操作：
- 让您的服务实现新的
Service.onTimeout(int, int)方法。当您的应用收到回调时，请务必在几秒钟内调用stopSelf()。（如果您不立即停止应用，系统会生成故障。） - 确保应用的
dataSync服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。 - 仅通过直接的用户互动来启动
dataSync前台服务；由于您的应用在服务启动时位于前台，因此服务会在应用进入后台后的 6 小时内完整运行。 - 请改用替代 API，而不是使用
dataSync前台服务。
如果您的应用的 dataSync 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 dataSync 前台服务，除非用户已将您的应用切换到前台（这会重置计时器）。如果您尝试启动其他 dataSync 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似“前台服务类型 dataSync 的时间限制已用尽”的错误消息。
测试
如需测试应用的行为，您可以启用数据同步超时功能，即使应用未以 Android 15 为目标平台也是如此（前提是应用在 Android 15 设备上运行）。如需启用超时，请运行以下 adb 命令：
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
您还可以调整超时期限，更轻松地测试应用在达到此限制时的行为。如需设置新的超时期限，请运行以下 adb 命令：
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
Loại dịch vụ trên nền trước mới để xử lý nội dung nghe nhìn
Android 15 giới thiệu một loại dịch vụ trên nền trước mới, mediaProcessing. Loại dịch vụ này phù hợp với các thao tác như chuyển mã tệp phương tiện. Ví dụ: một ứng dụng đa phương tiện có thể tải 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. Bạn có thể sử dụng dịch vụ trên nền trước mediaProcessing để đảm bảo quá trình chuyển đổi sẽ tiếp tục ngay cả khi ứng dụng đang chạy trong nền.
Hệ thống cho phép các dịch vụ mediaProcessing 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 (được giới thiệu trong Android 15). Tại thời điểm này, dịch vụ có vài giây để gọi Service.stopSelf(). Nếu dịch vụ không gọi Service.stopSelf(), hệ thống sẽ gửi một ngoại lệ nội bộ. Ngoại lệ được ghi lại trong Logcat với thông báo sau:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
Để tránh trường hợp ngoại lệ này, 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ọistopSelf()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 lỗi.) - Đảm bảo các dịch vụ
mediaProcessingcủa ứng dụng không chạy quá 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 dịch vụ trên nền trước
mediaProcessingdo người dùng tương tác trực tiếp; vì ứng dụng của bạn đang ở nền trước khi dịch vụ bắt đầu, nên dịch vụ của bạn có đủ 6 giờ sau khi ứng dụng chuyển sang 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 ngày qua, thì bạn không thể bắt đầu một dịch vụ trên nền trước mediaProcessing khác trừ phi người dùng đã đưa ứng dụng của bạn lên nền trước (việc này đặ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 mediaProcessing khác, hệ thống sẽ gửi ForegroundServiceStartNotAllowedException kèm theo thông báo lỗi như "Hết thời gian giới hạn cho loại dịch vụ trên nền trước mediaProcessing".
Để biết thêm thông tin về loại dịch vụ mediaProcessing, hãy xem phần 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.
Thử nghiệm
Để kiểm thử hành vi của ứng dụng, bạn có thể bật thời gian chờ xử lý nội dung nghe nhìn ngay cả khi ứng dụng của bạn không nhắm đến Android 15 (miễn là ứng dụng đang chạy trên thiết bị Android 15). Để bật tính năng thời gian chờ, hãy chạy lệnh adb sau:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
Bạn cũng có thể điều chỉnh khoảng thời gian chờ để dễ dàng kiểm thử cách ứng dụng của bạn hoạt động khi đạt đến giới hạn. Để đặt khoảng thời gian chờ mới, hãy chạy lệnh adb sau:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds
Các hạn chế đối với bộ nhận thông báo truyền tin BOOT_COMPLETED khởi chạy dịch vụ trên nền trước
Có hạn chế mới đối với việc khởi chạy broadcast receiver BOOT_COMPLETED
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:
dataSynccameramediaPlaybackphoneCallmediaProjectionmicrophone(hạn chế này đã được áp dụng chomicrophonekể từ Android 14)
Nếu receiver BOOT_COMPLETED cố gắng chạy bất kỳ loại nền trước nào trong số đó
thì hệ thống sẽ gửi ForegroundServiceStartNotAllowedException.
Thử nghiệm
Để kiểm thử hành vi của ứng dụng, bạn có thể bật các hạn chế mới này ngay cả khi
ứng dụng không nhắm đến Android 15 (miễn là ứng dụng đó đang chạy trên Android 15
thiết bị). Chạy lệnh adb sau:
adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name
Để gửi thông báo BOOT_COMPLETED mà không cần khởi động lại thiết bị,
chạy lệnh adb sau:
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name
Các hạn chế về việc khởi động dịch vụ trên nền trước khi ứng dụng có quyền SYSTEM_ALERT_WINDOW
Trước đây, nếu có quyền SYSTEM_ALERT_WINDOW, ứ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 các trường hợp miễn trừ khỏi các quy định hạn chế về việc bắt đầu ở chế độ nền).
Nếu một ứng dụng nhắm đến Android 15, thì trường hợp miễn trừ này hiện sẽ 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ị. Tức là trước tiên, ứng dụng cần khởi chạy cửa sổ TYPE_APPLICATION_OVERLAY 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 ngoại lệ 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ì ứng dụng đó có thể bị ảnh hưởng bởi thay đổi này. 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 ứng dụng đã có cửa sổ lớp phủ đang hoạt động trước khi ứng dụng đó cố gắng bắt đầu một 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ủ của mình 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.
Thử nghiệm
Để kiểm thử hành vi của ứng dụng, bạn có thể bật các quy định hạn chế mới này ngay cả khi ứng dụng của bạn không nhắm đến Android 15 (miễn là ứng dụng đang chạy trên thiết bị Android 15). Để bật các hạn chế mới này khi khởi động dịch vụ trên nền trước từ chế độ nền, hãy chạy lệnh adb sau:
adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name
Những thay đổi đối với thời điểm các ứ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 (API cấp 35) trở lên không thể thay đổi trạng thái hoặc chính sách chung 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ế độ DND). Thay vào đó, ứng dụng phải đóng góp một AutomaticZenRule. Hệ thống sẽ kết hợp chính sách này vào một chính sách chung với lược đồ hiện có là chính sách hạn chế nhất sẽ thắng. Các lệnh gọi đến các API hiện có từng ảnh hưởng đến trạng thái toàn cục (setInterruptionFilter, setNotificationPolicy) sẽ dẫn đến việc tạo hoặc cập nhật một AutomaticZenRule ngầm ẩn. Lệnh gọi này được bật và tắt tuỳ thuộc vào chu kỳ gọi của các lệnh gọi API đó.
Xin 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 AutomaticZenRule mà chủ sở hữu của ứng dụng đã kích hoạt trước đó.
Các thay đổi về API OpenJDK
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 số thay đổi này có thể ảnh hưởng đến khả năng tương thích của ứng dụng đối với những ứng dụng nhắm đến Android 15 (cấp độ API 35):
Các thay đổi đối với API định dạng chuỗi: Giờ đây, việc xác thực chỉ mục đối số, cờ, chiều rộng và độ chính xác sẽ nghiêm ngặt hơn khi sử dụng các API
String.format()vàFormatter.format()sau đây:String.format(String, Object[])String.format(Locale, String, Object[])Formatter.format(String, Object[])Formatter.format(Locale, String, Object[])
Ví dụ: ngoại lệ sau sẽ được gửi khi chỉ mục đối số là 0 (
%0trong chuỗi định dạng):IllegalFormatArgumentIndexException: Illegal format argument index = 0Trong 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 (
%1trong chuỗi định dạng).Thay đổi loại thành phần của
Arrays.asList(...).toArray(): Khi sử dụngArrays.asList(...).toArray(), loại thành phần của mảng kết quả hiện làObjectchứ không phải loại thành phần của mảng cơ bản. Vì vậy, mã sau đây sẽ gửi mộtClassCastException:String[] elements = (String[]) Arrays.asList("one", "two").toArray();Trong trường hợp này, để giữ
Stringlàm loại thành phần trong mảng kết quả, bạn có thể sử dụngCollection.toArray(Object[])thay thế:String[] elements = Arrays.asList("two", "one").toArray(new String[0]);Thay đổi đối với 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 sẽ không còn được chuyển đổi sang dạng lỗi thời (tiếng Do Thái:iw, tiếng Yiddish:jivà tiếng Indonesia:in). Khi chỉ định mã ngôn ngữ cho một trong các ngôn ngữ này, hãy sử dụng mã theo tiêu chuẩn ISO 639-1 (tiếng Do Thái:he, tiếng Yiddish:yivà tiếng Indonesia:id).Các thay đổi đối với chuỗi số nguyên ngẫu nhiên: Sau các 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ứcRandom.nextInt():Nhìn chung, thay đổi này sẽ không dẫn đến hành vi làm hỏng ứng dụng, nhưng mã của bạn không được mong đợi trình tự được tạo từ các phương thức
Random.ints()khớp vớiRandom.nextInt().
API SequencedCollection mới có thể ảnh hưởng đến khả năng tương thích của ứng dụng sau khi bạn cập nhật compileSdk trong cấu hình bản dựng của ứng dụng để sử dụng Android 15 (cấp độ API 35):
Xung đột với các hàm mở rộng
MutableList.removeFirst()vàMutableList.removeLast()trongkotlin-stdlibLoại
Listtrong Java được ánh xạ đến loạiMutableListtrong Kotlin. Vì các APIList.removeFirst()vàList.removeLast()đã được ra mắt trong Android 15 (cấp độ API 35), nên trình biên dịch Kotlin sẽ giải quyết các lệnh gọi hàm (ví dụ:list.removeFirst()) một cách tĩnh đến các APIListmới thay vì đến các hàm mở rộng trongkotlin-stdlib.Nếu một ứng dụng được biên dịch lại với
compileSdkđược đặt thành35vàminSdkđược đặt thành34trở xuống, rồi ứng dụng đó chạy trên Android 14 trở xuống, thì sẽ xảy ra lỗi thời gian chạy:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;Lựa chọn
NewApilint hiện có trong Trình bổ trợ Android cho Gradle có thể phát hiện những cách sử dụng API mới này../gradlew lintMainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()Để khắc phục ngoại lệ thời gian chạy và lỗi lint, bạn có thể thay thế các lệnh gọi hàm
removeFirst()vàremoveLast()bằngremoveAt(0)vàremoveAt(list.lastIndex)tương ứng trong Kotlin. Nếu bạn đang sử dụng Android Studio Ladybug | 2024.1.3 trở lên, thì phiên bản này cũng cung cấp một lựa chọn sửa lỗi nhanh cho những lỗi này.Hãy cân nhắc việc xoá
@SuppressLint("NewApi")vàlintOptions { disable 'NewApi' }nếu bạn đã tắt lựa chọn lint.Xung đột với các phương thức khác trong Java
Các phương thức mới đã được thêm vào các loại hiện có, ví dụ:
ListvàDeque. Những phương thức mới này có thể không tương thích với các phương thức có cùng tên và kiểu đối số trong các giao diện và lớp khác. Trong trường hợp xảy ra xung đột chữ ký phương thức với sự không tương thích, trình biên dịchjavacsẽ xuất ra lỗi thời gian tạo. Ví dụ:Ví dụ về lỗi 1:
javac MyList.javaMyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List public void removeLast() { ^ return type void is not compatible with Object where E is a type-variable: E extends Object declared in interface ListVí dụ về lỗi 2:
javac MyList.javaMyList.java:7: error: types Deque<Object> and List<Object> are incompatible; public class MyList implements List<Object>, Deque<Object> { both define reversed(), but with unrelated return types 1 errorVí dụ về lỗi 3:
javac MyList.javaMyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible; public static class MyList implements List<Object>, MyInterface<Object> { class MyList inherits unrelated defaults for getFirst() from types List and MyInterface where E#1,E#2 are type-variables: E#1 extends Object declared in interface List E#2 extends Object declared in interface MyInterface 1 errorĐể khắc phục những lỗi bản dựng này, lớp triển khai các giao diện này phải ghi đè phương thức bằng một kiểu dữ liệu trả về tương thích. Ví dụ:
@Override public Object getFirst() { return List.super.getFirst(); }
Bảo mật
Android 15 có những thay đổi giúp tăng cường tính bảo mật của hệ thống để bảo vệ ứng dụng và người dùng khỏi các ứng dụng độc hại.
Các phiên bản TLS bị hạn chế
Android 15 hạn chế việc sử dụng TLS phiên bản 1.0 và 1.1. Các phiên bản này trước đây đã ngừng hoạt động trong Android, nhưng hiện không được phép sử dụng cho các ứng dụng nhắm đến Android 15.
Khởi chạy hoạt động trong nền một cách an toàn
Android 15 bảo vệ người dùng khỏi các ứng dụng độc hại và giúp họ kiểm soát thiết bị của mình tốt hơn bằng cách thêm những thay đổi ngăn các ứng dụng độc hại ở chế độ nền đưa các ứ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. Hoạt động khởi chạy ở chế độ nền đã bị hạn chế kể từ Android 10 (API cấp 29).
Các thay đổi khác
- Thay đổi để theo mặc định,
PendingIntentngười tạo sẽ chặn hoạt động khởi chạy trong nền. Điều này giúp ngăn các ứng dụng vô tình tạo ra mộtPendingIntentmà đối tượng xấu có thể lợi dụng. - Không đưa ứng dụng lên nền trước, trừ phi người gửi
PendingIntentcho phép. Thay đổi này nhằm mục đích ngăn các ứng dụng độc hại lợi dụng khả năng bắt đầu các 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 người 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 hàng đầu của ngăn xếp tác vụ có thể hoàn thành tác vụ của mình. Nếu hoạt động hàng đầu hoàn tất một tác vụ, Android sẽ quay lại tác vụ hoạt động gần đây nhất. Ngoài ra, nếu một hoạt động không phải là hoạt động hàng đầu hoàn tất tác vụ của mình, thì Android sẽ quay lại màn hình chính; hệ thống sẽ không chặn quá trình hoàn tất của hoạt động không phải là hoạt động hàng đầu này.
- Ngăn chặn việc 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 các hoạt động có vẻ như đến từ các ứng dụng khác.
- Chặn các cửa sổ không hiển thị được xem xét để khởi chạy hoạt động trong nền. Điều này giúp ngăn chặn các ứng dụng độc hại lợi dụng hoạt động khởi chạy ở chế độ 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 StrictMode cho các ý định.
Để xem nhật ký chi tiết về các lỗi vi phạm khi sử dụng Intent, hãy sử dụng phương thức sau:
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 đến trải nghiệm người dùng nhất quán và trực quan hơn.
Thay đổi phần lồng ghép cửa sổ
Có hai thay đổi liên quan đến phần lồng ghép cửa sổ trong Android 15: chế độ tràn viền đượ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 các thanh hệ thống.
Thực thi chi tiết
如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。
这是一项重大变更，可能会对应用的界面产生不利影响。这些变更会影响以下界面区域：
- 手势提示条导航栏
- 默认透明。
- 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
setNavigationBarColor和R.attr#navigationBarColor已弃用，不会影响手势导航。setNavigationBarContrastEnforced和R.attr#navigationBarContrastEnforced仍不会影响手势导航。
- 三按钮导航
- 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
- 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
setNavigationBarColor和R.attr#navigationBarColor默认设置为与窗口背景颜色一致。窗口背景必须是颜色可绘制对象，才能应用此默认设置。此 API 已弃用，但仍会影响三按钮导航。setNavigationBarContrastEnforced和R.attr#navigationBarContrastEnforced默认值为 true，这会在三按钮导航中添加 80% 不透明的背景。
- 状态栏
- 默认透明。
- 顶部偏移已停用，因此除非应用了边衬区，否则内容会绘制在状态栏后面。
setStatusBarColor和R.attr#statusBarColor已弃用，不会影响 Android 15。setStatusBarContrastEnforced和R.attr#statusBarContrastEnforced已弃用，但仍会影响 Android 15。
- 刘海屏
- 非浮动窗口的
layoutInDisplayCutoutMode必须为LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。SHORT_EDGES、NEVER和DEFAULT会被解读为ALWAYS，这样用户就不会看到因显示屏刘海屏而产生的黑条，并且会以无边框显示。
- 非浮动窗口的
以下示例展示了应用在以 Android 15（API 级别 35）为目标平台之前和之后，以及在应用边衬区之前和之后的效果。此示例并不全面，在 Android Auto 上可能会显示不同的效果。
如果您的应用已以无边框显示，需要检查哪些内容
如果您的应用已以 无边框 显示并应用了边衬区，则大部分情况下 不会受到影响，但在以下情形中除外。不过，即使您认为自己不会受到影响，我们也建议您测试应用。
- 您有一个非浮动窗口，例如使用
SHORT_EDGES、NEVER或DEFAULT而不是LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS的Activity。如果您的应用在启动时崩溃，可能是因为启动画面所致。您可以将 核心 启动画面 依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。 - 可能存在流量较低的屏幕，其界面被遮盖。验证这些访问量较少的屏幕是否没有被遮盖的界面。流量较低的屏幕包括：
- 新手入门或登录屏幕
- “设置”页面
如果您的应用尚未以无边框显示，需要检查哪些内容
如果您的应用尚未以无边框显示，则很可能会受到影响。除了已以无边框显示的应用的情形之外，您还应考虑以下情况：
- 如果您的应用在 Compose 中使用了 Material 3 组件 (
androidx.compose.material3)，例如TopAppBar、BottomAppBar和NavigationBar，这些组件可能不会 受到影响，因为它们会自动处理边衬区。 - 如果应用使用的是 Compose 中的 Material 2 组件 (
androidx.compose.material)，这些组件 本身并不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用windowInsets参数可为BottomAppBar、TopAppBar、BottomNavigation和NavigationRail手动应用边衬区。 同样，对于Scaffold，请使用contentWindowInsets参数。 - 如果应用使用了视图和 Material 组件
(
com.google.android.material)，则大多数基于视图的 Material 组件（例如BottomNavigationView、BottomAppBar、NavigationRailView或NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，您需要添加android:fitsSystemWindows="true"，如果使用AppBarLayout。 - 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的
内容位于
Scaffold中，则可以使用Scaffold内边距值来使用边衬区。否则，请使用其中一个WindowInsets应用内边距。 - 如果应用使用的是视图和
BottomSheet、SideSheet或自定义 容器，请使用ViewCompat.setOnApplyWindowInsetsListener应用内边距。对于RecyclerView，请使用此监听器应用内边距，同时添加clipToPadding="false"。
如果您的应用必须提供自定义背景保护，需要检查哪些内容
如果您的应用必须为“三按钮”导航或
状态栏提供自定义背景保护，则应用应使用 WindowInsets.Type#tappableElement() 将可组合函数或视图放置在系统栏后面
，以获取“三按钮”
导航栏高度或 WindowInsets.Type#statusBars。
其他无边框资源
如需了解有关应用边衬区的其他注意事项，请参阅无边框视图和无边框 Compose 指南。
已弃用的 API
以下 API 已弃用，但未停用：
R.attr#enforceStatusBarContrastR.attr#navigationBarColor（适用于三按钮导航，alpha 为 80%）Window#isStatusBarContrastEnforcedWindow#setNavigationBarColor（适用于三按钮导航，alpha 为 80%）Window#setStatusBarContrastEnforced
以下 API 已弃用并已停用：
R.attr#navigationBarColor（适用于手势导航）R.attr#navigationBarDividerColorR.attr#statusBarColorWindow#setDecorFitsSystemWindowsWindow#getNavigationBarColorWindow#getNavigationBarDividerColorWindow#getStatusBarColorWindow#setNavigationBarColor（适用于手势导航）Window#setNavigationBarDividerColorWindow#setStatusBarColor
Cấu hình ổn định
Nếu ứng dụng của bạn nhắm đến Android 15 (API cấp 35) 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 lựa chọn thay thế tốt hơn như ViewGroup, WindowInsets hoặc WindowMetricsCalculator thích hợp tuỳ theo nhu cầu của bạn.
Configuration đã có sẵn kể từ API 1. Thông tin này thường được lấy từ Activity.onConfigurationChanged. Nền tảng này cung cấp 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 không bao gồm các thanh hệ thống.
Kích thước cấu hình thường được dùng để 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 dùng nó để tính toán bố cục. Nếu có, bạn nên di chuyển ra xa ngay bây giờ. Bạn nên thay thế việc sử dụng Configuration bằng một thành phần 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 tham số này để tính toán bố cục, hãy dùng một ViewGroup thích hợp, chẳng hạn như CoordinatorLayout hoặc ConstraintLayout. Nếu bạn dùng phương thức này để xác định chiều cao của thanh điều hướng hệ thống, hãy 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 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.screenWidthDpvàscreenHeightDpkhông còn loại trừ các thanh hệ thống nữa. Configuration.smallestScreenWidthDpchịu ảnh hưởng gián tiếp của các thay đổi đối vớiscreenWidthDpvàscreenHeightDp.Configuration.orientationchịu ảnh hưởng gián tiếp của các thay đổi đối vớiscreenWidthDpvàscreenHeightDptrên các thiết bị gần vuông.Display.getSize(Point)chịu ảnh hưởng gián tiếp của các thay đổi trongConfiguration. Thuộc tính này đã ngừng hoạt động kể từ cấp độ API 30.Display.getMetrics()đã hoạt động theo cách này kể từ cấp độ API 33.
Thuộc tính elegantTextHeight mặc định là true
Đối với các ứng dụng nhắm đến Android 15 (API cấp 35), thuộc tính elegantTextHeight TextView sẽ trở thành true theo mặc định, thay thế phông chữ thu gọn được sử dụng theo mặc định bằng một số tập lệnh có các chỉ số dọc lớn bằng một tập lệnh dễ đọc hơn nhiều.
Phông chữ nhỏ gọn được giới thiệu để ngăn các bố cục bị phá vỡ; 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 giãn 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ó cùng hành vi như trước, 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 tập lệnh 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 Odia, 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.
elegantTextHeight của 
đối với các ứng dụng nhắm đến Android 14 (API cấp 34) trở xuống.
elegantTextHeight hành vi cho các ứng dụng nhắm đến Android 15.Chiều rộng TextView thay đổi đối với 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ữ hoặc ngôn ngữ viết tay 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 sau.
Trong một số trường hợp, các chữ cái như vậy 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 để tránh bị cắt bớt.
Vì thay đổi này ảnh hưởng đến cách TextView quyết định chiều rộng, nên theo mặc định, TextView sẽ phân bổ nhiều chiều rộng hơn nếu ứng dụng nhắm đến Android 15 (API cấp 35) 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ể khiến các bố cục hiện có bị lệch, 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 chặn việc cắt bớt bằng cách gọi setShiftDrawingOffsetForStartOverhang.
Các ví dụ sau đây cho thấy những thay đổi này có thể cải thiện bố cục văn bản cho một số phông chữ và ngôn ngữ.
<TextView android:fontFamily="cursive" android:text="java" />
<TextView android:fontFamily="cursive" android:text="java" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
<TextView android:text="คอมพิวเตอร์" />
<TextView android:text="คอมพิวเตอร์" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
Chiều cao dòng mặc định theo 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, thì chiều cao dòng của phông chữ tiếng Nhật sẽ lớn hơn một chút so với chiều cao dòng của phông chữ Latinh, do đó chiều cao của văn bản sẽ lớn hơn một chút. Tuy nhiên, mặc dù có sự khác biệt về chiều cao dòng, nhưng phần tử EditText được định cỡ đồng nhất, bất kể ngôn ngữ đang được sử dụng, như minh hoạ trong hình sau:
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 là như nhau, mặc dù các ngôn ngữ này có chiều cao dòng khác nhau.Đối với các ứng dụng nhắm đến Android 15 (API cấp 35), 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ư minh hoạ trong hình sau:
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 bao gồm khoảng trống để phù hợp với 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 thành false và ứng dụng có thể đặt các chỉ số dọc tối thiểu tuỳ chỉnh bằng API setMinimumFontMetrics trong Kotlin và Java.
Camera và nội dung nghe nhìn
Android 15 thực hiện những thay đổi sau đối với hành vi của camera và nội dung nghe nhìn cho các ứng dụng nhắm đến Android 15 trở lên.
Quy định hạn chế đối với việc yêu cầu quyền phát âm thanh
Các ứng dụng nhắm đến Android 15 (API cấp 35) phải là ứng dụng hàng đầu hoặc đang chạy một dịch vụ trên nền trước để 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 này, thì lệnh gọi sẽ trả về AUDIOFOCUS_REQUEST_FAILED.
Bạn có thể tìm hiểu thêm về quyền phát âm thanh tại phần 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 lập danh sách các giao diện không phải SDK bị hạn chế. Danh sách này được cập nhật thông qua việc cộng tác với nhà phát triển Android và quy trình 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ủa bạn có thể truy cập vào 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 thử ứ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 ứng dụng sử dụng giao diện không phải SDK. Nếu không tìm được giải pháp thay thế cho việc sử dụng giao diện không phải SDK đối với 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 thêm về giao diện không phải SDK, hãy xem bài viết Các hạn chế đối với giao diện không phải SDK.