Các thay đổi về khung tương thích (Android 13)

ACCOUNT_ACCESS_CHECK_CHANGE_ID

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy bật tính năng kiểm tra quyền truy cập vào tài khoản cho UID gọi trên tất cả các API liên quan đến việc đồng bộ hoá.

ALLOW_COPY_SOLID_COLOR_VIEW

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép ứng dụng nhận lệnh gọi lại SplashScreen.OnExitAnimationListener.onSplashScreenExit(SplashScreenView), ngay cả khi màn hình chờ chỉ hiển thị một màu đồng nhất.

ALLOW_SECURE_ACTIVITY_DISPLAY_ON_REMOTE_DEVICE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép một hoạt động bảo mật hiển thị trên các thiết bị từ xa nếu cần.

BORINGLAYOUT_FALLBACK_LINESPACING

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy bật khoảng cách dòng văn bản dự phòng (chiều cao dòng) cho BoringLayout.

CALL_REDIRECTION_AUDIO_MODES

Đối với ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép sử dụng các chế độ âm thanh để chuyển hướng âm thanh cuộc gọi.

CAMERA_MIC_INDICATORS_NOT_PRESENT

Cho biết rằng thiết bị này có hỗ trợ các chỉ báo máy ảnh và micrô. Sẽ là false nếu có Mã thay đổi, vì phương thức CompatChanges#isChangeEnabled sẽ trả về true nếu không có Mã thay đổi.

CLEAR_SHOW_FORCED_FLAG_WHEN_LEAVING

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, ngăn cờ SHOW_FORCED có hiệu lực trừ phi phương thức gọi hiện đang được lấy tiêu điểm.

DEFER_BOOT_COMPLETED_BROADCAST_CHANGE_ID

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy trì hoãn thông báo truyền tin LOCKED_BOOT_COMPLETED và BOOT_COMPLETED cho đến lần đầu tiên bất kỳ quy trình nào trong UID được khởi động.

DISALLOW_DEADLINES_FOR_PREFETCH_JOBS

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, không cho phép đặt thời hạn (sử dụng JobInfo.Builder.setOverrideDeadline(long)) cho các công việc tìm nạp trước (JobInfo.Builder.setPrefetch(boolean). Công việc tìm nạp trước được thiết kế để chạy gần với lần khởi chạy ứng dụng tiếp theo, vì vậy, các công việc này không được phép có thời hạn. Tuy nhiên, hệ thống không bỏ hoặc huỷ bất kỳ công việc tải trước đã lên lịch trước đó nào có thời hạn.

Ứng dụng không thể giữ một công việc tải trước được lên lịch liên tục có thời hạn. Các công việc tìm nạp trước có thời hạn sẽ chạy và các ứng dụng chịu sự hạn chế này sẽ không thể lên lịch các công việc tìm nạp trước mới có thời hạn. Nếu một công việc được lên lịch lại bằng cách cung cấp true sử dụng giá trị trả về từ JobService.jobFinished(JobParameters, boolean) hoặc JobService.onStopJob(JobParameters), thì thời hạn sẽ bị loại bỏ. Công việc định kỳ yêu cầu phải đáp ứng tất cả các quy tắc ràng buộc, vì vậy, các quy định hạn chế này không áp dụng cho thời hạn của công việc.

DOWNSCALED

Thay đổi này là yếu tố thúc đẩy tất cả thay đổi về việc giảm quy mô vùng đệm cho mỗi ứng dụng. Khi bật thay đổi này, hệ thống sẽ áp dụng các hệ số tỷ lệ sau:

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

Khi thay đổi này được bật đối với một gói ứng dụng, ứng dụng sẽ bị buộc đổi kích thước thành hệ số tỷ lệ cao nhất được bật. Ví dụ: tỷ lệ 80% sẽ được sử dụng nếu bật cả tỷ lệ 80% và 70% (DOWNSCALE_80 và DOWNSCALE_70).

DOWNSCALE_30

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 30%.

DOWNSCALE_35

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 35%.

DOWNSCALE_40

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 40%.

DOWNSCALE_45

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 45%.

DOWNSCALE_50

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 50%.

DOWNSCALE_55

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 55%.

DOWNSCALE_60

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 60%.

DOWNSCALE_65

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 65%.

DOWNSCALE_70

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 70%.

DOWNSCALE_75

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 75%.

DOWNSCALE_80

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 80%.

DOWNSCALE_85

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 85%.

DOWNSCALE_90

Nếu DOWNSCALED được bật cùng, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng nó đang chạy trên màn hình có tỷ lệ độ phân giải thực theo chiều dọc và chiều ngang là 90%.

DUMP_IGNORES_SPECIAL_ARGS

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, dump(String, FileDescriptor, PrintWriter, String[]) sẽ không được gọi nếu dumpsys activity được gọi bằng một số đối số đặc biệt.

DYNAMIC_RECEIVER_EXPLICIT_EXPORT_REQUIRED

Khi bật, bạn phải yêu cầu ứng dụng thiết lập Context.RECEIVER_EXPORTED hoặc Context.RECEIVER_NOT_EXPORTED rõ ràng khi đăng ký bộ thu cho một thông báo không được bảo vệ trong mã.

Để tìm hiểu thêm, hãy xem nội dung về Tính năng xuất an toàn hơn cho bộ thu đã đăng ký theo bối cảnh.

ENABLE_PENDING_INTENT_BAL_OPTION

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy bảo vệ PendingIntent khỏi bị lợi dụng để bắt đầu hoạt động ở chế độ nền.

ENABLE_SIMPLIFIED_DARK_MODE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép nội dung web áp dụng kiểu sáng hoặc tối theo giao diện của ứng dụng và WebView để cố gắng làm tối nội dung web bằng cách làm tối theo thuật toán khi thích hợp. Hãy tham khảo setAlgorithmicDarkeningAllowed(boolean) để biết thông tin chi tiết.

ENABLE_TOUCH_OPAQUE_ACTIVITIES

Đối với các ứng dụng chạy trên Android 13 (API cấp 33) trở lên, hãy đảm bảo các hoạt động tiêu thụ tất cả thao tác chạm trong giới hạn tác vụ của chúng.

ENABLE_USE_EXACT_ALARM

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép một số loại ứng dụng sử dụng Manifest.permission.USE_EXACT_ALARM để lên lịch chuông báo chính xác.

ENFORCE_INTENTS_TO_MATCH_INTENT_FILTERS

Các thành phần sẽ ngừng nhận ý định từ các phương thức gọi bên ngoài không khớp với bộ lọc ý định đã khai báo. Khi một ứng dụng đăng ký một thành phần đã xuất trong tệp kê khai và thêm một bộ lọc ý định, thành phần đó có thể được khởi động bằng bất kỳ ý định nào, ngay cả những ý định không khớp với bộ lọc ý định. Điều này đã được chứng minh là điều mà nhiều nhà phát triển cho là phản trực giác. Nếu không kiểm tra ý định khi thành phần được khởi động, trong một số trường hợp, điều này có thể cho phép các ứng dụng bên thứ ba kích hoạt chức năng chỉ dành cho nội bộ.

ENFORCE_STRICT_QUERY_BUILDER

Khi được bật, SQLiteQueryBuilder sẽ xác minh đối số độc hại trên tất cả lựa chọn truy vấn CalendarProvider2.

FORCE_DISABLE_HEVC_SUPPORT

Buộc tắt chế độ hỗ trợ tính năng đa phương tiện HEVC trên một ứng dụng. Ứng dụng nên khai báo các tính năng đa phương tiện được hỗ trợ trong tệp kê khai, nhưng cờ này có thể được dùng để buộc ứng dụng không hỗ trợ HEVC, do đó, buộc chuyển mã khi truy cập nội dung đa phương tiện được mã hoá theo HEVC. Việc đặt cờ này sẽ ghi đè mọi chế độ mặc định cấp hệ điều hành đối với ứng dụng. Trạng thái mặc định là tắt, có nghĩa là chế độ mặc định của hệ điều hành sẽ được ưu tiên. Nếu cả cờ này và FORCE_ENABLE_HEVC_SUPPORT đều được bật, hệ điều hành sẽ bỏ qua cả hai cờ.

FORCE_ENABLE_HEVC_SUPPORT

Buộc một ứng dụng bật chế độ hỗ trợ tính năng đa phương tiện HEVC. Các ứng dụng nên khai báo tính năng đa phương tiện được hỗ trợ trong tệp kê khai, nhưng cờ này có thể dùng để buộc một ứng dụng hỗ trợ HEVC, do đó, tránh chuyển mã khi truy cập vào nội dung đa phương tiện được mã hoá theo HEVC. Việc đặt cờ này sẽ ghi đè mọi chế độ mặc định cấp hệ điều hành đối với ứng dụng. Trạng thái mặc định là tắt, có nghĩa là chế độ mặc định của hệ điều hành sẽ được ưu tiên. Nếu bạn bật cả cờ này và FORCE_DISABLE_HEVC_SUPPORT, hệ điều hành sẽ bỏ qua cả hai cờ.

FORCE_NON_RESIZE_APP

Buộc các gói được áp dụng không được thay đổi kích thước.

FORCE_RESIZE_APP

Buộc các gói được áp dụng phải đổi kích thước được. Chúng tôi chỉ cho phép đổi kích thước ở chế độ cửa sổ toàn màn hình, nhưng không buộc ứng dụng phải thay đổi thành chế độ nhiều cửa sổ có thể đổi kích thước.

GET_API_SIGNATURES_FROM_UICC_PORT_INFO

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép một thẻ SIM có nhiều ICCID hoạt động cùng một lúc. Tính năng này được hỗ trợ bởi Nhiều hồ sơ được bật (MEP).

GWP_ASAN

Bật tính năng lấy mẫu để phát hiện lỗi bộ nhớ gốc trong ứng dụng.

Để tìm hiểu thêm về cách sử dụng GWP-ASan, hãy xem bài viết Hướng dẫn về GWP-ASan.

ICC_CLOSE_CHANNEL_EXCEPTION_ON_FAILURE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, một ngoại lệ sẽ được gửi bất cứ khi nào thao tác đóng kênh ICC không thành công.

MEDIA_CONTROL_SESSION_ACTIONS

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, các chế độ điều khiển nội dung đa phương tiện dựa trên thông báo Notification.MediaStyle hiện có các thao tác dựa trên PlaybackState của phiên phát nội dung đa phương tiện, thay vì các thao tác của thông báo.

Để tìm hiểu thêm về thay đổi này, hãy xem phần về những thay đổi đối với các chế độ điều khiển nội dung nghe nhìn trên trang Các thay đổi về hành vi của Android 13.

NATIVE_HEAP_ZERO_INIT

Bật tính năng tự động khởi chạy không phân bổ bộ nhớ vùng nhớ khối xếp gốc.

NATIVE_MEMTAG_ASYNC

Bật tính năng kiểm tra bộ nhớ không đồng bộ (ASYNC) trong quá trình này. Cờ này chỉ ảnh hưởng đến phần cứng hỗ trợ Tiện ích gắn thẻ bộ nhớ (MTE) ARM.

NATIVE_MEMTAG_SYNC

Bật tính năng kiểm tra thẻ nhớ đồng bộ (SYNC) trong quá trình này. Cờ này chỉ ảnh hưởng đến phần cứng hỗ trợ Tiện ích gắn thẻ bộ nhớ (MTE) ARM. Nếu cả NATIVE_MEMTAG_ASYNC và cờ này đều được bật, thì cờ này sẽ được ưu tiên và MTE sẽ được bật ở chế độ SYNC.

NOTIFICATION_LOG_ASSISTANT_CANCEL

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy cho phép trình nghe hiểu rõ lý do cụ thể hơn về việc trợ lý huỷ thông báo, thay vì sử dụng REASON_LISTENER_CANCEL chung chung hơn.

NOTIFICATION_PERM_CHANGE_ID

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy bật các thay đổi về hành vi liên quan đến quyền khi bắt đầu chạy cho thông báo.

Để tìm hiểu thêm về thay đổi này, hãy xem trang về quyền khi bắt đầu chạy thông báo mới.

NOTIFICATION_TRAMPOLINE_BLOCK_FOR_EXEMPT_ROLES

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, Activity bắt đầu từ broadcast receiver hoặc dịch vụ để phản hồi lượt nhấp vào thông báo và hành động thông báo sẽ bị chặn vì lý do hiệu suất và trải nghiệm người dùng đối với các chủ thể có vai trò được miễn trừ trước đó (trình duyệt).

OVERRIDABLE_COMPONENT_CALLBACKS

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, registerComponentCallbacks(ComponentCallbacks) sẽ thêm ComponentCallbacks vào Activity hoặc ContextWrapper.getBaseContext() thay vì luôn thêm vào getApplicationContext().

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

Khi bật, mã thay đổi này sẽ buộc các gói được áp dụng bỏ qua giá trị hiện tại của android:resizeableActivity cũng như SDK mục tiêu bằng hoặc thấp hơn M, đồng thời xem hoạt động là không đổi kích thước được. Trong trường hợp này, giá trị góc xoay và kích thước cắt của máy ảnh sẽ chỉ phụ thuộc vào giá trị bù cần thiết khi tính đến góc xoay màn hình hiện tại.

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

Khi bật, mã thay đổi này sẽ buộc các gói được áp dụng ghi đè hành vi xoay và cắt máy ảnh mặc định và luôn trả về CaptureRequest.SCALER_ROTATE_AND_CROP_NONE. Hành vi mặc định cùng với tất cả tổ hợp ghi đè khả thi được đề cập trong bảng dưới đây.

OVERRIDE_MIN_ASPECT_RATIO

Thay đổi này là yếu tố thúc đẩy tất cả thay đổi có hành vi buộc áp dụng tỷ lệ khung hình tối thiểu nhất định. Khi bật đổi thay đổi này, hệ thống sẽ áp dụng tỷ lệ khung hình tối thiểu sau đây:

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

Khi thay đổi này được bật đối với một gói ứng dụng, tỷ lệ khung hình tối thiểu được cung cấp trong tệp kê khai của ứng dụng sẽ được ghi đè thành tỷ lệ khung hình lớn nhất được bật, trừ khi giá trị trong tệp kê khai của ứng dụng cao hơn.

OVERRIDE_MIN_ASPECT_RATIO_LARGE

Nếu OVERRIDE_MIN_ASPECT_RATIO được bật cùng, việc bật thay đổi này cho một gói sẽ thiết lập tỷ lệ khung hình tối thiểu của hoạt động thành một giá trị lớn do OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE xác định.

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

Nếu OVERRIDE_MIN_ASPECT_RATIO được bật cùng, việc bật thay đổi này cho một gói sẽ thiết lập tỷ lệ khung hình tối thiểu của hoạt động thành một giá trị trung bình do OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE xác định.

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

Nếu OVERRIDE_MIN_ASPECT_RATIO được bật cùng, việc thay đổi này sẽ giới hạn mọi thay đổi khác buộc tỷ lệ khung hình tối thiểu của một hoạt động thành một giá trị nhất định, chẳng hạn như OVERRIDE_MIN_ASPECT_RATIO_LARGE và OVERRIDE_MIN_ASPECT_RATIO_MEDIUM – đối với các hoạt động cũng có hướng dọc.

RATE_LIMIT_TOASTS

Bật giới hạn số lượng lệnh gọi Toast.show() để ngăn việc gửi quá nhiều thông báo ngắn cho người dùng trong một khoảng thời gian có hạn. Nếu bạn cố gắng hiện nhiều thông báo ngắn hơn mức cho phép trong một khung thời gian nhất định thì sẽ dẫn đến việc thông báo ngắn bị loại bỏ.

REQUEST_LISTENING_MUST_MATCH_PACKAGE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, lệnh gọi TileService.requestListeningState(Context, ComponentName) sẽ kiểm tra để đảm bảo rằng gói gọi (UID) và gói của mục tiêu ComponentName khớp nhau. Hệ thống cũng kiểm tra để đảm bảo ngữ cảnh được sử dụng có thể thay mặt người dùng hiện tại thực hiện các hành động.

RETURN_ADVANCED_VIDEO_PROFILES

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hãy kiểm soát loại hồ sơ video do getAll(String, int) trả về.

SHOULD_RESOLVE_PORT_INDEX_FOR_APPS

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, cho phép thẻ SIM bật nhiều hồ sơ được bật (MEP) trên nhiều cổng. Để duy trì khả năng tương thích ngược cho các ứng dụng của nhà mạng, khi một ứng dụng nhắm đến API cấp 32 trở xuống gọi switchToSubscription hoặc tải các API xuống mà không chỉ định chỉ mục cổng, hệ thống sẽ giữ lại hành vi hiện có bằng cách luôn sử dụng chỉ mục cổng 0 ngay cả khi chính thiết bị đã bật MEP eUICC.

SWITCH_WITHOUT_PORT_INDEX_EXCEPTION_ON_DISABLE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hệ thống sẽ gửi một ngoại lệ bất cứ khi nào switchToSubscription() được gọi mà không có portIndex để tắt gói thuê bao.

THROW_ON_INVALID_PRIORITY_VALUE

Đối với các ứng dụng nhắm đến Android 13 (API cấp 33) trở lên, hệ thống sẽ gửi một ngoại lệ khi một ứng dụng cung cấp giá trị mức độ ưu tiên không hợp lệ bằng cách sử dụng JobInfo.Builder.setPriority(int). Các ứng dụng cũ có thể đang sử dụng API không chính xác, vì vậy, lệnh gọi sẽ không thành công nếu các ứng dụng đó tiếp tục sử dụng API.

USE_EXPERIMENTAL_COMPONENT_ALIAS

Khi bật, hệ thống sẽ cho phép gói "android" sử dụng bí danh thành phần.