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

Để biết thêm thông tin về loại dịch vụ mediaProcessing, hãy xem bài viết Thay đổi đối với loại dịch vụ trên nền trước cho Android 15.

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:

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.

Quản lý khoá cho phương thức mã hoá hai đầu

Chúng tôi sẽ ra mắt E2eeContactKeysManager trong Android 15, hỗ trợ phương thức mã hoá hai đầu (E2EE) trong các ứng dụng Android của bạn bằng cách cung cấp một API cấp hệ điều hành để lưu trữ khoá công khai mã hoá.

E2eeContactKeysManager được thiết kế để tích hợp với ứng dụng danh bạ trên nền tảng, giúp người dùng quản lý và xác minh khoá công khai của danh bạ một cách tập trung.

Trải nghiệm người dù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ổ

Android 15 có 2 thay đổi liên quan đến phần lồng ghép cửa sổ liên quan. Trong phiên bản Beta 1, chế độ cài đặt tràn viền sẽ được thực thi. Ngoài ra, sắp có các thay đổi về cấu hình, bao gồm cả 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ị Android 15 trở lên sau khi nhắm đến SDK 35.

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. Các thay đổi như sau:

  • 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ê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ỉ.
  • Di chuyển 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 đặt để khớp với nền 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òn được dùng nữa nhưng vẫn tiếp tục ảnh hưởng đến việc điều hướng bằng 3 nút.
    • Theo mặc định, setNavigationBarContrastEnforced và R.attr#navigationBarContrastEnforced có giá trị true (đúng), giúp thêm nền mờ 80% trên 3 nút điều hướng.
  • 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 các phần lồng ghép.
    • setStatusBarColor và R.attr#statusBarColor không được dùng nữa và không ảnh hưởng đến Android 15.
    • setStatusBarContrastEnforced và R.attr#statusBarContrastEnforced không được dùng nữa nhưng vẫn có hiệu lực 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. Nếu không, ứng dụng sẽ gặp sự cố với IllegalArgumentException. LUÔN là tuỳ chọn duy nhất được cho phép để người dùng không nhìn thấy Thanh màu đen do vết cắt trên màn hình ở chế độ ngang, do đó, 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 SDK 35, cũng như trước và sau khi áp dụng các phần lồng ghép.

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. Tuy nhiên, nhiều thành phần 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 cạnh tranh của Android 15. Giao diện người dùng bị che khuất bao gồm TopAppBar, FAB và các mục trong danh sách của Material 2.
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.

Nếu ứng dụng của bạn:

  • đã cạnh tranh và áp dụng các phần lồng ghép, bạn hầu như 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.
    • Ứng dụng của bạn gặp sự cố do bạn có một cửa sổ không nổi, chẳng hạn như một Hoạt động 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ờ. Cho đến khi có bản sửa lỗi, hãy đặ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 được truy cập hơn này không có giao diện người dùng bị che. 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 màn hình đăng nhập
      • Trang cài đặt
  • không tràn lan, nên có nhiều khả năng bạn sẽ bị ảnh hưởng nhất. Ngoài các trường hợp đối với các ứng dụng đã tràn viền, bạn sẽ cần cân nhắc những điều sau:
    • Nếu ứng dụng của bạn sử dụng Thành phần Material 3 (androidx.compose.material3) trong Compose, chẳng hạn như TopAppBar, BottomAppBar và NavigationBar, thì những 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 sử 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ở đi, hãy sử 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 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ý các phần lồng ghép và không yêu cầu bạn phải làm gì khác. 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 theo cách thủ công làm khoảng đệm. Nếu nội dung của bạn nằm trong một 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 của 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 Khung 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, đồng thời thêm clipToPadding="false".
  • phải cung cấp chế độ bảo vệ nền tuỳ chỉnh cho 3 nút điều hướng hoặc thanh trạng thái, ứng dụng của 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 thông qua WindowInsets.Type#tappableElement() để có được chiều cao của thanh điều hướng có 3 nút hoặc WindowInsets.Type#statusBars.

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.

Danh sách các API không dùng nữa và đã bị vô hiệu hoá là:

  • R.attr#statusBarColor
  • R.attr#navigationBarColor
  • R.attr#navigationBarPhân chiaMàu
  • Cửa sổ#setDecorFitsSystemWindows
  • Cửa sổ#setStatusBarColor
  • Cửa sổ#setStatusBarCompatEnforced
  • Cửa sổ#setNavigationBarColor
  • Cửa sổ#setNavigationBarĐoạn chiamàu
  • Cửa sổ#getStatusBarColor
  • Cửa sổ#getStatusBarFutureEnforced
  • Cửa sổ#getNavigationBarColor
  • Cửa sổ#getNavigationBarDividerColor

Cấu hình ổn định

Thay đổi này chưa được thử nghiệm trong Phiên bản Beta 1 nhưng sẽ sớm ra mắt.

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 phương án thay thế tốt hơn như ViewGroup, WindowInsets hoặc WindowMetricsCalculator phù hợp tuỳ thuộc vào nhu cầu của mình.

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 Cấu hình. Tính năng này không còn được dùng 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.

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.

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.