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.

  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.

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 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.

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.5.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 AndroidAPI 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
Tính năng trả lời thông minh của 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 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

Được 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:19.0.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