設定 Google Play 服務

如要使用 Google Play 服務 API 開發應用程式,請按照本頁面的說明,使用相關 SDK 設定專案。這些 SDK 可從 Google Maven 存放區取得。

如要在使用 Google Play 服務時測試應用程式,您必須使用下列任一項目:

  • 搭載 Android 6.0 (API 級別 23) 以上版本,且已安裝 Google Play 商店應用程式的相容 Android 裝置。
  • Android 模擬器,其中包含執行 Google API 平台 (以 Android 6.0 (API 級別 23) 以上版本為基礎) 的 AVD

宣告 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.3.0'
}

Google Play 服務 SDK 的新版本會定期發布,修正錯誤並加入新功能。這些更新會在版本資訊中發布。如果應用程式使用的依附元件已更新,請在應用程式的依附元件中改用最新版本,以充分利用這些修正。

檢查是否已安裝 Google Play 服務

如「Google Play 服務總覽」一文所述,Android 6.0 (API 級別 23) 以上版本會透過 Google Play 商店應用程式自動更新 Google Play 服務。不過,如果裝置沒有 Google Play 商店,就不會安裝 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 服務依附元件。您可以選取其中一個按鈕,依裝置類型篩選清單,也可以在按鈕後方顯示的方塊中輸入文字,搜尋特定用途或依附元件名稱。

表 1. Android 應用程式中要加入的 Google Play 服務依附元件
用途和依附元件名稱 支援的裝置
Google 行動廣告
com.google.android.gms:play-services-ads:24.4.0
手機、平板電腦
Android 廣告 ID (AAID)
com.google.android.gms:play-services-ads-identifier:18.2.0
手機、平板電腦、Android TV、ChromeOS
Google 行動廣告輕量版
com.google.android.gms:play-services-ads-lite:24.3.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.1
已淘汰。請改用 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.1
手機、平板電腦、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.3.0
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.2.0
手機、平板電腦、Android Go
Block Store API (包括使用者憑證儲存空間)
com.google.android.gms:play-services-auth-blockstore:16.4.0
手機、平板電腦、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.7.2
手機、平板電腦、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.7.1
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS
相機低光源強化
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03
手機、平板電腦
Google Cast
com.google.android.gms:play-services-cast:22.1.0
手機、平板電腦、Android Go、ChromeOS
Google Cast 應用程式架構 (CAF)
com.google.android.gms:play-services-cast-framework:22.1.0
手機、平板電腦、Android Go、ChromeOS
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-beta02
手機、平板電腦、Android Go
Fast IDentity Online (FIDO) 驗證
com.google.android.gms:play-services-fido:21.2.0
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS

支援搭載 Android 7.0 (API 級別 24) 以上版本的裝置。
Android 適用的 Google Fit API行動裝置上的 Recording 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:21.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
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
Android 版 Google Maps SDK
com.google.android.gms:play-services-maps:19.2.0
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS
Android 版 Google Maps 3D SDK
com.google.android.gms:play-services-maps3d:0.0.2
手機、平板電腦
ML Kit 條碼掃描
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
手機、平板電腦、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.1
手機、平板電腦、Android Go、ChromeOS
ML Kit 中文文字辨識
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
手機、平板電腦、Android Go、ChromeOS
ML Kit 梵文字元辨識功能
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
手機、平板電腦、Android Go、ChromeOS
ML Kit 日文文字辨識
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
手機、平板電腦、Android Go、ChromeOS
ML Kit 韓文文字辨識
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
手機、平板電腦、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.2.1
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS
支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。
程式輔助存取權程式庫 (PAL)
com.google.android.gms:play-services-pal:22.0.0
手機、平板電腦、Android TV
支援搭載 Android 5.0 (API 級別 21) 以上版本的裝置。
螢幕鎖定品質檢查
com.google.android.gms:play-services-password-complexity:18.1.0
手機、平板電腦、Android Go、ChromeOS、Android Wear

支援搭載 Android 4.4 (API 級別 19) 至 Android 9 (API 級別 28) 的裝置。
Google 錢包 (原名為「Google Pay 中的票證」)
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 (包括安全瀏覽和驗證應用程式)
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.3.0
手機、平板電腦、Android TV、Android Go、ChromeOS
Android 版 Tasks API
com.google.android.gms:play-services-tasks:18.3.2
手機、平板電腦、Android TV、Android Auto、Android Go、ChromeOS、Wear OS
Android 版加速服務
com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01
手機、平板電腦、Android Go、ChromeOS
Google Play 服務的 TensorFlow Lite GPU 委派 API
com.google.android.gms:play-services-tflite-gpu:16.4.0
手機、平板電腦、Android Go、ChromeOS
適用於 Google Play 服務的 TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.4.0
手機、平板電腦、Android Go、ChromeOS
Google Play 服務的 TensorFlow Lite 支援 API
com.google.android.gms:play-services-tflite-support:16.4.0
手機、平板電腦、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.3.0
手機、平板電腦
Trusted Time API
com.google.android.gms:play-services-time:16.0.1
手機、平板電腦、Android Auto、Android Go、Wear OS
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:19.0.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