Đáp ứng yêu cầu của Google Play về cấp độ API mục tiêu

Di chuyển từ phiên bản Android 11 trở xuống (API cấp 30)

Chọn phiên bản Android bạn sẽ di chuyển khỏi:

Di chuyển sang Android 5 (API cấp 21)

Xem trang Các thay đổi về hành vi tương ứng với từng bản phát hành sau đây để đảm bảo ứng dụng của bạn đã có các thay đổi được giới thiệu trong những bản phát hành này:

• Android 5.0 (API cấp 21)
• Android 4.4 (API cấp 19).
• Android 4.1.x (API cấp 16).

Tiếp tục bằng cách làm theo hướng dẫn ở phần tiếp theo.

Di chuyển sang Android 6 (API cấp 23)

Những điểm cần cân nhắc sau đây áp dụng cho các ứng dụng nhắm đến Android 6.0 và các phiên bản cao hơn của nền tảng này:

• Quyền khi bắt đầu chạy

  • Các quyền nguy hiểm chỉ được cấp khi bắt đầu chạy. Luồng giao diện người dùng (UI flows) của bạn phải cung cấp các thành phần cho phép cấp những quyền này.

  • Bất cứ khi nào có thể, hãy đảm bảo rằng ứng dụng của bạn sẵn sàng xử lý sự từ chối đối với các yêu cầu cấp quyền. Ví dụ: nếu người dùng từ chối yêu cầu truy cập vào GPS của thiết bị, hãy đảm bảo ứng dụng của bạn có cách khác để tiếp tục.

Để có danh sách đầy đủ các thay đổi có trong Android 6.0 (API cấp 23), hãy xem trang Các thay đổi về hành vi cho phiên bản nền tảng đó.

Tiếp tục bằng cách làm theo hướng dẫn ở phần tiếp theo.

Di chuyển sang Android 7 (API cấp 24)

Những điểm cần cân nhắc sau đây áp dụng cho các ứng dụng nhắm đến Android 7.0 và các phiên bản cao hơn của nền tảng này:

• Chế độ Nghỉ và Chế độ chờ ứng dụng

  Nội dung thiết kế cho các hành vi được mô tả ở phần Tối ưu hoá cho chế độ Nghỉ và Chế độ chờ ứng dụng, bao gồm các thay đổi gia tăng có trong một số bản phát hành của nền tảng.

  Khi thiết bị ở vào chế độ Nghỉ và Chế độ chờ ứng dụng, hệ thống sẽ hoạt động như sau:

  • Hạn chế quyền truy cập mạng
  • Tạm hoãn chuông báo, đồng bộ hoá và công việc.
  • Hạn chế quét tìm GPS và Wi-Fi
  • Hạn chế các tin nhắn gửi bằng Giải pháp gửi thông báo qua đám mây của Firebase có mức độ ưu tiên thông thường.

• Các thay đổi về quyền

  • Hệ thống hạn chế quyền truy cập vào các thư mục riêng tư của ứng dụng.
  • Việc hiển thị một URI file:// bên ngoài ứng dụng của bạn sẽ kích hoạt FileUriExposedException. Nếu bạn cần chia sẻ tệp ra bên ngoài ứng dụng, hãy triển khai FileProvider

• Hệ thống cấm việc liên kết với các thư viện không phải NDK.

Để có danh sách đầy đủ các thay đổi có trong Android 7.0 (API cấp 24), hãy xem trang Các thay đổi về hành vi cho phiên bản nền tảng đó.

Tiếp tục bằng cách làm theo hướng dẫn ở phần tiếp theo.

Di chuyển sang Android 8 (API cấp 26)

Những điểm cần cân nhắc sau đây áp dụng cho các ứng dụng nhắm đến Android 8.0 và các phiên bản cao hơn của nền tảng này:

• Giới hạn thực thi dưới nền
  • Hệ thống hạn chế dịch vụ đối với các ứng dụng không chạy ở nền trước.
    • startService() hiện tại sẽ ném một trường hợp ngoại lệ khi ứng dụng gọi phương thức này trong lúc startService() bị cấm.
    • Để bắt đầu các dịch vụ trên nền trước, ứng dụng phải dùng startForeground() và startForegroundService().
    • Xem xét kỹ các thay đổi được thực hiện cho API JobScheduler, như được nêu trên trang về Các thay đổi về hành vi của Android 8.0 (API cấp 26).
    • Giải pháp gửi thông báo qua đám mây của Firebase yêu cầu phiên bản 10.2.1 trở lên đối với SDK Dịch vụ Google Play.
    • Khi sử dụng Giải pháp gửi thông báo qua đám mây của Firebase, việc gửi tin nhắn phải tuân thủ giới hạn thực thi dưới nền. Nếu cần thực hiện công việc trong nền khi nhận được tin nhắn, chẳng hạn như thực hiện đồng bộ hoá dữ liệu nền, ứng dụng của bạn phải lên lịch công việc thông qua Firebase Job Dispatcher (Trình điều phối công việc Firebase) hoặc JobIntentService. Để biết thêm thông tin, hãy xem tài liệu về Giải pháp gửi thông báo qua đám mây của Firebase.
  • Thông báo truyền phát ngầm
    • Các thông báo truyền phát ngầm bị hạn chế. Để biết thông tin về cách xử lý các sự kiện chạy dưới nền, hãy xem tài liệu về API JobScheduler.
  • Giới hạn quyền truy cập thông tin vị trí ở chế độ nền
    • Các ứng dụng chạy ở chế độ nền chỉ có quyền truy cập giới hạn vào dữ liệu vị trí.
      • Trên các thiết bị có dịch vụ của Google Play, hãy sử dụng trình cung cấp vị trí kết hợp để nhận các thông báo cập nhật vị trí định kỳ.
• Kênh thông báo
  • Bạn nên xác định các thuộc tính gián đoạn thông báo trên cơ sở từng kênh.
  • Bạn phải chỉ định thông báo cho một kênh để thông báo xuất hiện.
  • Phiên bản này của nền tảng hỗ trợ NotificationCompat.Builder.
• Quyền riêng tư
  • ANDROID_ID được giới hạn trên mỗi khoá ký ứng dụng.

Để có danh sách đầy đủ các thay đổi được giới thiệu trên Android 8.0 (API cấp 26), hãy xem trang Các thay đổi về hành vi cho phiên bản nền tảng đó.

Di chuyển từ Android 8 (API 26) sang Android 9 (API 28)

• Quản lý nguồn
  • Nhóm chế độ chờ ứng dụng mang đến các hạn chế mới đối với hoạt động chạy trong nền dựa trên mức độ tương tác với ứng dụng, chẳng hạn như công việc bị tạm hoãn, chuông báo và hạn mức thông báo có mức độ ưu tiên cao
  • Cải tiến trình tiết kiệm pin giúp tăng giới hạn cho ứng dụng ở chế độ chờ
• Quyền của dịch vụ nền trước
  • Cần yêu cầu quyền thông thường FOREGROUND_SERVICE (không phải quyền khi bắt đầu chạy)
• Các thay đổi về quyền riêng tư
  • Hạn chế truy cập cảm biến nền
  • Hạn chế quyền truy cập vào nhật ký cuộc gọi, hiện đã có trong nhóm quyền CALL_LOG
  • Hạn chế quyền truy cập vào số điện thoại, yêu cầu quyền READ_CALL_LOG
  • Hạn chế quyền truy cập vào thông tin Wi-Fi

Để xem danh sách đầy đủ các thay đổi được giới thiệu trong Android 9.0 (API cấp 28), hãy xem phần thay đổi về hành vi.

Di chuyển từ Android 9 (API cấp 28) sang Android 10 (API cấp 29)

• Thông báo có cơ chế toàn màn hình
  • Cần yêu cầu quyền thông thường USE_FULL_SCREEN_INTENT (không phải quyền khi bắt đầu chạy).
• Hỗ trợ thiết bị có thể gập và thiết bị có màn hình lớn
  • Hiện tại, nhiều hoạt động có thể được đặt ở trạng thái "đã tiếp tục" cùng lúc, nhưng thực sự chỉ một hoạt động có trọng tâm.
    • Thay đổi này ảnh hưởng đến hành vi của onResume() và của onPause().
    • Bạn có thể phát hiện một khái niệm mới về vòng đời là "đã tiếp tục ở trên cùng" bằng cách đăng ký onTopResumedActivityChanged().
      • Chỉ một hoạt động có thể ở vào trạng thái "đã tiếp tục ở trên cùng".
  • Thời điểm resizeableActivity được đặt thành false, các ứng dụng có thể chỉ định thêm một minAspectRatio, có chức năng tự động tạo hòm thư ở một tỷ lệ khung hình hẹp hơn.
• Các thay đổi về quyền riêng tư
  • Bộ nhớ có giới hạn
    • Quyền truy cập vào bộ nhớ ngoài chỉ giới hạn ở một thư mục dành riêng cho ứng dụng và các loại nội dung nghe nhìn cụ thể mà ứng dụng tạo ra.
  • Hạn chế quyền truy cập vào vị trí khi ứng dụng chạy ở chế độ nền, yêu cầu quyền ACCESS_BACKGROUND_LOCATION.
  • Hạn chế quyền truy cập vào giá trị nhận dạng không thể đặt lại như IMEI và số sê-ri.
  • Hạn chế quyền truy cập vào thông tin về hoạt động thể chất, chẳng hạn như số bước của người dùng, yêu cầu quyền ACTIVITY_RECOGNITION.
  • Hạn chế quyền truy cập vào một số API điện thoại, Bluetooth và Wi-Fi, yêu cầu quyền ACCESS_FINE_LOCATION.
  • Hạn chế quyền truy cập vào phần cài đặt Wi-Fi
    • Các ứng dụng không thể bật hoặc tắt Wi-Fi trực tiếp nữa và cần thực hiện việc này bằng các bảng điều khiển cài đặt.
    • Các hạn chế về việc bắt đầu một kết nối tới mạng Wi-Fi, yêu cầu sử dụng WifiNetworkSpecifier hoặc WifiNetworkSuggestion.

Di chuyển từ Android 10 (API cấp 29) sang Android 11 (API cấp 30)

• Quyền tiêng tư
  • Thực thi bộ nhớ có giới hạn: Ứng dụng nên sử dụng mô hình bộ nhớ có giới hạn mà các loại tệp dành riêng cho ứng dụng, tệp nội dung nghe nhìn và các loại tệp khác được lưu và truy cập thông qua các vị trí chuyên dụng.
  • Tự động đặt lại quyền: Nếu người dùng không tương tác với ứng dụng trong vài tháng, thì hệ thống sẽ tự động đặt lại các quyền truy cập thông tin nhạy cảm của ứng dụng đó. Điều này sẽ không ảnh hưởng đến hầu hết các ứng dụng. Nếu ứng dụng của bạn chủ yếu hoạt động ở chế độ nền mà không có tương tác của người dùng, bạn có thể xem xét việc yêu cầu người dùng tắt tính năng tự động đặt lại.
  • Quyền truy cập thông tin vị trí ở chế độ nền: Ứng dụng phải yêu cầu cấp quyền truy cập thông tin vị trí ở chế độ nền và chế độ nền trước một cách riêng biệt. Bạn chỉ có thể thực hiện việc cấp quyền truy cập thông tin vị trí ở chế độ nền trong phần cài đặt ứng dụng thay vì hộp thoại quyền khi bắt đầu chạy.
  • Chế độ hiển thị gói: Khi truy vấn một ứng dụng về danh sách các ứng dụng và dịch vụ đã cài đặt trên thiết bị, danh sách trả về sẽ được lọc.
    • Nếu sử dụng các dịch vụ Chuyển văn bản sang lời nói hoặc Nhận dạng lời nói, bạn cần thêm các phần tử cho dịch vụ vào tệp kê khai.
• Bảo mật
  • Các tệp `resource.arsc` được nén không còn được hỗ trợ
  • Hiện bắt buộc sử dụng Lược đồ chữ ký APK phiên bản 2. Để đảm bảo khả năng tương thích ngược, các nhà phát triển cũng nên tiếp tục ký bằng Lược đồ chữ ký APK phiên bản 1.
  • Hạn chế đối với giao diện không phải SDK. Bạn không nên sử dụng giao diện không phải SDK cho ứng dụng nhắm mục tiêu API cấp 30 vì một số giao diện không phải SDK này hiện đã bị chặn. Xem Các giao diện không phải SDK hiện đã bị chặn trên Android 11 để biết danh sách đầy đủ các giao diện không phải SDK bị chặn.

Để xem danh sách đầy đủ các thay đổi được giới thiệu trên Android 11 (API cấp 30), hãy xem trang Các thay đổi về hành vi.

Hãy tiếp tục cập nhật lên API 31 bằng cách làm theo các hướng dẫn trong phần trước.