ヘルスコネクト

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

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

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

依存関係の宣言

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

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

Groovy

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

Kotlin

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

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.1

バージョン 1.1.0-alpha07

2024 年 1 月 10 日

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

API の変更

  • #getSdkStatus がプロファイル ユーザー コンテキストから呼び出された場合は、SDK_UNAVAILABLE を返します。（I91df3）
  • SleepStageRecord を削除しました。（/If6ada）

バグの修正

  • バインディングが失敗した場合に、IllegalStateException ではなく RemoteException をスローします。（Id2233）

バージョン 1.1.0-alpha06

2023 年 10 月 18 日

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

API の変更

  • recordingMethod 定義を公開します。（I401fb）

バグの修正

  • 演習のルートに、場所はセッションの終了時刻より前にする必要があることを示すドキュメントを追加しました。（0e51e6）

バージョン 1.1.0-alpha05

2023 年 10 月 4 日

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

API の変更

  • ヘルスコネクトのデータ管理画面に移動するインテントを追加しました。（Ibf591）
  • AggregationResult で非推奨のメソッドを削除しました。（Idbda9）
  • ReadRecordsRequest の作成、また変更されたレコードタイプでのレコードの削除と読み取りを行うための、コンビニエンス API を追加しました。（If58a5）

バグの修正

  • null の栄養フィールドが Double.MIN_VALUE として返される Android 14 のバグを修正しました。（1aa1d1）
  • バケットの開始時刻と終了時刻が同じであるため、月単位 / 年単位で集計するとレスポンスで例外がスローされる Android 14 のバグを修正しました。（281313）

バージョン 1.1.0-alpha04

2023 年 9 月 6 日

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

API の変更

バグの修正

バージョン 1.1.0-alpha03

2023 年 7 月 26 日

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

新機能

  • エクササイズのルートを読み書きするための API:
    • 「ExerciseRouteResult」を「ExerciseSessionRecord」に追加しました
    • ExerciseRouteRequestContract を追加しました。

API の変更

  • ExerciseRouteResult とそのサブクラス（Data、NoData、ConsentRequiredStates）を追加しました。
  • ルートの位置情報を保持する ExerciseRoute をスタンドアロン クラスとして追加しました。（I22eed）
  • PERMISSION_WRITE_EXERCISE_ROUTE を追加しました。（I92fc4）
  • ExerciseRouteRequestContract、HealthPermissionsRequestContract を追加しました。（Ief0e5）

バグの修正

  • エネルギー（キロジュール単位）の構造を修正しました。（Ie8791）

バージョン 1.1.0-alpha02

2023 年 6 月 21 日

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

バグの修正

  • HealthDataSdkService のリークを修正しました。（Ia3ba5）
  • Android U で権限をリクエストするときは、常に適切な HealthConnect クライアントにリダイレクトします。（I6415a）

バージョン 1.1.0-alpha01

2023 年 6 月 7 日

androidx.health.connect:connect-client:1.1.0-alpha01 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

  • ヘルスコネクトの Android 14 フレームワーク バージョンをサポート。この SDK は Android 14 の前提条件です。これがないと、アプリを Android 14 のヘルスコネクトと統合できなくなります。
  • メタデータを記録する記録メソッドを追加しました。

API の変更

  • セッション API の変更点:
    • さまざまな睡眠ステージを SleepSessionRecord に追加し、SleepStageRecord を削除しました。
    • ExerciseLap と ExerciseSegment を ExerciseSessionRecord に追加しました。
  • 読み取り、変更履歴、挿入、削除の各オペレーションに対する、定期および 1 日あたりのレート制限（メモリ制限を含む）。
  • すべての NutritionRecord フィールドの検証を追加しました。
  • HeartRateVariabilityRmssdRecord の検証を追加しました。
  • 非推奨の 2 つの API（HealthConnectClient#isProviderAvailable と HealthConnectClient#isApiSupported）を削除しました。

バグの修正

  • すべての単位タイプで等式が固定され、単位初期化に使用される型に等価性が依存しなくなりました。たとえば、Massgrams(1000) は Mass.kilograms(1) になりました。

バージョン 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 フレームワークの権限の曖昧さを回避できます。（リンク）

バグの修正

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