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, cho phép kiểm tra quyền truy cập vào tài khoản đối với 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 những ứ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 các ứ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 hoãn các thông báo 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 (bằng cách sử dụng JobInfo.Builder.setOverrideDeadline(long)) cho các tác vụ tìm nạp trước (JobInfo.Builder.setPrefetch(boolean). Các tác vụ 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 tác vụ này không được phép có thời hạn. Tuy nhiên, hệ thống không loại bỏ hoặc huỷ bất kỳ công việc tìm nạp trước nào đã lên lịch trước đó có thời hạn.

Không có cách nào để một ứng dụng duy trì một công việc tìm nạp trước được lên lịch vĩnh viễn 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 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 bằng giá trị trả về từ JobService.jobFinished(JobParameters, boolean) hoặc JobService.onStopJob(JobParameters), thì thời hạn sẽ bị huỷ. Các công việc định kỳ yêu cầu đáp ứng tất cả các điều kiện ràng buộc, vì vậy những hạn chế này không áp dụng cho thời hạn của các 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ũng được bật, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng ứng dụng đ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ũng được bật, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng ứng dụng đ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ũng được bật, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng ứng dụng đ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ũng được bật, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng ứng dụng đ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ũng được bật, việc bật thay đổi này cho một gói sẽ buộc ứng dụng giả định rằng ứng dụng đang chạy trên màn hình có độ phân giải thực theo chiều dọc và chiều ngang là 50%.

DOWNSCALE_55

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

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 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, các hoạt động sẽ sử dụng tất cả các thao tác chạm trong phạm vi 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 cho 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ừ những người gọi bên ngoài không khớp với bộ lọc ý định đã khai báo của thành phần đó. 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, mọi ý định đều có thể khởi động thành phần đó, ngay cả những ý định không khớp với bộ lọc ý định. Điều này đã được chứng minh là một điều mà nhiều nhà phát triển cảm thấy không hợp lý. 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 bạn bật cả cờ này và FORCE_ENABLE_HEVC_SUPPORT, thì 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 thiết lập cờ này sẽ ghi đè mọi giá trị 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, thì 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ó thể có nhiều ICCID hoạt động cùng một lúc. Tính năng này được cung cấp 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, giờ đây, một ngoại lệ sẽ được gửi bất cứ khi nào một 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ế độ kiểm soát nội dung nghe nhì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 nội dung nghe nhì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 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 các trình nghe hiểu rõ hơn lý do cụ thể được cung cấp cho việc huỷ thông báo từ một trợ lý, 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 mới của thông báo.

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 đến từ broadcast receiver hoặc các dịch vụ để phản hồi thông báo và các lượt nhấp vào hành động thông báo sẽ bị chặn vì lý do liên quan đến trải nghiệm người dùng và hiệu suất đối với những người nắm giữ vai trò được miễn trừ trước đây (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ũng được bật, 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, việc gọi TileService.requestListeningState(Context, ComponentName) sẽ kiểm tra xem gói gọi (UID) và gói của ComponentName mục tiêu có khớp hay không. Hệ thống cũng kiểm tra để đảm bảo rằng ngữ cảnh được dùng có thể thực hiện các hành động thay mặt cho người dùng hiện tại.

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 các cổng khác nhau. Để 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 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 bản thân thiết bị đã bật eUICC MEP.

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 một lượt đăng ký.

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 ứ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 đúng cách, vì vậy, lệnh gọi sẽ âm thầm không thành công nếu các ứng dụng này 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.