設定 Google Play 服務

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

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

• 搭載 Android 4.4 (API 級別 19) 或以上版本的相容 Android 裝置，且已安裝 Google Play 商店應用程式。
• 具有 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 服務會透過 Android 4.4 (API 級別 19) 以上版本，透過 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 服務依附元件

下表列出您可以在 Android 應用程式中加入的 Google Play 服務依附元件。只要選取其中一個按鈕，即可依裝置類型篩選清單，而且只要在按鈕後方的方塊中輸入文字，即可搜尋特定用途或依附元件名稱。

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