設定 Google Play 服務

Stay organized with collections Save and categorize content based on your preferences.

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

如要在使用 Google Play 服務時測試應用程式,您必須使用下列其中一種方法:

  • 搭載 Android 4.4 (API 級別 19) 或以上版本,且已安裝 Google Play 商店應用程式的相容 Android 裝置。
  • 具有 AVD 的 Android 模擬器,執行以 Android 4.4 (API 級別 19) 或以上版本為基礎的 Google API 平台。

宣告 Google Play 服務的依附元件

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

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

  2. 針對應用程式所需的每個 SDK,加入該 SDK 的依附元件。本頁包含 Android 應用程式常見的 Google Play 服務依附元件一節。您還可以將 Firebase 依附元件新增至專案

  3. 儲存變更,然後同步處理專案

下列程式碼片段示範使用位置資料庫的 build.gradle 檔案範例:

apply plugin: 'com.android.application'

...

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

系統會定期發布新版的 Google Play 服務 SDK 修正錯誤和新功能。這些更新會在版本資訊中公布。如果您的應用程式使用了已更新的依附元件,請變更為應用程式依附元件中的最新版本,以善用這些修正。

檢查是否已安裝 Google Play 服務

Google Play 服務總覽中所述,Google Play 服務會透過 Google Play 商店應用程式接收 Android 4.4 (API 級別 19) 以上版本的自動更新。不過,沒有 Google Play 商店的 Android 裝置並未安裝 Google Play 服務。如果您的應用程式在沒有 Google Play 服務的裝置上執行,建議您在使用 Google API 之前,先檢查裝置是否已安裝 Google Play 服務,或在應用程式中啟用需要 Google Play 服務的功能。

如要檢查裝置是否存在 Google Play 服務,請使用 isGooglePlayServicesAvailable() 方法。

若要開始與 Google Play 服務連線,或瞭解如何偵測已安裝的 Google Play 服務版本是否支援特定 API,請參閱存取 Google API 指南。

Google Play 服務依附元件

下表列出可在 Android 應用程式中加入的 Google Play 服務依附元件。您可以選取各種按鈕,根據裝置類型篩選清單。您可以在按鈕下方顯示的方塊中輸入文字,搜尋特定用途或依附元件名稱。

表 1. 要包含在 Android 應用程式中的 Google Play 服務依附元件
用途和依附元件名稱 支援的裝置
Google 行動廣告
com.google.android.gms:play-services-ads:21.5.0
手機、平板電腦
Android 廣告 ID (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
手機、平板電腦、Android TV、Chrome OS
精簡版 Google 行動廣告
com.google.android.gms:play-services-ads-lite:21.5.0
手機、平板電腦
AdSense 搜尋廣告 (AFS) 自訂搜尋廣告 (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
手機、平板電腦、Chrome OS
Google Analytics (分析) Services SDK Android 版
com.google.android.gms:play-services-analytics:18.0.2
已淘汰。請改用 Google Analytics for Firebase
應用程式索引
com.google.android.gms:play-services-appindex:16.1.0
手機、平板電腦、Android TV
Android 應用程式組 ID
com.google.android.gms:play-services-appset:16.0.2
手機、平板電腦、Android TV、Chrome OS
Android 適用的 Google 登入
com.google.android.gms:play-services-auth:20.4.1
手機、平板電腦、Android TV、自動、Android Go、ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.0.1
手機、平板電腦、Android Go
Block Store API (包含使用者憑證儲存空間)
com.google.android.gms:play-services-auth-blockstore:16.1.0
手機、平板電腦、Android Go、ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
手機、平板電腦、自動、Android Go、ChromeOS
公用程式類別
com.google.android.gms:play-services-base:18.1.0
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
測試公用程式類別的假設定
com.google.android.gms:play-services-base-testing:16.0.0
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
其他公用程式類別
com.google.android.gms:play-services-basement:18.1.0
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
手機、平板電腦、Android Go、ChromeOS
Google Cast 應用程式架構 (CAF)
com.google.android.gms:play-services-cast-framework:21.2.0
手機、平板電腦、Android Go、ChromeOS
Android TV 接收器
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
Google 程式碼掃描器
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
手機、平板電腦、Android Go、ChromeOS
Chromium 網路堆疊 (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
裝置對裝置互動 (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
手機、平板電腦、Android Go
Fast IDentity Online (FIDO) 驗證
com.google.android.gms:play-services-fido:19.0.1
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS

支援搭載 Android 7.0 (API 級別 24) 以上版本的裝置。
Google Fit API for Android
com.google.android.gms:play-services-fitness:21.1.0
手機、平板電腦、Android Go、ChromeOS、Wear OS
Google Play 遊戲服務第 2 版 (Android)
com.google.android.gms:play-services-games-v2:17.0.0
手機、平板電腦、Android TV、Android Go、ChromeOS
Google Play 遊戲服務第 2 版 Android 原生 C SDK
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
手機、平板電腦、Android TV、Android Go、ChromeOS
Google Play 遊戲服務第 1 版 (Android 版)
com.google.android.gms:play-services-games:23.1.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.0.1
手機、平板電腦、Android TV、Android Go、ChromeOS

支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。
Android 整合式位置預測提供工具 (包含活動辨識與地理圍欄)
com.google.android.gms:play-services-location:21.0.1
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
Google Maps SDK for Android
com.google.android.gms:play-services-maps:18.1.0
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
機器學習套件條碼掃描功能
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0
手機、平板電腦、Android Go、ChromeOS
機器學習套件臉部偵測
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
手機、平板電腦、Android Go、ChromeOS
機器學習套件圖片標籤
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-beta4
手機、平板電腦、Android Go、ChromeOS
機器學習套件語言識別
com.google.android.gms:play-services-mlkit-language-id:17.0.0
手機、平板電腦、Android Go、ChromeOS
機器學習套件智慧回覆
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
手機、平板電腦、Android Go、ChromeOS
機器學習套件文字辨識
com.google.android.gms:play-services-mlkit-text-recognition:18.0.2
手機、平板電腦、Android Go、ChromeOS
鄰近裝置探索與連線
com.google.android.gms:play-services-nearby:18.4.0
手機、平板電腦、Android TV、自動、Android Go
顯示開放原始碼授權
com.google.android.gms:play-services-oss-licenses:17.0.0
手機、平板電腦、Android TV、自動、Android Go、ChromeOS
支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。
螢幕鎖定品質檢查
com.google.android.gms:play-services-password-complexity:18.0.1
手機、平板電腦、Android Go、ChromeOS、Wear OS

支援搭載 Android 4.4 (API 級別 19) 至 Android 9 (API 級別 28) 的裝置。
Google Pay 票證功能
com.google.android.gms:play-services-pay:16.1.0
手機、平板電腦、Android Go、ChromeOS

支援搭載 Android 5.0 (API 級別 20) 或以上版本的裝置。
用於檢測設備的 ReCAPTCHA Enterprise
com.google.android.gms:play-services-recaptcha:17.0.1
手機、平板電腦、Android TV、Android Go、ChromeOS
SafetyNet API (包括裝置認證、安全瀏覽、reCAPTCHA 和應用程式驗證)
com.google.android.gms:play-services-safetynet:18.0.1
手機、平板電腦、Android TV、自動、Android Go、ChromeOS
Google 代碼管理工具
com.google.android.gms:play-services-tagmanager:18.0.2
手機、平板電腦、Android TV、Android Go、ChromeOS
Tasks API (Android)
com.google.android.gms:play-services-tasks:18.0.2
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS
適用於 Google Play 服務的 TensorFlow Lite GPU Delegate API
com.google.android.gms:play-services-tflite-gpu:16.1.0
手機、平板電腦、Android Go、ChromeOS
適用於 Google Play 服務的 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.0.1
手機、平板電腦、Android Go、ChromeOS
適用於 Google Play 服務的 TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.0.1
手機、平板電腦、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
手機、平板電腦
行動視覺
com.google.android.gms:play-services-vision:20.1.3
手機、平板電腦、Android Go、ChromeOS
在 Android 裝置上使用 Google Pay 付款
com.google.android.gms:play-services-wallet:19.1.0
手機、平板電腦、自動、Android Go、ChromeOS、Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.0.0
手機、平板電腦、Wear OS

Gradle 外掛程式

Google Play 服務也包含數個 Gradle 外掛程式,如下表所示。請注意,在前一個表格之前顯示的按鈕不會變更此表格中顯示的資訊。

表 2. Google Play 服務內含的 Gradle 外掛程式清單
用途和 Gradle 外掛程式名稱 支援的裝置
顯示開放原始碼授權
com.google.android.gms:oss-licenses-plugin:0.10.6
手機、平板電腦、Chrome OS
嚴格版本檢查
com.google.android.gms:strict-version-matcher-plugin:1.2.4
手機、平板電腦、Android TV、自動、Android Go、ChromeOS、Wear OS