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 đ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 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_COMPLETED khở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]"

为避免此行为变更出现问题，您可以执行以下一项或多项操作：

1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您不立即停止应用，系统会生成故障。）
2. 确保应用的 dataSync 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
3. 仅在有直接用户互动时启动 dataSync 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
4. 请使用替代 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 引入了一种新的前台服务类型 mediaProcessing。此服务类型适用于转码媒体文件等操作。例如，媒体应用可能会下载音频文件，并需要先将其转换为其他格式，然后才能播放。您可以使用 mediaProcessing 前台服务，确保即使应用在后台运行时转换也会继续。

系统允许应用的 mediaProcessing 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，服务有几秒钟的时间来调用 Service.stopSelf()。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

为避免出现此异常，您可以执行以下任一操作：

1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您未立即停止应用，系统会生成失败情况。）
2. 确保应用的 mediaProcessing 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
3. 仅在有直接用户互动时启动 mediaProcessing 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
4. 请改用 替代 API（例如 WorkManager），而不是使用 mediaProcessing 前台服务。

如果您的应用的 mediaProcessing 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 mediaProcessing 前台服务，除非用户将您的应用切换到前台（这会重置计时器）。如果您尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似于“前台服务类型 mediaProcessing 的时间限制已用尽”的错误消息。

如需详细了解 mediaProcessing 服务类型，请参阅 Android 15 前台服务类型变更：媒体处理。

测试

如需测试应用的行为，您可以启用媒体处理超时，即使您的应用并非以 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 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

在启动 BOOT_COMPLETED 广播接收器方面存在新限制 前台服务。BOOT_COMPLETED 接收器不能启动 以下类型的前台服务：

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone（自 Android 14 起，microphone 就受到此限制）

如果 BOOT_COMPLETED 接收器尝试启动任何上述类型的前台 服务，系统会抛出 ForegroundServiceStartNotAllowedException。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。运行以下 adb 命令：

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

如需在不重启设备的情况下发送 BOOT_COMPLETED 广播，请运行以下 adb 命令：

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

以前，如果应用拥有 SYSTEM_ALERT_WINDOW 权限，即使应用当前在后台运行，也可以启动前台服务（如免于后台启动限制中所述）。

如果应用以 Android 15 为目标平台，则此豁免范围现在更窄。现在，应用需要具有 SYSTEM_ALERT_WINDOW 权限，并且还需要有一个可见的叠加窗口。也就是说，应用需要先启动 TYPE_APPLICATION_OVERLAY 窗口，并且该窗口需要处于可见状态，然后您才能启动前台服务。

如果您的应用尝试从后台启动前台服务，但不符合这些新要求（并且没有其他豁免情况），系统会抛出 ForegroundServiceStartNotAllowedException。

如果您的应用声明了 SYSTEM_ALERT_WINDOW 权限并从后台启动前台服务，则可能会受到此变更的影响。如果您的应用获得了 ForegroundServiceStartNotAllowedException，请检查应用的操作顺序，并确保应用在尝试从后台启动前台服务之前已具有有效的叠加层窗口。您可以通过调用 View.getWindowVisibility() 检查叠加层窗口当前是否可见，也可以替换 View.onWindowVisibilityChanged()，以便在可见性发生变化时收到通知。

测试

如需测试应用的行为，您可以启用这些新限制，即使您的应用并未以 Android 15 为目标平台（只要应用在 Android 15 设备上运行）也是如此。如需针对从后台启动前台服务启用这些新限制，请运行以下 adb 命令：

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

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

以 Android 15（API 级别 35）及更高版本为目标平台的应用无法再更改设备上的勿扰 (DND) 功能的全局状态或政策（无论是通过修改用户设置还是关闭勿扰模式）。相反，应用必须提供 AutomaticZenRule，系统会将其与现有的“最严格的政策优先”方案合并为一个全局政策。对之前会影响全局状态的现有 API 的调用（setInterruptionFilter、setNotificationPolicy）会导致创建或更新隐式 AutomaticZenRule，该 AutomaticZenRule 会根据这些 API 调用的调用周期开启和关闭。

请注意，只有当应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 并希望该调用停用之前由其所有者激活的 AutomaticZenRule 时，此更改才会影响可观察到的行为。

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 sau đây 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 (API cấp 35):

• Thay đổi đối với API định dạng chuỗi: Quy trình 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:

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  Ví dụ: trường hợp ngoại lệ sau sẽ được gửi khi bạn 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).

• 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 kết quả hiện là Object chứ không phải loại của các phần tử trong mảng cơ bản. Vì vậy, mã sau đây sẽ gửi một ClassCastException:

  String[] elements = (String[]) Arrays.asList("one", "two").toArray();
  

  Trong trường hợp này, để giữ nguyên 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 đối với cách xử lý mã ngôn ngữ: Khi sử dụng API Locale, các 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 các dạng cũ (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 sử dụng các mã theo tiêu chuẩn ISO 639-1 (tiếng Do Thái: he, tiếng Yiddish: yi và tiếng Indonesia: id).

• Thay đổi đối với trình tự int 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 trình tự số khác với các phương thức Random.nextInt():

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  Nhìn chung, thay đổi này sẽ không dẫn đến hành vi phá vỡ ứng dụng, nhưng mã của bạn không nên mong đợi trình tự được tạo từ các phương thức Random.ints() khớp với Random.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 (API cấp 35):

• Xung đột với các hàm mở rộng MutableList.removeFirst() và MutableList.removeLast() trong kotlin-stdlib

  Loại List trong Java được liên kết với loại MutableList trong Kotlin. Vì các API List.removeFirst() và List.removeLast() đã được giới thiệu trong Android 15 (API cấp 35), nên trình biên dịch Kotlin sẽ phân giải các lệnh gọi hàm, ví dụ: list.removeFirst(), một cách tĩnh đến các API List mới thay vì đến các hàm mở rộng trong kotlin-stdlib.

  Nếu một ứng dụng được biên dịch lại với compileSdk được đặt thành 35 và minSdk được đặt thành 34 trở xuống, sau đó ứng dụng đó chạy trên Android 14 trở xuống, thì lỗi thời gian chạy sẽ được gửi:

  java.lang.NoSuchMethodError: No virtual method
  removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
  

  Tuỳ chọn tìm lỗi mã nguồn NewApi hiện có trong Trình bổ trợ Android cho Gradle có thể phát hiện các cách sử dụng API mới này.

  ./gradlew lint
  
  MainActivity.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 tìm lỗi mã nguồn, bạn có thể thay thế lệnh gọi hàm removeFirst() và removeLast() lần lượt bằng removeAt(0) và removeAt(list.lastIndex) 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 tuỳ chọn khắc phục nhanh cho các lỗi này.

  Cân nhắc xoá @SuppressLint("NewApi") và lintOptions { disable 'NewApi' } nếu bạn đã tắt tuỳ chọn tìm lỗi mã nguồn.

• 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ụ: List và Deque. Các 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à loại đố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 tình trạng không tương thích, trình biên dịch javac sẽ xuất ra lỗi thời gian tạo. Ví dụ:

  Lỗi ví dụ 1:

  javac MyList.java
  
  MyList.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 List
  

  Ví dụ về lỗi 2:

  javac MyList.java
  
  MyList.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 error
  

  Ví dụ về lỗi 3:

  javac MyList.java
  
  MyList.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 các 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ó các thay đổi giúp tăng cường bảo mật hệ thống để bảo vệ ứng dụng và người dùng khỏi ứng dụng độc hại.

Các phiên bản TLS bị hạn chế

Android 15 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用，但现在不允许面向 Android 15 的应用使用。

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

Android 15 bảo vệ người dùng khỏi các ứng dụng độc hại và cho phép họ kiểm soát chặt chẽ hơn thiết bị của họ bằng cách thêm những thay đổi ngăn các ứ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 của họ và lạm dụng tương tác của người dùng. Các hoạt động chạy trong nền đã bị hạn chế kể từ Android 10 (API cấp 29).

Không cho phép các ứng dụng không khớp với UID hàng đầu trong ngăn xếp khởi chạy các hoạt động

Các ứ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 thao tác, sau đó phủ lên trên, tạo ảo giác rằng mình là ứng dụng đó. "Việc cần làm này" chiếm đoạt tài khoản" bỏ qua các hạn chế khởi chạy trong nền hiện tại vì tất cả xảy ra trong cùng một tác vụ hiển thị. Để giảm thiểu rủi ro này, Android 15 thêm một cờ chặn không cho 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 hoạt động. Để chọn tham gia tất cả hoạt động của ứng dụng, hãy cập nhật 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 sẽ hoạt động nếu đáp ứng tất cả các điều kiện sau:

• Ứng dụng thực hiện việc khởi chạy 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 biện pháp bảo vệ mới

Nếu các biện pháp bảo mật được bật, các ứng dụng có thể trở về nhà thay vì ứng dụng hiển thị cuối cùng nếu họ hoàn thành nhiệm vụ của riêng mình.

Các thay đổi khác

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

• Thay đổi PendingIntent người tạo để chặn các đợt chạy hoạt động trong nền bằng cách mặc định. Việc này giúp ngăn chặn các ứng dụng vô tình tạo 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 ứng dụng đó. Thay đổi này nhằm ngăn các ứng dụng độc hại lợi dụng bắt đầu hoạt động trong nền. Theo mặc định, ứng dụng không được phép đưa ngăn xếp tác vụ lên nền trước, trừ phi trình 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ó hoạt động ở chế độ nền đặc quyền khởi chạy.
• 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ụ đó. Nếu hoạt động hàng đầu kết thúc một tác vụ, Android sẽ quay lại bất kỳ tác vụ nào lần 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ụ của nó, Android sẽ quay lại màn hình chính; nó sẽ không chặn việc kết thúc quảng cáo không phải trên cùng này của bạn.
• Ngăn chặn việc khởi chạy hoạt động tuỳ ý từ các ứng dụng khác vào ứng dụng của bạn nhiệm vụ. Thay đổi này ngăn chặn các ứng dụng độc hại tấn công người dùng bằng cách tạo những hoạt động có vẻ như từ các ứng dụng khác.
• Chặn để các cửa sổ không hiển thị không được xem xét về hoạt động ở chế độ nền . Việc này giúp ngăn các ứng dụng độc hại lợi dụng nền các hoạt động khởi chạy để 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 (không bắt buộc) để giúp ý định an toàn và hiệu quả hơn. Những thay đổi này nhằm ngăn chặn các lỗ hổng tiềm ẩn và việc sử dụng sai ý định mà các ứng dụng độc hại có thể khai thác. Có hai điểm cải tiến chính về bảo mật của ý định trong Android 15:

• Khớp bộ lọc ý định mục tiêu: Ý đị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 của bộ lọc ý định của mục tiêu. Nếu bạn gửi một ý đị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 khớp với bộ lọc ý định đã khai báo của hoạt động nhận.
• Ý định phải có hành động: Ý định không có hành động sẽ không còn 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.

Để kiểm tra cách ứng dụng của bạn phản hồi những thay đổi này, hãy sử dụng StrictMode trong ứng dụng. Để xem nhật ký chi tiết về các lỗi vi phạm việc sử dụng Intent, hãy thêm phương thức sau:

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

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 tạo ra trải nghiệm người dùng nhất quán và trực quan hơn.

Thay đổi về 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.

全面实施政策

Theo mặc định, các ứng dụng sẽ hiển thị 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 (API cấp 35).

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

• Thanh điều hướng xử lý cử chỉ
  • Trong suốt theo mặc định.
  • Độ lệch dưới cùng bị tắt để nội dung vẽ phía sau thanh điều hướng của hệ thống, trừ phi bạn áp dụng phần lồng ghép.
  • setNavigationBarColor và R.attr#navigationBarColor không còn được dùng nữa và không ảnh hưởng đến thao tác bằng cử chỉ.
  • setNavigationBarContrastEnforced và R.attr#navigationBarContrastEnforced vẫn không ảnh hưởng đến thao tác bằng cử chỉ.
• Thao tác bằng 3 nút
  • Độ mờ được đặt thành 80% theo mặc định, với màu có thể khớp với nền cửa sổ.
  • Vô hiệu hoá độ dời dưới cùng để nội dung vẽ phía sau thanh điều hướng của hệ thống, trừ phi áp dụng phần lồng ghép.
  • setNavigationBarColor và R.attr#navigationBarColor được đặt để khớp với nền cửa sổ theo mặc định. Nền cửa sổ phải là màu có thể vẽ để áp dụng giá trị mặc định này. API này không còn đượ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 là true theo mặc định, thêm nền mờ 80% trên chế độ điều hướng 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ội dung vẽ phía sau thanh trạng thái, trừ khi bạn áp dụng phần lồng ghép.
  • setStatusBarColor và R.attr#statusBarColor không còn đượ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òn được dùng nữa nhưng vẫn có tác động trên Android 15.
• Khung cắt màn hình
  • layoutInDisplayCutoutMode của các 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 phần cắt màn hình gây ra và xuất hiện cạnh bên.

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

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

Nếu ứng dụng của bạn đã tràn viền và áp dụng phần lồng ghép, thì bạn sẽ không bị ảnh hưởng nhiều, ngoại trừ các trường hợp sau. Tuy nhiên, ngay cả khi bạn 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ì 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ờ cốt lõi lên 1.2.0-alpha01 trở lên hoặc đặt window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• Có thể có các 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 được truy cập này không có giao diện người dùng bị che khuất. Các 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 đă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 có màn hình tràn viền, thì rất có thể bạn sẽ bị ảnh hưởng. Ngoài các trường hợp cho ứng dụng đã tràn viền, bạn nên cân nhắc những điều sau:

• Nếu ứng dụng của bạn sử dụng các 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ý phần lồng ghép.
• Nếu ứng dụng của bạn đang sử dụng các 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ý phần lồng ghép. Tuy nhiên, bạn có thể truy cập vào những phần lồng ghép này và áp dụng chúng theo cách thủ công. Trong androidx.compose.material 1.6.0 trở lên, hãy sử dụng tham số windowInsets để áp dụng phần lồng ghép theo cách thủ công cho BottomAppBar, TopAppBar, BottomNavigation và NavigationRail. Tương tự, hãy dùng tham số contentWindowInsets cho Scaffold.
• Nếu ứng dụng của bạn sử dụng các thành phần Khung hiển thị và Material (com.google.android.material), thì hầu hết các 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ý phần lồng ghép nên có thể bạn không cần phải 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 các thành phần kết hợp tuỳ chỉnh, hãy áp dụng phần lồng ghép theo cách thủ công như khoảng đệm. Nếu nội dung 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 sử dụng các 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 ViewCompat.setOnApplyWindowInsetsListener. Đối với RecyclerView, hãy áp dụng khoảng đệm bằng trình nghe này, đồng thời thêm clipToPadding="false".

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

Nếu phải cung cấp tính năng bảo vệ nền tuỳ chỉnh cho thanh điều hướng 3 nút hoặc thanh trạng thái, thì ứng dụng của bạn phải đặt một thành phần kết hợp hoặc thành phần 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 3 nút hoặc WindowInsets.Type#statusBars.

Tài nguyên bổ sung từ cạnh này sang cạnh kia

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

API không dùng nữa

Các API sau đây không còn được dùng nữa nhưng không bị vô hiệu hoá:

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor (dành cho thao tác bằng 3 nút, với độ đậm alpha là 80%)
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (dành cho thao tác bằng 3 nút, với alpha là 80%)
• Window#setStatusBarContrastEnforced

Các API sau đây không còn được dùng nữa và bị vô hiệu hoá:

• R.attr#navigationBarColor (để điều hướng bằng cử chỉ)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (để điều hướng bằng cử chỉ)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

稳定配置

如果您的应用以 Android 15（API 级别 35）或更高版本为目标平台，Configuration 不再排除系统栏。如果您使用 Configuration 类中的屏幕尺寸进行布局计算，则应根据需要将其替换为更好的替代方案，例如适当的 ViewGroup、WindowInsets 或 WindowMetricsCalculator。

Configuration 从 API 1 开始提供。它通常从 Activity.onConfigurationChanged 中获取。它提供窗口密度、屏幕方向和尺寸等信息。从 Configuration 返回的窗口大小的一个重要特征是，它之前会排除系统栏。

配置大小通常用于资源选择（例如 /res/layout-h500dp），这仍然是一个有效的用例。不过，我们一直不建议将其用于布局计算。如果您在使用此功能，请立即停止使用。您应根据自己的用例，将 Configuration 的使用替换为更合适的用法。

如果您使用它来计算布局，请使用适当的 ViewGroup，例如 CoordinatorLayout 或 ConstraintLayout。如果您使用它来确定系统侧边栏的高度，请使用 WindowInsets。如果您想知道应用窗口的当前大小，请使用 computeCurrentWindowMetrics。

以下列表介绍了受此变更影响的字段：

• Configuration.screenWidthDp 和 screenHeightDp 尺寸不再排除系统栏。
• Configuration.smallestScreenWidthDp 会间接受到对 screenWidthDp 和 screenHeightDp 的更改的影响。
• 在接近方形的设备上，Configuration.orientation 会间接受到对 screenWidthDp 和 screenHeightDp 所做的更改的影响。
• Display.getSize(Point) 会间接受到 Configuration 中更改的影响。从 API 级别 30 开始，此方法已被弃用。
• 从 API 级别 33 开始，Display.getMetrics() 就已经这样运作了。

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

对于以 Android 15（API 级别 35）为目标平台的应用，elegantTextHeight TextView 属性默认会变为 true，将默认使用的紧凑字体替换为一些具有较大垂直测量的脚本，使其更易于阅读。紧凑字体旨在防止布局中断；Android 13（API 级别 33）允许文本布局利用 fallbackLineSpacing 属性拉伸垂直高度，从而防止许多此类中断。

在 Android 15 中，系统中仍保留了紧凑字体，因此您的应用可以将 elegantTextHeight 设置为 false 以获得与之前相同的行为，但即将发布的版本不太可能支持此字体。因此，如果您的应用支持以下脚本：阿拉伯语、老挝语、缅甸语、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语，请将 elegantTextHeight 设置为 true 以测试您的应用。

Chiều rộng TextView thay đổi cho các hình dạng chữ cái phức tạp

在以前的 Android 版本中，某些具有复杂形状的手写字体或语言可能会在上一个或下一个字符的区域绘制字母。在某些情况下，此类字母会在开头或结尾处被剪裁。从 Android 15 开始，TextView 会分配宽度，以便为此类字母绘制足够的空间，并允许应用请求向左额外添加内边距以防止剪裁。

由于此更改会影响 TextView 确定宽度的方式，因此如果应用以 Android 15（API 级别 35）或更高版本为目标平台，TextView 会默认分配更多宽度。您可以通过对 TextView 调用 setUseBoundsForWidth API 来启用或停用此行为。

由于添加左内边距可能会导致现有布局未对齐，因此默认情况下不会添加内边距，即使以 Android 15 或更高版本为目标平台的应用也是如此。不过，您可以通过调用 setShiftDrawingOffsetForStartOverhang 添加额外的内边距以防止剪裁。

以下示例展示了这些更改如何改进某些字体和语言的文本布局。

采用手写体字体的英语文本的标准布局。部分字母被截断。对应的 XML 如下：

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

相同英语文本的布局，增加了宽度和内边距。以下是相应的 XML：

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

泰语文本的标准布局。部分字母被截断。 以下是相应的 XML：

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

相同泰语文本的布局，增加了宽度和内边距。以下是相应的 XML：

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

Khoảng cách 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:

Đố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:

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.

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 cho các ứng dụng nhắm đến Android 15 trở lên.

Các hạn chế đối với việc yêu cầu quyền phát âm thanh

以 Android 15（API 级别 35）为目标平台的应用必须是顶部应用或正在运行前台服务，才能请求音频焦点。如果应用在未满足上述任一要求的情况下尝试请求焦点，调用将返回 AUDIOFOCUS_REQUEST_FAILED。

如需详细了解音频焦点，请参阅管理音频焦点。

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ủ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 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.

如需详细了解此 Android 版本中的变更，请参阅 Android 15 中有关限制非 SDK 接口的更新。如需全面了解有关非 SDK 接口的详细信息，请参阅对非 SDK 接口的限制。