Google Play yêu cầu target API 36: dev app Việt cần làm gì

Từ ngày 31/8/2026, mọi ứng dụng mới và bản cập nhật gửi lên Google Play phải đặt targetSdkVersion từ Android 16 (API 36) trở lên. Ứng dụng đã phát hành mà target thấp hơn Android 15 (API 35) sẽ không còn hiện với người dùng mới trên máy chạy Android đời mới hơn. Thời hạn gia hạn tối đa Google cho phép là 1/11/2026, nên tới giữa tháng 11 này, app nào chưa cập nhật coi như đã quá hạn và cần xử lý ngay.

Yêu cầu chính xác theo từng nền tảng

Bảng sau tổng hợp từ trang trợ giúp Play Console về yêu cầu target API:

Chính trang trợ giúp cũng có chỗ ghi số liệu không hoàn toàn khớp giữa các mục (ví dụ Automotive), nên hãy đối chiếu với thông báo trong Play Console của chính ứng dụng trước khi chốt.

Ngoại lệ duy nhất được nêu là ứng dụng riêng tư vĩnh viễn, chỉ phân phối nội bộ cho người dùng trong một tổ chức.

Điều gì xảy ra với app không đạt chuẩn

Nhiều người hiểu nhầm rằng app sẽ bị gỡ khỏi Play. Thực tế nhẹ hơn nhưng vẫn ảnh hưởng tới tăng trưởng:

• App không hiện với người dùng mới trên thiết bị chạy phiên bản Android cao hơn target của app.
• Người dùng mới mở link cửa hàng sẽ thấy thông báo app được làm cho phiên bản Android cũ hơn.
• Người đã cài vẫn tìm thấy, cài lại và dùng bình thường.
• Thiết bị chạy Android bằng hoặc thấp hơn target vẫn tải được.

Với app bán hàng, app đặt lịch hay app ngân hàng mini của doanh nghiệp Việt, phần lớn người dùng mới mua máy năm 2025–2026 chạy Android 15, 16. Không hiện trên những máy này đồng nghĩa với mất gần hết lượt cài mới.

Hạn gia hạn 1/11/2026 đã qua

Theo trang yêu cầu target SDK trên Android Developers, nhà phát triển cần thêm thời gian được phép xin gia hạn tới 1/11/2026, qua biểu mẫu trong Play Console. Biểu mẫu nằm trong mục Notifications hoặc trang chi tiết cảnh báo ở Policy status. Mốc này đã trôi qua, nên lựa chọn còn lại là cập nhật target API, hoặc gỡ app nếu không còn duy trì.

Quy trình nâng target API cho đội nhỏ

Bước 1: kiểm tra trạng thái trong Play Console

Vào Policy status xem app có cảnh báo target API không. Chỉ những app không đạt chuẩn mới nhận cảnh báo, nên đây là cách nhanh nhất để biết danh sách app cần xử lý nếu tài khoản có nhiều app.

Bước 2: rà thư viện bên thứ ba

Trang Android Developers nhấn mạnh việc kiểm tra SDK phụ thuộc: một số nhà cung cấp ghi rõ mức API hỗ trợ trong manifest, số khác phải tìm hiểu thêm. Với app Việt, nhóm cần xem kỹ thường là SDK thanh toán, SDK eKYC, SDK quảng cáo và push notification. Nếu SDK chưa hỗ trợ API 36, liên hệ nhà cung cấp sớm vì đây thường là điểm nghẽn mất nhiều thời gian nhất.

Bước 3: đọc danh sách thay đổi hành vi

Mỗi bản Android có trang behavior changes riêng. Nếu app đang target API 34, bạn cần đi qua thay đổi của cả Android 15 và Android 16; nếu thấp hơn nữa thì cộng dồn từng bản. Đừng chỉ đổi con số trong file Gradle rồi build.

Bước 4: đổi targetSdkVersion và kiểm thử

Đổi giá trị trong file Gradle của module app. Sau đó kiểm thử theo gợi ý của Google, gồm:

• Vào App Info tắt từng quyền, mở lại app và đảm bảo không crash, các luồng chính hỏi lại quyền đúng chỗ.
• Đưa máy vào chế độ Doze bằng adb khi app đang chạy, kiểm tra thông báo đẩy, alarm và job nền.
• Thử luồng chia sẻ file sang app khác.
• Thử trên ít nhất một máy hoặc emulator Android 16 thật, một máy tầm trung đời cũ.

Nếu app có backend riêng, đây cũng là lúc kiểm tra lại API mà app gọi tới. Các nguyên tắc thiết kế trong bài xây dựng API RESTful cho ứng dụng mobile giúp tách thay đổi phía client khỏi phía server, giảm rủi ro khi phát hành.

Bước 5: phát hành theo giai đoạn

Dùng staged rollout trong Play Console, bắt đầu với tỷ lệ nhỏ, theo dõi tỷ lệ crash và ANR vài ngày rồi mới mở rộng. Kiểm thử API trước khi phát hành có thể tự động hóa bằng bộ collection như hướng dẫn trong bài dùng Postman kiểm thử API.

Ứng dụng React Native, Flutter thì sao

Yêu cầu áp dụng cho file APK hoặc AAB cuối cùng, không phân biệt công nghệ. Với framework đa nền tảng, việc nâng target thường đi kèm nâng phiên bản framework, Gradle plugin và các plugin native. Nên làm trên một nhánh riêng, cập nhật từng lớp một và chạy lại toàn bộ test trước khi gộp vào nhánh chính.

Agency quản lý nhiều app khách hàng nên làm gì

Các công ty gia công phần mềm tại Việt Nam thường giữ hàng chục app của khách trong nhiều tài khoản Play Console. Với tình huống này, kiểm kê là bước tốn công nhất. Một bảng theo dõi tối thiểu nên có: tên app, tài khoản Play Console, target API hiện tại, ngày phát hành bản gần nhất, công nghệ (native, Flutter, React Native), danh sách SDK bên thứ ba và người phụ trách phía khách hàng.

Sau đó chia app thành ba nhóm: app còn hoạt động và có ngân sách bảo trì (cập nhật ngay), app còn người dùng nhưng khách chưa ký hợp đồng bảo trì (gửi thông báo kèm báo giá, nêu rõ app sẽ không hiện với người dùng mới trên máy đời mới), và app đã ngừng kinh doanh (đề xuất gỡ để tránh cảnh báo chính sách kéo dài). Việc nói rõ hậu quả bằng ngôn ngữ kinh doanh, như mất lượt cài mới, giúp khách ra quyết định nhanh hơn nhiều so với giải thích con số API.

Chuẩn bị cho vòng sau

Google nâng mức target API mỗi năm, thường với hạn cuối tháng 8. Thay vì dồn việc vào phút chót, nhiều đội đặt lịch cố định: khi Android bản mới ra, tạo nhánh thử target mới trong vòng một quý, theo dõi SDK nào chưa tương thích. Khi hạn tới, phần lớn việc đã xong và bản phát hành chỉ còn là thủ tục.