Để phát triển một ứng dụng bằng cách sử dụng Dịch vụ Google Play API, 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ữ Google Maven.
Để 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 Google API dựa trên Android 6.0 (cấp độ API 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:
Mở tệp
build.gradlebên trong thư mục mô-đun của ứng dụng.Đố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 phổ biến của Dịch vụ Google Play cho ứng dụng Android. Bạn cũng có thể muốn thêm Firebase vào dự án.
Lưu các thay đổi và đồng bộ hoá dự án.
Đoạn mã sau đây cho thấy một ví dụ về tệp build.gradle 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 bản 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 chuyển sang 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 những bản sửa lỗi này.
Kiểm tra xem Dịch vụ Google Play đã được cài đặt hay chưa
Như mô tả trong bài viết Tổng quan về Dịch vụ Google Play , Dịch vụ Google Play sẽ tự động cập nhật trên Android 6.0 (cấp độ API 23) trở lên thông qua ứng dụng Cửa hàng Google Play. Tuy nhiên, các thiết bị 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 luôn phải kiểm tra xem Dịch vụ Google Play đã được cài đặt hay chưa trước khi cố gắng sử dụng Google API hoặc bật các tính năng yêu cầu Dịch vụ Google Play.
Để kiểm tra sự hiện diện của Dịch vụ Google Play trên thiết bị, hãy sử dụng
isGooglePlayServicesAvailable()
phương thức.
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ề Cách truy cập Google API.
Phần phụ thuộc của Dịch vụ Google Play
Bảng sau đây liệt kê các phần phụ thuộc của 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 và 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.
| Trường hợp sử dụng và tên phần phụ thuộc | Thiết bị được hỗ trợ |
|---|---|
Quảng cáo trên thiết bị di động của Googlecom.google.android.gms:play-services-ads:25.1.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.3.0 |
Điện thoại, Máy tính bảng, Android TV, ChromeOS |
Phiên bản gọn nhẹ của Quảng cáo trên thiết bị di động của Googlecom.google.android.gms:play-services-ads-lite:24.8.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 cho Androidcom.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ụngcom.google.android.gms:play-services-appindex:16.2.0 |
Điện thoại, Máy tính bảng, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Điện thoại, Máy tính bảng, Android TV |
Mã nhóm ứng dụng Androidcom.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 Androidcom.google.android.gms:play-services-auth:21.5.1 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.3.0 |
Điện thoại, Máy tính bảng, Android Go |
Block Store API (bao gồm vùng lưu trữ 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 Googlecom.google.android.gms:play-services-awareness:20.0.0 |
Điện thoại, Máy tính bảng, Auto, Android Go, ChromeOS |
Lớp tiện íchcom.google.android.gms:play-services-base:18.10.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Kiểm thử các bản sao cho lớp tiện íchcom.google.android.gms:play-services-base-testing:16.2.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Lớp tiện ích kháccom.google.android.gms:play-services-basement:18.10.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Tăng cường ánh sáng yếu cho máy ảnhcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07 |
Điện thoại, Máy tính bảng |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
Đ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.3.1 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
Trình quét mã của Googlecom.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.1 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Tương tác giữa thiết bị với 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 |
SDK Key Verifiercom.google.android.gms:contactkeys:16.0.0 |
Điện thoại, Máy tính bảng |
Xác thực Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.2.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS Được hỗ trợ trên các thiết bị chạy Android 7.0 (cấp độ API 24) trở lên. |
Google Fit API cho Android và Recording API trên thiết bị di động (đối với dữ liệu thể chất của người dùng)com.google.android.gms:play-services-fitness:21.3.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 Androidcom.google.android.gms:play-services-games-v2:21.0.0 |
Đ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 cho Androidcom.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 cho Androidcom.google.android.gms:play-services-games:24.0.0 |
Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
Điện thoại, Máy tính bảng |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.2.0 |
Không dùng nữa. Xem Google Play Instant để biết thêm thông tin. |
Dịch vụ vị trí cho Androidcom.google.android.gms:play-services-location:21.3.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Maps SDK cho Androidcom.google.android.gms:play-services-maps:20.0.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps 3D cho Androidcom.google.android.gms:play-services-maps3d:0.2.0 |
Điện thoại, Máy tính bảng |
Tăng cường hiệu ứng nội dung đa phương tiệncom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03 |
Điện thoại, Máy tính bảng |
Quét mã vạch bằng Bộ công cụ học máycom.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 bằng Bộ công cụ học máycom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Đ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áycom.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áycom.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áycom.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áycom.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 bằng Bộ công cụ học máycom.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 đối tượng bằng Bộ công cụ học máycom.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áycom.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 Trungcom.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 tiếng Devanagaricom.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ậtcom.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àncom.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 |
Tìm và kết nối với thiết bị ở gầncom.google.android.gms:play-services-nearby:19.3.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go |
Hiện giấy phép nguồn mởcom.google.android.gms:play-services-oss-licenses:17.5.0 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS Được hỗ trợ trên các thiết bị chạy Android 5.0 (cấp độ API 21) trở lên. |
Thư viện truy cập có lập trình (PAL)com.google.android.gms:play-services-pal:23.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 (cấp độ API 21) trở lên. |
Kiểm tra chất lượng 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 Được hỗ trợ trên các thiết bị chạy Android 4.4 (cấp độ API 19) đến Android 9 (cấp độ API 28). |
Google Wallet (trước đây là Google Pay cho thẻ)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 (cấp độ API 20) trở lên. |
reCAPTCHA Enterprise để đo lường ứng dụngcom.google.android.gms:play-services-recaptcha:17.1.0 |
Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS |
SafetyNet API (bao gồm tính năng duyệt web an toàn 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, Auto, Android Go, ChromeOS |
Trình quản lý thẻ của Googlecom.google.android.gms:play-services-tagmanager:18.3.0 |
Điện thoại, Máy tính bảng, Android TV, Android Go, ChromeOS |
API Tasks trên Androidcom.google.android.gms:play-services-tasks:18.4.1 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Dịch vụ tăng tốc cho Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API cho Dịch vụ Google Playcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
TensorFlow Lite Java API cho Dịch vụ Google Playcom.google.android.gms:play-services-tflite-java:16.4.0 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
TensorFlow Lite Support API cho Dịch vụ Google Playcom.google.android.gms:play-services-tflite-support:16.4.0 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Điện thoại, Máy tính bảng |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
Điện thoại, Máy tính bảng, Auto, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
Điện thoại, Máy tính bảng, Android Go, ChromeOS |
Google Pay cho thanh toán trên Androidcom.google.android.gms:play-services-wallet:19.5.0 |
Điện thoại, Máy tính bảng, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.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.
| Trường hợp sử dụng và tên trình bổ trợ Gradle | Thiết bị được hỗ trợ |
|---|---|
Hiện giấy phép nguồn mởcom.google.android.gms:oss-licenses-plugin:0.11.0 |
Điện thoại, Máy tính bảng, ChromeOS |
Kiểm tra phiên bản nghiêm ngặtcom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Điện thoại, Máy tính bảng, Android TV, Auto, Android Go, ChromeOS, Wear OS |