設定 Google Play 服務

使用 Google Play 服務開發應用程式 ,請按照本頁的操作說明進行設定 讓您的專案使用相關 SDK, Google Maven 存放區

如要在使用 Google Play 服務時測試應用程式,您必須使用 包括:

  • 搭載 Android 6.0 (API) 的相容 Android 裝置 第 23 級),並已安裝 Google Play 商店應用程式 已安裝。
  • Android Emulator,當中 執行 Google API 的 AVD 平台。

宣告 Google Play 服務的依附元件

如要開發需要在應用程式中使用 Google Play 服務 API 的功能, 請完成下列步驟:

  1. 開啟應用程式模組目錄中的 build.gradle 檔案。

  2. 針對應用程式所需的每個 SDK,納入該 SDK 的依附元件。 本頁面的章節列出了常見的 Google Play 服務 依附元件。另外,我們也建議您新增 Firebase 的依附元件 專案

  3. 儲存變更並同步您的 專案

以下程式碼片段是採用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 服務會在 Android 裝置上收到自動更新 6.0 (API 級別 23) 以上版本 透過 Google Play 商店應用程式即可。不過未安裝 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 服務依附元件

下表列出了 Google Play 服務的依附元件 包括您的 Android 應用程式如要依裝置類型篩選清單,請選取 搜尋特定用途或依附元件 在按鈕後方的方塊中輸入文字。

表 1. 要包含的 Google Play 服務依附元件 Android 應用程式
用途和依附元件名稱 支援的裝置
Google 行動廣告
com.google.android.gms:play-services-ads:23.2.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.2.0
手機、平板電腦
AdSense 搜尋廣告 (AFS) 自訂搜尋廣告 (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
手機、平板電腦、ChromeOS
Android 專用的 Google Analytics Services SDK
com.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
AppSearch
com.google.android.gms:play-services-appsearch:16.0.0
手機、平板電腦、Android TV
Android 應用程式組 ID
com.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 API
com.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.3.1
手機、平板電腦、Android Go、ChromeOS
Google Awareness API
com.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 Cast
com.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) 以上版本的裝置。
Android 版 Google Fit API行動裝置上的錄製 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.2
手機、平板電腦、Android TV、Android Go、ChromeOS
適用於 Android 的 Google Play 遊戲服務第 2 版原生 C SDK
com.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 API
com.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 Android
com.google.android.gms:play-services-maps:19.0.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 API
com.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 API
com.google.android.gms:play-services-tflite-gpu:16.2.0
手機、平板電腦、Android Go、ChromeOS
適用於 Google Play 服務的 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
手機、平板電腦、Android Go、ChromeOS
Google Play 服務適用的 TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.1.0
手機、平板電腦、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.1
手機、平板電腦
Mobile Vision
com.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 API
com.google.android.gms:play-services-wearable:18.2.0
手機、平板電腦、Wear OS

Gradle 外掛程式

Google Play 服務也包含數個 Gradle 外掛程式,如 資料表。請注意,上一表格前顯示的按鈕 請勿變更這個表格中顯示的資訊。

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