本指南說明如何開始在 Android 裝置上使用 Google Fit 進行開發作業。
設定
開始建構應用程式之前,請先完成以下各節的步驟。
建立 Google 帳戶
您必須擁有 Google 帳戶,才能使用 Google Fit API。您可以建立新帳戶或使用現有帳戶。建議您另外建立帳戶,從使用者的角度測試應用程式。
取得 Google Play 服務
在開發主機上取得 Google Play 服務的最新用戶端程式庫:
- 開啟 Android SDK Manager。
- 在「SDK Tools」下方,找出「Google Play services」。
- 如果這些套件的狀態不是「已安裝」,請同時選取套件並按一下「安裝套件」。
新增 Google Play 服務用戶端程式庫
在 Android Studio 中開啟模組的 build.gradle
檔案,然後將 Google Play 服務用戶端程式庫新增為依附元件:
Kotlin DSL
plugin {
id("com.android.application")
}
...
dependencies {
implementation("com.google.android.gms:play-services-fitness:21.2.0")
implementation("com.google.android.gms:play-services-auth:21.2.0")
}
時髦 DSL
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-fitness:21.2.0'
implementation 'com.google.android.gms:play-services-auth:21.2.0'
}
確保 Gradle 在建構應用程式時會自動下載健身 SDK。
建構及測試應用程式
完成設定步驟後,您就可以開始建構應用程式。首先,請瞭解應用程式可儲存及讀取的資料類型。進一步瞭解如何在 Google Fit 中處理資料。
產生的使用者授權流程
以下顯示使用者要求取得權限時產生的授權流程:
- Android 權限:使用者在下載應用程式前,會看到應用程式要求哪些 Android 權限。使用者下載應用程式後,會要求自身所需的任何執行階段權限,並授予或拒絕這些權限。
- 檢查並連線:應用程式會在要求存取其他資料類型之前,檢查使用者是否已授予權限。
- OAuth 範圍要求:Google 會提示使用者針對需要存取的資料類型授予應用程式所需的 OAuth 範圍。
- 套用存取權:使用者授予權限後,應用程式就能存取屬於使用者已授予權限的資料類型。
申請驗證
建構及測試應用程式後,請針對敏感和受限制範圍的不同理由申請驗證。