Thiết lập Dịch vụ Google Play

Để phát triển ứng dụng bằng API của Dịch vụ Google Play, hãy làm theo hướng dẫn trên trang này để thiết lập dự án bằng các SDK có liên quan. Các SDK này có trong kho lưu trữ maven của Google.

Để kiểm thử ứng dụng khi sử dụng Dịch vụ Google Play, bạn phải sử dụng một trong những cách sau:

• Một thiết bị Android tương thích chạy Android 6.0 (API cấp 23) trở lên và đã cài đặt ứng dụng Cửa hàng Google Play.
• Trình mô phỏng Android có AVD chạy nền tảng API của Google dựa trên Android 6.0 (API cấp 23) trở lên.

Khai báo phần phụ thuộc cho Dịch vụ Google Play

Để phát triển các tính năng phụ thuộc vào API Dịch vụ Google Play trong ứng dụng, hãy hoàn thành các bước sau:

1. Mở tệp build.gradle bên trong thư mục mô-đun của ứng dụng.

   Lưu ý: Các dự án Android Studio chứa một tệp build.gradle cấp cao nhất và một tệp build.gradle cho mỗi mô-đun. Hãy nhớ chỉnh sửa tệp cho mô-đun của ứng dụng. Tìm hiểu thêm về cách tạo dự án bằng Gradle.

2. Đối với mỗi SDK mà ứng dụng của bạn yêu cầu, hãy thêm phần phụ thuộc cho SDK đó. Trang này có một phần liệt kê các phần phụ thuộc Dịch vụ Google Play phổ biến cho ứng dụng Android. Bạn cũng nên thêm các phần phụ thuộc Firebase vào dự án.

3. Lưu các thay đổi và đồng bộ hoá dự án của bạn.

Đoạn mã sau đây cho thấy một tệp build.gradle mẫu sử dụng thư viện vị trí:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

Các phiên bản mới của SDK Dịch vụ Google Play có bản sửa lỗi và tính năng mới được phát hành định kỳ. Những nội dung cập nhật này được công bố trong ghi chú phát hành. Nếu ứng dụng của bạn sử dụng một phần phụ thuộc đã được cập nhật, hãy thay đổi thành phiên bản mới nhất trong các phần phụ thuộc của ứng dụng để tận dụng các bản sửa lỗi này.

Lưu ý: Để giữ lại các lớp bắt buộc, mỗi SDK Dịch vụ Google Play đều bao gồm các lệnh hướng dẫn R8 về cách tối ưu hoá ứng dụng.

Kiểm tra xem bạn đã cài đặt Dịch vụ Google Play hay chưa

Như mô tả trong phần Tổng quan về Dịch vụ Google Play, Dịch vụ Google Play sẽ nhận được bản cập nhật tự động trên Android 6.0 (API cấp 23) trở lên thông qua ứng dụng Cửa hàng Google Play. Tuy nhiên, các thiết bị Android không có Cửa hàng Google Play sẽ không cài đặt được Dịch vụ Google Play. Nếu ứng dụng của bạn chạy trên các thiết bị không có Dịch vụ Google Play, bạn nên kiểm tra xem thiết bị đó đã cài đặt Dịch vụ Google Play hay chưa trước khi cố gắng sử dụng API của Google hoặc bật các tính năng trong ứng dụng cần có Dịch vụ Google Play để hoạt động.

Để kiểm tra xem Dịch vụ Google Play có trên thiết bị hay không, hãy sử dụng phương thức isGooglePlayServicesAvailable().

Sau đó, để bắt đầu kết nối với Dịch vụ Google Play hoặc tìm hiểu cách phát hiện xem phiên bản Dịch vụ Google Play đã cài đặt có hỗ trợ một API cụ thể hay không, hãy đọc hướng dẫn về Truy cập vào các API của Google.

Phần phụ thuộc Dịch vụ Google Play

Bảng sau đây liệt kê các phần phụ thuộc cho dịch vụ Google Play mà bạn có thể đưa vào ứng dụng Android. Bạn có thể lọc danh sách theo loại thiết bị bằng cách chọn một trong các nút, đồng thời có thể tìm kiếm một trường hợp sử dụng hoặc tên phần phụ thuộc cụ thể bằng cách nhập văn bản vào hộp xuất hiện sau các nút.

Điện thoại và máy tính bảng Android TV Auto Android Go ChromeOS Wear OS

Bảng 1. Các phần phụ thuộc Dịch vụ Google Play cần đưa vào ứng dụng Android

Trường hợp sử dụng và tên phần phụ thuộc	Thiết bị được hỗ trợ
Google Mobile Ads com.google.android.gms:play-services-ads:23.5.0	Điện thoại, máy tính bảng
Mã nhận dạng cho quảng cáo trên Android (AAID) com.google.android.gms:play-services-ads-identifier:18.1.0	Điện thoại, máy tính bảng, Android TV, ChromeOS
Phiên bản gọn nhẹ của Google Mobile Ads com.google.android.gms:play-services-ads-lite:23.5.0	Điện thoại, máy tính bảng
Quảng cáo tìm kiếm tuỳ chỉnh (CSA) của AdSense cho Tìm kiếm (AFS) com.google.android.gms:play-services-afs-native:19.1.0	Điện thoại, máy tính bảng, ChromeOS
SDK Dịch vụ Google Analytics dành cho Android com.google.android.gms:play-services-analytics:18.1.1	Không dùng nữa. Thay vào đó, hãy sử dụng Google Analytics cho Firebase.
Chỉ mục ứng dụng com.google.android.gms:play-services-appindex:16.2.0	Điện thoại, máy tính bảng, Android TV
AppSearch com.google.android.gms:play-services-appsearch:16.0.1	Điện thoại, máy tính bảng, Android TV
Mã nhận dạng nhóm ứng dụng Android com.google.android.gms:play-services-appset:16.1.0	Điện thoại, máy tính bảng, Android TV, ChromeOS
Đăng nhập bằng Google cho Android com.google.android.gms:play-services-auth:21.2.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS
SMS Retriever API com.google.android.gms:play-services-auth-api-phone:18.1.0	Điện thoại, Máy tính bảng, Android Go
Block Store API (bao gồm cả bộ nhớ thông tin xác thực của người dùng) com.google.android.gms:play-services-auth-blockstore:16.4.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
API Nhận biết của Google com.google.android.gms:play-services-awareness:19.1.0	Điện thoại, Máy tính bảng, Ô tô, Android Go, ChromeOS
Lớp tiện ích com.google.android.gms:play-services-base:18.5.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Kiểm thử dữ liệu giả cho các lớp tiện ích com.google.android.gms:play-services-base-testing:16.1.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Các lớp tiện ích khác com.google.android.gms:play-services-basement:18.4.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Google Cast com.google.android.gms:play-services-cast:22.0.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Khung ứng dụng Google Cast (CAF) com.google.android.gms:play-services-cast-framework:22.0.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Google Code Scanner com.google.android.gms:play-services-code-scanner:16.1.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Ngăn xếp mạng Chromium (Cronet) com.google.android.gms:play-services-cronet:18.1.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Tương tác giữa các thiết bị (DTDI) com.google.android.gms:play-services-dtdi:16.0.0-beta02	Điện thoại, Máy tính bảng, Android Go
Xác thực Fast IDentity Online (FIDO) com.google.android.gms:play-services-fido:21.1.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS Hỗ trợ trên các thiết bị chạy Android 7.0 (API cấp 24) trở lên.
API Google Fit cho Android và API ghi trên thiết bị di động (dành cho dữ liệu thể chất của người dùng) com.google.android.gms:play-services-fitness:21.2.0	Điện thoại, Máy tính bảng, Android Go, ChromeOS, Wear OS
Dịch vụ trò chơi của Google Play phiên bản 2 cho Android com.google.android.gms:play-services-games-v2:20.1.2	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS
SDK C gốc phiên bản 2 cho Dịch vụ trò chơi của Google Play dành cho Android com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS
Dịch vụ trò chơi của Google Play phiên bản 1 dành cho Android com.google.android.gms:play-services-games:23.2.0	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS
Matter API com.google.android.gms:play-services-home:16.0.0	Điện thoại, máy tính bảng
Google Play Instant com.google.android.gms:play-services-instantapps:18.1.0	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS Được hỗ trợ trên các thiết bị chạy Android 5.0 (API cấp 21) trở lên.
Dịch vụ vị trí cho Android com.google.android.gms:play-services-location:21.3.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
SDK Google Maps cho Android com.google.android.gms:play-services-maps:19.0.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Quét mã vạch bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Trình quét tài liệu trong Bộ công cụ học máy com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Phát hiện khuôn mặt bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-face-detection:17.1.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Gắn nhãn hình ảnh bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-image-labeling:16.0.8	Điện thoại, máy tính bảng, Android Go, ChromeOS
Gắn nhãn hình ảnh tuỳ chỉnh bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng ngôn ngữ bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-language-id:17.0.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Trả lời thông minh bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Phân đoạn chủ đề trong Bộ công cụ học máy com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng văn bản bằng Bộ công cụ học máy com.google.android.gms:play-services-mlkit-text-recognition:19.0.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng văn bản bằng Bộ công cụ học máy cho tiếng Trung com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng văn bản bằng Bộ công cụ học máy cho chữ Devanagari com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng văn bản bằng Bộ công cụ học máy cho tiếng Nhật com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Nhận dạng văn bản bằng Bộ công cụ học máy cho tiếng Hàn com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1	Điện thoại, máy tính bảng, Android Go, ChromeOS
Khám phá và kết nối thiết bị ở gần com.google.android.gms:play-services-nearby:19.3.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go
Hiển thị giấy phép nguồn mở com.google.android.gms:play-services-oss-licenses:17.1.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS Được hỗ trợ trên các thiết bị chạy Android 5.0 (API cấp 21) trở lên.
Thư viện quyền truy cập có lập trình (PAL) com.google.android.gms:play-services-pal:21.0.0	Điện thoại, Máy tính bảng, Android TV Được hỗ trợ trên các thiết bị chạy Android 5.0 (API cấp 21) trở lên.
Kiểm tra chất lượng phương thức khoá màn hình com.google.android.gms:play-services-password-complexity:18.1.0	Điện thoại, Máy tính bảng, Android Go, ChromeOS, Wear OS Hỗ trợ trên các thiết bị chạy Android 4.4 (API cấp 19) đến Android 9 (API cấp 28).
Google Wallet (trước đây là Google Pay for Passes) com.google.android.gms:play-services-pay:16.5.0	Điện thoại, máy tính bảng, Android Go, ChromeOS Hỗ trợ trên các thiết bị chạy Android 5.0 (API cấp 20) trở lên.
reCAPTCHA Enterprise để đo lường ứng dụng com.google.android.gms:play-services-recaptcha:17.1.0	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS
API SafetyNet (bao gồm chứng thực thiết bị, duyệt web an toàn, reCAPTCHA và xác minh ứng dụng) com.google.android.gms:play-services-safetynet:18.1.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS
Trình quản lý thẻ của Google com.google.android.gms:play-services-tagmanager:18.1.1	Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS
API Tasks trên Android com.google.android.gms:play-services-tasks:18.2.0	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS
Dịch vụ tăng tốc cho Android com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01	Điện thoại, máy tính bảng, Android Go, ChromeOS
API uỷ quyền GPU TensorFlow Lite cho Dịch vụ Google Play com.google.android.gms:play-services-tflite-gpu:16.3.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
TensorFlow Lite Java API cho Dịch vụ Google Play com.google.android.gms:play-services-tflite-java:16.3.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
API hỗ trợ TensorFlow Lite cho Dịch vụ Google Play com.google.android.gms:play-services-tflite-support:16.3.0	Điện thoại, máy tính bảng, Android Go, ChromeOS
Thread Network API com.google.android.gms:play-services-threadnetwork:16.2.1	Điện thoại, máy tính bảng
Tầm nhìn trên thiết bị di động com.google.android.gms:play-services-vision:20.1.3	Điện thoại, máy tính bảng, Android Go, ChromeOS
Google Pay để thanh toán trên Android com.google.android.gms:play-services-wallet:19.4.0	Điện thoại, Máy tính bảng, Ô tô, Android Go, ChromeOS, Wear OS
API Lớp dữ liệu cho thiết bị đeo com.google.android.gms:play-services-wearable:18.2.0	Điện thoại, Máy tính bảng, Wear OS

Trình bổ trợ Gradle

Dịch vụ Google Play cũng bao gồm một số trình bổ trợ Gradle, như trong bảng sau. Xin lưu ý rằng các nút xuất hiện trước bảng trước đó không thay đổi thông tin xuất hiện trong bảng này.

Bảng 2. Danh sách trình bổ trợ Gradle có trong Dịch vụ Google Play

Trường hợp sử dụng và tên trình bổ trợ Gradle	Thiết bị được hỗ trợ
Hiển thị giấy phép nguồn mở com.google.android.gms:oss-licenses-plugin:0.10.6	Điện thoại, máy tính bảng, ChromeOS
Kiểm tra phiên bản nghiêm ngặt com.google.android.gms:strict-version-matcher-plugin:1.2.4	Điện thoại, Máy tính bảng, Android TV, Ô tô, Android Go, ChromeOS, Wear OS