設定 Google Play 服務

如要使用 Google Play 服務 API 開發應用程式，請按照本頁的操作說明，使用 Google Maven 存放區提供的相關 SDK 為專案設定相關 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 的功能，請完成下列步驟：

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 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 服務依附元件。只要選取其中一個按鈕，即可依裝置類型篩選清單，也可以在按鈕後方顯示的方塊中輸入文字，以搜尋特定用途或依附元件名稱。

手機和平板電腦 Android TV Auto Android Go ChromeOS 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, Auto, Android Go, ChromeOS, Wear OS