Android の使用を開始する

このガイドでは、Android で Google Fit を使用して開発を開始する方法について説明します。

注: Google Fit は Google Play 開発者サービスの一部です。Google Play 開発者サービスを使用することでアプリが得られるメリットについて学習します。

セットアップ

アプリのビルドを開始する前に、以下のセクションの手順を完了してください。

Google アカウントを取得する

Google Fit API を使用するには、Google アカウントが必要です。新しいアカウントを作成するか、既存のアカウントを使用できます。ユーザーの視点からアプリをテストするために、別のアカウントを作成することをおすすめします。

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 を取得します。

プロジェクトを作成して構成する

Fitness API を使用してアプリをビルドするには、Android Studio 開発環境を使用することをおすすめします。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.3.0")
        implementation("com.google.android.gms:play-services-auth:21.5.1")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.5.1'
}

これにより、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. アクセスが適用される: ユーザーが権限を付与すると、アプリはユーザーが権限を付与したスコープに属するデータ型にアクセスできます。

適格性確認を申請する

アプリをビルドしてテストしたら、機密性の高いスコープと制限付きスコープに必要なさまざまなレベルの正当性とともに、検証を申請する必要があります。