ヘルスコネクト

  
ユーザーの健康状態やフィットネスの記録をデベロッパーが読み取り/ 書き込みできるようにします。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2023 年 2 月 22 日 - - - 1.0.0-alpha11

データ型へのアクセス権のリクエスト

ユーザーのプライバシーとセキュリティを強化できるように、ヘルスコネクトと統合するデベロッパーは、こちらのデベロッパー申告フォームに記入して、データ型に対する読み取り / 書き込みアクセス権をリクエストする必要があります。アプリの目的に応じて必要なデータ型について、有効なユースケースをリクエストに含めてください。詳しくは、ヘルスコネクトのポリシー要件に関するよくある質問と Android のヘルスコネクトの権限をご覧ください。

依存関係の宣言

health への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.0.0-alpha11"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.0.0-alpha11")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.0

バージョン 1.0.0-alpha11

2023 年 2 月 22 日

androidx.health.connect:connect-client:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

API の変更

  • ヘルスコネクトを開くために使用するインテントを追加しました。（Ic8055）
  • 一部のエクササイズ タイプを削除しました。削除されたタイプの代わりに EXERCISE_TYPE_STRENGTH_TRAINING、EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING、または EXERCISE_TYPE_CALISTHENICS を使用してください。（I7291c）
  • サポートが終了した 2 つの API isSdkSupported() と isProviderAvailable() を組み合わせた、新しい API sdkStatus() を追加しました。（Iac89d）
  • providerPackageName を受け入れる API を変更して、リストではなく 1 つの文字列を受け入れるようにしました。（I67e0f）

バージョン 1.0.0-alpha10

2023 年 1 月 25 日

androidx.health.connect:connect-client:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

  • ExerciseEventRecord、ExerciseLapRecord、ExerciseRepititionRecord、SwimmingStrokesRecord は RecordTypes としてサポートされなくなりました。HealthConnect に対する書き込みと読み取りができなくなります。 HealthConnect 統合からこれらのデータ型への参照をすべて削除します。（If7ca2）
  • 新しい文字列ベースの形式で権限が受け入れられるように権限 API を変更しました。この変更に伴い、権限の申告を Android 標準の権限形式に変更することも必要になります。（Ib0a2f）

バージョン 1.0.0-alpha09

2023 年 1 月 11 日

androidx.health.connect:connect-client:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

  • ヘルスコネクト用に女性の健康に関するデータ型を 2 つ追加しました（IntermenstrualBleedingRecord と MenstruationPeriodRecord）。MenstruationFlow.ENUMs は、Light、Medium、Heavy、Unknown です。

API の変更

  • IntermenstrualBleedingRecord を追加しました（Idc470）
  • レコードタイプ MenstruationPeriodRecord を追加しました（Iea545）

バージョン 1.0.0-alpha08

2022 年 12 月 7 日

androidx.health.connect:connect-client:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

API の変更

  • サポートされている新しいレコードタイプとして BodyWaterMass、HeartRateVariabilityRmssdRecord を追加しました。（Ifd58f）
  • サポートされている RecordTypes として HipCircumferenceRecord、WaistCircumferenceRecord を削除しました。（I62fb9）
  • MenstruationFlowRecord.flow を stringdef から intdefs に変更しました。（I0369f）
  • パフォーマンスを向上させるために、Strings を含む列挙型のようなレコード フィールドを Integers に変更しました。（I3b295）
  • ExerciseSession、ExerciseRepetitions、SleepStage の列挙型のようなフィールドを文字列から整数型に変更しました。（Id32a9）
  • ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL に変更しました。（I5d7bd）
  • CervicalMucus 列挙型に「Unusual」を追加しました。より明確にするために「Clear」を「Eggwhite」に変更しました。CervicalMucus#appearance と #sensation を StringDefs から IntDefs に変更しました。（I3ac51）
  • DeviceTypes 列挙型の StringDef が [Device] の IntDefs に移動しました。（I3abf3）
  • 互換性のある実装がない SDK バージョンで false を返す HealthConnectClient.isApiSupported() を追加しました。HealthConnectClient.isAvailable->isProviderAvailable に変更しました。（I3674e）

バグの修正

  • 1 未満の HeartRate beatsPerMinute 値を禁止します。（I6052f）
  • @JvmDefaultWithCompatibility アノテーションを追加しました。（I8f206）

バージョン 1.0.0-alpha07

2022 年 10 月 24 日

androidx.health.connect:connect-client:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

  • デフォルト値がないレコード引数は、デフォルト値がある引数の前に配置されます。整合性を保つため、Instant 引数と ZoneOffset 引数は常に先頭に配置されます。（Id618c）
  • HealthConnectClient.getOrCreate#packageNames を providerPackageNames に変更しました。（Id81e4）

バグの修正

  • レコード フィールド値の検証を追加しました。指定された値が妥当な範囲の外にある場合、極端に誤った値について IllegalArgumentExceptions をスローします。（Ie171d）
  • 該当する場合は、レコード開始時間が終了時間より前かどうかを検証します。（I02460）

バージョン 1.0.0-alpha06

2022 年 10 月 5 日

androidx.health.connect:connect-client:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

バグの修正

  • サービス接続のライフサイクルを改善しました。（If2bd5）
  • サービス接続で例外が発生した場合に NPE がクラッシュするバグを修正しました。（I13546）

バージョン 1.0.0-alpha05

2022 年 9 月 21 日

androidx.health.connect:connect-client:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

API の変更

  • Metadata.uid を Metadata.id に変更し、関連する CRUD API 全体で用語 recordId を統一しました。（I3d1d2）
  • PermissionController.createRequestPermissionActivityContract をインスタンス メソッドではなく静的メソッドにしました。PermissionController.createRequestPermissionResultContract に変更しました。（Icd2fe）
  • BloodGlucoseRecord の単位タイプとして BloodGlucose を追加しました。（I97678）
  • MenstruationRecord を MenstruationFlowRecord に変更しました。（I3b88e）

バグの修正

  • クライアント プロセスからフォアグラウンドのデータを伝播しない意図しない動作を修正しました。（Ifb44c）

バージョン 1.0.0-alpha04

2022 年 8 月 24 日、androidx.health.connect:connect-client:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

androidx.health.connect への移行

1.0.0-alpha04 以降、androidx.health:health-connect-client は androidx.health.connect:connect-client に移行されました。以前のバージョンのヘルスコネクトについては、androidx.health ページをご覧ください。

移行するには、単に依存関係のインポートを androidx.health:health-connect-client:1.0.0-alpha03 から androidx.health.connect:connect-client:1.0.0-alpha04 に変更します。

新機能

  • API 呼び出し用の組み込みのデバッグログをオプションとして追加しました（リンク）。

API の変更

  • メタデータ clientId を clientRecordId に、clientVersion を clientRecordVersion に変更しました。（リンク）
  • メタデータの uid を読みやすくし、null 可能性はなくなりました。（リンク）
  • 質量単位にポンドを追加しました（リンク）
  • DeletionChange.deleteUid を uid に変更しました（リンク）
  • Permission を HealthPermission に変更しました。これにより、Android フレームワークの権限の曖昧さを回避できます。（リンク）

バグの修正

  • エネルギーのカロリー単位の誤りに関する回帰問題を修正しました（リンク）
  • 一部のレコード型の集約に関する回帰問題を修正しました（リンク）