開始使用 Android

本指南說明如何開始在 Android 裝置上使用 Google Fit 進行開發作業。

注意： Google Fit 是 Google Play 服務的一部分。瞭解應用程式使用 Google Play 服務可帶來哪些好處。

設定

開始建構應用程式之前，請先完成以下各節的步驟。

建立 Google 帳戶

您必須擁有 Google 帳戶，才能使用 Google Fit API。您可以建立新帳戶或使用現有帳戶。建議您另外建立帳戶，從使用者的角度測試應用程式。

取得 Google Play 服務

在開發主機上取得 Google Play 服務的最新用戶端程式庫：

1. 開啟 Android SDK Manager。
2. 在「SDK Tools」下方，找出「Google Play services」。
3. 如果這些套件的狀態不是「已安裝」，請同時選取套件並按一下「安裝套件」。

取得 OAuth 2.0 用戶端 ID

如要啟用 Fitness API，請取得 OAuth 2.0 用戶端 ID。

建立並設定專案

建議您使用 Android Studio 開發環境，透過 Fitness API 建構應用程式。如要進一步瞭解如何在 Android Studio 中建立新專案並進行設定，請參閱「建立專案」一文。

新增 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 權限

應用程式有權存取的資料類型與授權範圍對應。如要要求這些權限，您必須將應用程式需要存取的資料類型新增至 FitnessOptions 執行個體。當應用程式要求使用任何 Google Fit 資料類型時，Android SDK 會自動檢查其屬於哪個範圍，並要求使用者授予這些範圍的授權。

建立 API 用戶端

建立 API 用戶端，並新增應用程式需要存取或讀取資料所需的資料類型。可用的端點如下：

• SensorsClient：透過本機裝置和隨附裝置的硬體感應器存取不同來源的健康與保健資料。
• RecordingClient：在低耗電的情況下，在背景收集感應器資料。
• HistoryClient：在 Google Fit 中插入、刪除及讀取歷來資料。
• SessionsClient：建立及管理使用者活動的工作階段。
• GoalsClient：讀取使用者在 Google Fit 中建立的心肺強化分數和步數目標。
• ConfigClient：在 Google Fit 平台上存取自訂資料類型和設定。

請參閱範例，瞭解如何建構 Fitness API 用戶端。

產生的使用者授權流程

以下顯示使用者要求取得權限時產生的授權流程：

圖 1.使用者的授權流程。

1. Android 權限：使用者在下載應用程式前，會看到應用程式要求哪些 Android 權限。使用者下載應用程式後，會要求自身所需的任何執行階段權限，並授予或拒絕這些權限。
2. 檢查並連線：應用程式會在要求存取其他資料類型之前，檢查使用者是否已授予權限。
3. OAuth 範圍要求：Google 會提示使用者針對需要存取的資料類型授予應用程式所需的 OAuth 範圍。
4. 套用存取權：使用者授予權限後，應用程式就能存取屬於使用者已授予權限的資料類型。

申請驗證

建構及測試應用程式後，請針對敏感和受限制範圍的不同理由申請驗證。