開始使用 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. 如果這些套件的狀態不是「已安裝」，請同時選取兩者 然後按一下「Install Packages」(安裝套件)。

取得 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 時 建構應用程式

建構及測試應用程式

完成設定步驟後，即可開始建構應用程式。若要取得 首先，請瞭解應用程式可儲存和處理的資料類型 讀取。進一步瞭解如何與 資料。

取得必要的 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. 已套用存取權：使用者授予權限後，應用程式就可以： 存取屬於使用者範圍的資料類型 權限。

申請驗證

在建構及測試應用程式後，您需要申請使用 以不同的方式驗證 您需要提供必要的適當層級 機密和受限制範圍。