如要使用 Google Play 服務 API 開發應用程式,請按照本頁的操作說明,使用 Google Maven 存放區中的相關 SDK 設定專案。
如要在使用 Google Play 服務時測試應用程式,請務必使用下列其中一種應用程式:
- 搭載 Android 5.0 (API 級別 21) 以上版本且已安裝 Google Play 商店應用程式的相容 Android 裝置。
- 搭載 AVD 的 Android 模擬器,執行以 Android 5.0 (API 級別 21) 以上版本執行 Google API 平台。
宣告 Google Play 服務的依附元件
如要開發需要在應用程式中使用 Google Play 服務 API 的功能,請完成下列步驟:
開啟應用程式模組目錄中的
build.gradle
檔案。針對應用程式所需的每個 SDK,納入該 SDK 的依附元件。本頁包含一節列出 Android 應用程式常見的 Google Play 服務依附元件。建議您也將 Firebase 依附元件加入專案。
儲存變更,然後同步處理專案。
以下程式碼片段為使用位置程式庫的 build.gradle
檔案範例:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
我們會定期發布包含錯誤修正和新功能的新版 Google Play 服務 SDK。這些更新會公告在版本資訊中。如果應用程式使用的依附元件已更新,請在應用程式依附元件中變更為最新版本,以便善用這些修正方法。
檢查是否已安裝 Google Play 服務
如 Google Play 服務總覽所述,Google Play 服務會透過 Google Play 商店應用程式,在 Android 5.0 (API 級別 21) 以上版本中接收自動更新,但不含 Google Play 商店的 Android 裝置不會安裝 Google Play 服務。如果應用程式在沒有 Google Play 服務的裝置上運作,建議您先檢查裝置是否已安裝 Google Play 服務,再嘗試使用 Google API,或在應用程式中啟用需要 Google Play 服務才能運作的功能。
如要檢查裝置上是否存在 Google Play 服務,請使用 isGooglePlayServicesAvailable()
方法。
如要開始連線至 Google Play 服務,或瞭解如何偵測已安裝的 Google Play 服務版本是否支援特定 API,請參閱存取 Google API 指南。
Google Play 服務依附元件
下表列出可在 Android 應用程式中加入的 Google Play 服務依附元件。選取其中一個按鈕,即可依裝置類型篩選清單,並在按鈕後方的方塊中輸入文字,即可搜尋特定用途或依附元件名稱。
用途和依附元件名稱 | 支援的裝置 |
---|---|
Google 行動廣告com.google.android.gms:play-services-ads:23.1.0 |
手機、平板電腦 |
Android 廣告 ID (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 |
手機、平板電腦、Android TV、ChromeOS |
輕量版 Google 行動廣告com.google.android.gms:play-services-ads-lite:23.1.0 |
手機、平板電腦 |
AdSense 搜尋廣告 (AFS) 自訂搜尋廣告 (CSA)com.google.android.gms:play-services-afs-native:19.1.0 |
手機、平板電腦、ChromeOS |
Android 專用的 Google Analytics (分析) Services SDKcom.google.android.gms:play-services-analytics:18.1.0 |
已淘汰。請改用 Google Analytics for Firebase。 |
應用程式索引com.google.android.gms:play-services-appindex:16.2.0 |
手機、平板電腦、Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.0 |
手機、平板電腦、Android TV |
Android 應用程式組 IDcom.google.android.gms:play-services-appset:16.1.0 |
手機、平板電腦、Android TV、ChromeOS |
Android 版 Google 登入com.google.android.gms:play-services-auth:21.2.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.1.0 |
手機、平板電腦、Android Go |
Block Store API (含使用者憑證儲存空間)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
手機、平板電腦、Android Go、ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.1.0 |
手機、平板電腦、Android Auto、Android Go、ChromeOS |
公用事業類別com.google.android.gms:play-services-base:18.5.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
針對公用事業類別測試假項目com.google.android.gms:play-services-base-testing:16.1.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
更多公用程式類別com.google.android.gms:play-services-basement:18.4.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.5.0 |
手機、平板電腦、Android Go、ChromeOS |
Google Cast 應用程式架構 (CAF)com.google.android.gms:play-services-cast-framework:21.5.0 |
手機、平板電腦、Android Go、ChromeOS |
Android TV 接收器com.google.android.gms:play-services-cast-tv:21.1.0 |
Android TV |
Google 程式碼掃描器com.google.android.gms:play-services-code-scanner:16.1.0 |
手機、平板電腦、Android Go、ChromeOS |
Chromium 網路堆疊 (Cronet)com.google.android.gms:play-services-cronet:18.1.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
裝置對裝置互動 (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
手機、平板電腦、Android Go |
快速 ID 實體線上 (FIDO) 驗證com.google.android.gms:play-services-fido:21.1.0 |
手機、平板電腦、Android TV、Auto、Android Go、ChromeOS、Wear OS 支援搭載 Android 7.0 (API 級別 24) 以上版本的裝置。 |
Google Fit API for Android 和行動裝置上的錄製 API (用於使用者健身資料)com.google.android.gms:play-services-fitness:21.2.0 |
手機、平板電腦、Android Go、ChromeOS、Wear OS |
Android 適用的 Google Play 遊戲服務第 2 版com.google.android.gms:play-services-games-v2:20.1.0 |
手機、平板電腦、Android TV、Android Go、ChromeOS |
適用於 Android 的 Google Play 遊戲服務第 2 版原生 C SDKcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
手機、平板電腦、Android TV、Android Go、ChromeOS |
Android 專用 Google Play 遊戲服務第 1 版com.google.android.gms:play-services-games:23.2.0 |
手機、平板電腦、Android TV、Android Go、ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
手機、平板電腦 |
Google Play 免安裝com.google.android.gms:play-services-instantapps:18.1.0 |
手機、平板電腦、Android TV、Android Go、ChromeOS 支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。 |
Android 定位服務com.google.android.gms:play-services-location:21.3.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
Google Maps SDK for Androidcom.google.android.gms:play-services-maps:18.2.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
ML Kit 條碼掃描com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 文件掃描器com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 臉部偵測com.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 圖片標籤com.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 圖片標籤自訂標籤com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 語言識別com.google.android.gms:play-services-mlkit-language-id:17.0.0 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 智慧回覆com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 主體區隔com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 文字辨識com.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
手機、平板電腦、Android Go、ChromeOS |
ML Kit 文字辨識 (中文)com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
手機、平板電腦、Android Go、ChromeOS |
Devanagari 的 ML Kit 文字辨識com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
手機、平板電腦、Android Go、ChromeOS |
日文的 ML Kit 文字辨識com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
手機、平板電腦、Android Go、ChromeOS |
韓文的 ML Kit 文字辨識com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
手機、平板電腦、Android Go、ChromeOS |
探索鄰近裝置與連線com.google.android.gms:play-services-nearby:19.3.0 |
手機、平板電腦、Android TV、Android Auto、Android Go |
顯示開放原始碼授權com.google.android.gms:play-services-oss-licenses:17.1.0 |
手機、平板電腦、Android TV、Auto、Android Go、ChromeOS 支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。 |
螢幕鎖定品質檢查 com.google.android.gms:play-services-password-complexity:18.1.0 |
手機、平板電腦、Android Go、ChromeOS、Wear OS 支援搭載 Android 4.4 (API 級別 19) 至 Android 9 (API 級別 28) 的裝置。 |
Google 錢包 (舊稱 Google Pay for Passes)com.google.android.gms:play-services-pay:16.5.0 |
手機、平板電腦、Android Go、ChromeOS 支援搭載 Android 5.0 (API 級別 20) 以上版本的裝置。 |
reCAPTCHA Enterprise 用於應用程式檢測com.google.android.gms:play-services-recaptcha:17.1.0 |
手機、平板電腦、Android TV、Android Go、ChromeOS |
SafetyNet API (包括裝置認證、安全瀏覽、reCAPTCHA 和應用程式驗證)com.google.android.gms:play-services-safetynet:18.1.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS |
Google 代碼管理工具com.google.android.gms:play-services-tagmanager:18.1.0 |
手機、平板電腦、Android TV、Android Go、ChromeOS |
Android 上的 Tasks APIcom.google.android.gms:play-services-tasks:18.2.0 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |
Android 加速服務com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
手機、平板電腦、Android Go、ChromeOS |
適用於 Google Play 服務的 TensorFlow Lite GPU Delegate APIcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
手機、平板電腦、Android Go、ChromeOS |
適用於 Google Play 服務的 TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.2.0-beta02 |
手機、平板電腦、Android Go、ChromeOS |
適用於 Google Play 服務的 TensorFlow Lite Support APIcom.google.android.gms:play-services-tflite-support:16.1.0 |
手機、平板電腦、Android Go、ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.1 |
手機、平板電腦 |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
手機、平板電腦、Android Go、ChromeOS |
在 Android 裝置上透過 Google Pay 付款com.google.android.gms:play-services-wallet:19.4.0 |
手機、平板電腦、Android Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.2.0 |
手機、平板電腦、Wear OS |
Gradle 外掛程式
Google Play 服務也包含數個 Gradle 外掛程式,如下表所示。請注意,上表前顯示的按鈕並不會變更這個表格中顯示的資訊。
用途和 Gradle 外掛程式名稱 | 支援的裝置 |
---|---|
顯示開放原始碼授權com.google.android.gms:oss-licenses-plugin:0.10.6 |
手機、平板電腦、ChromeOS |
嚴格版本檢查com.google.android.gms:strict-version-matcher-plugin:1.2.4 |
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS |