health

• Write data now returns UUID of records - PR #448
• Fix #502
• iOS: Fix #480 - PR #504 - the native plugin class is now HealthPlugin (previously SwiftHealthPlugin behind an Objective-C shim) - apps using the generated plugin registrant are unaffected
• iOS: Raise the minimum deployment target to 15.0

• iOS: Fix issues with app crashing on iOS 15
• iOS: Add support for AppleSleepingWristTemperature - PR #468
• Android: Add support for SkinTemperatureRecord (READ/WRITE)

• Add support for WORKOUT_ROUTE - PR #454
• Android: Add support for ActivityIntensityRecord (READ/WRITE/Aggregate)
• Update to androidx.health.connect:connect-client:1.2.0-alpha02

No changes - Now the Health package lives in its own repository at https://github.com/carp-dk/carp-health-flutter

• Add get health data by UUID (see getHealthDataByUUID()) - PR #1193, #1194
• Add delete by UUID (deleteByUUID())
• Add support for unit conversion in WeightRecord, HeightRecord, BodyTemperatureRecord, and BloodGlucoseRecord - PR #1212
• Update compileSDK to 36 - Fix #1261
• Update Gradle to 8.9.1
• Update org.jetbrains.kotlin.android to 2.1.0
• Update androidx.health.connect:connect-client to 1.1.0-rc03
• Update device_info_plus to 12.1.0 - Fix #1264

• Fix adding mindfulness resulted in crash in iOS
• Support SPM for iOS

• Fix permissions issues with iOS
• Fix #1231

• Fix #1250
• Fix #1233

• Fix #1207 - (Important: Some property names might have changed compared to before for Nutrition)
• Fix #1201
• iOS: Add APPLE_STAND_TIME, APPLE_STAND_HOUR, and APPLE_MOVE_TIME health data types (READ ONLY) #1190

• Refactored Android native implementation (No Flutter API changes)
• Android: Add SPEED health data type - PR #1183
• iOS: Add WALKING_SPEED health data type - PR #1183
• Add METER_PER_SECOND health data unit

• Refactored Swift native implementation - See PR #1175 and #1208 for more information:

SwiftHealthPlugin (Main Plugin Class)
├── HealthDataReader (Reading health data)
├── HealthDataWriter (Writing health data)
├── HealthDataOperations (Permissions and deletion)
├── HealthUtilities (Helper functions)
└── HealthConstants (Constants and enums)

• Refactored Swift native implementation

• iOS: Add swift_version for add-to-app implementations - PR #1205

• iOS: Add deviceModel in returned Health data to identify the device that generated the data of the receiver. (in iOS source_name represents the revision of the source responsible for saving the receiver.)
• Android: Add read health data in background - PR #1184
• Fix #1169 where meal_type property in Nutrition was null always
• iOS: Add CARDIO_DANCE HealthDataType - #1146

• Add delete record by UUID method. See function deleteByUUID(required String uuid, HealthDataType? type)
• iOS: Parse metadata to remove unsupported types - PR #1120
• iOS: Add UV Index Types
• Android: Add request access to historic data #1126 - PR #1127

<!-- Add the following permission into AndroidManifest.xml -->
<uses-permission android:name="android.permission.health.READ_HEALTH_DATA_HISTORY"/>

• Android:
  • Update androidx.compose:compose-bom to 2025.02.00
  • Update androidx.health.connect:connect-client to 1.1.0-alpha11
  • Update androidx.fragment:fragment-ktx to 1.8.6
  • Update to Java 11
• Update example apps

• Update of API and README doc
• Fix #1118

• BREAKING This release introduces a significant architectural change to the health plugin by removing the singleton pattern.

  • Dependency Injection for DeviceInfoPlugin:
  • The Health class is no longer a singleton.
  • The Health() factory constructor is removed.
  • The Health class now accepts an (optional) DeviceInfoPlugin dependency through its constructor, this change was introduced to provide easy mocking of the DeviceInfo class during unit tests.
  • This architectural change means that, for the application to work correctly, the Health class MUST be initialized correctly as a global instance.
  • Impact:
    • For most users, no immediate code changes are required but it is paramount to initialize the Health class as a global instance (i.e. do not call Health() every time but rather define an instance final health = Health();).

• BREAKING (Android) Remove automatic permission request of DISTANCE_DELTA and TOTAL_CALORIES_BURNED data types when requesting permission for WORKOUT health data type.

  • For WORKOUTs that require above permissions, now those need to be requested manually.
  • Fix #984 - PR #1055

• Add LEAN_BODY_MASS data type #1078 - PR #1097

  • The following AndroidManifest values are required to READ/WRITE LEAN_BODY_MASS:

  <uses-permission android:name="android.permission.health.READ_LEAN_BODY_MASS"/>
  <uses-permission android:name="android.permission.health.WRITE_LEAN_BODY_MASS"/>
  

• iOS: Add WATER_TEMPERATURE and UNDERWATER_DEPTH health values #1096

• iOS: Add support for Underwater Diving workout #1096

• Fix #1072 and #1074

• Fix issue where iOS delete not deleting own records - PR #1104

• Fix #950 - PR #1103

• Fix #1047 and #939 - PR #1091

• Fix issue where SLEEP_LIGHT type was not aligned correctly - PR #1086

• Fix #1051 - PR #1052

• Updated intl to ^0.20.1 #1092

• Updated device_info_plus to ^11.2.0

• Example app: Updated permission_handler to ^11.3.1

• Fix of #1059

• Fix of #1043
• Type-safe JSON deserialization using carp_serializable v. 2.0

• BREAKING Remove Google Fit support in the Android code, as well as Google FIt related dependencies and references throughout the documentation
  • Remove useHealthConnectIfAvailable from the parameters of Health().configure()
  • Remove the disconnect method which was previously used to disconnect from Google Fit.
  • Remove the flowRate value from writeBloodOxygen as this is not supported by Health Connect.
  • Remove support for various HealthWorkoutActivityTypes which were supported by Google Fit. Some of these do not have suitable alternatives in Google Health Connect (and are not supported on iOS). The list of removed types can be found in PR #1014
• BREAKING introduce a new RecordingMethod enum
  • This can be used to filter records by automatic or manual entries when fetching data
  • You can also specify the recording method to write in the metadata
  • Remove isManualEntry from HealthDataPoint in favor of recordingMethod, of which the value is an enum RecordingMethod
  • Remove includeManualEntry (previously a boolean) from some of the querying methods in favor of recordingMethodsToFilter.
  • For complete details on relevant changes, see the description of PR #1023
• Add support for all sleep stages across iOS and Android
  • Clean up relevant documentation
  • Remove undocumented sleep stages
  • BREAKING certain sleep stages were removed/combined into other related stages see PR #1026 for the complete list of changes and a discussion of the motivation in issue #985
• Android: Add support for OTHER workout type
• Cleaned up workout activity types for consistency across iOS and Android, see PR #1020 for a complete list of changes
• iOS: add support for menstruation flow, PR #1008
• Android: Add support for heart rate variability, PR #1009
• iOS: add support for atrial fibrillation burden, PR #1031
• Add support for UUIDs in health records for both HealthKit and Health Connect, PR #1019
• Fix an issue when querying workouts, the native code could respond with an activity that is not supported in the Health package, causing an error - this will fallback to HealthWorkoutActivityType.other - PR #1016
• Remove deprecated Android v1 embeddings, PR #1021

• Using named parameters in most methods for consistency.
• Added a HealthPlatformType to save which health platform the data originates from (Apple Health, Google Fit, or Google Health Connect).
• Android: Improved support for Google Health Connect
  • getHealthConnectSdkStatus, PR #941
  • installHealthConnect, PR #943
  • workout title, PR #938
• iOS: Add support for saving blood pressure as a correlation, PR #919

• Fix of error in WorkoutSummary JSON serialization.
• Fix of #934
• Empty value check for calories nutrition, PR #926

• BREAKING The plugin now works as a singleton using Health() to access it (instead of creating an instance of HealthFactory).
  • This entails that the plugin now need to be configured using the configure() method before use.
  • The example app has been update to demonstrate this new singleton model.
• Support for new data types:
  • body water mass, PR #917
  • caffeine, PR #924
  • workout summary, manual entry and new health data types, PR #920
• Fixed SleepSessionRecord, PR #928
• Update to API and README docs
• Upgrade to Dart 3.2 and Flutter 3.
• Added Dart linter and fixed a series of type casting issues.
• Using carp_serializable for consistent camel_case and type-safe generation of JSON serialization methods for polymorphic health data type classes.

• Updated HC to comply with Android 14, PR #834 and #882
• Added checks for NullPointerException, closes issue #878
• Updated intl to ^0.19.0
• Upgrade to AGP 8, PR #868
• Added missing google fit workout types, PR #836
• Added pagination in HC, PR #862
• Fix of permission in example app + improvements to doc, PR #875

• Fixed sleep stages on iOS, Issue #803
• Added Nutrition data type, includes PR #679
• Lowered minSDK, Issue #809

• Fixed issue #774, #779
• Merged PR #579, #717, #770
• Upgraded to mavenCentral, upgraded minSDK, compileSDK, targetSDK
• Updated health connect client to 1.1.0
• Added respiratory rate and peripheral perfusion index to HealthConnect
• Minor fixes to requestAuthorization, sleep stage filtering

• Updated dart doc

• Merged PR #722
• Added deep, light, REM, and out of bed sleep to iOS and Android HealthConnect

• Fixed issues #694, #696, #697, #698
• added totalSteps for HealthConnect
• added supplemental oxygen flow rate for blood oxygen saturation on Android

• Added initial support for the new Health Connect API, as Google Fit is being deprecated.
  • Does not yet support revokePermissions, getTotalStepsInInterval.
• Changed Intl package version dependency to ^0.17.0 to work with flutter stable version.
• Updated the example app to handle more buttons.

• Added method for revoking permissions. On Android it uses disableFit() to remove access to Google Fit - revokePermissions. Documented lack of methods for iOS.

• Updated android sdk, gradle
• Updated enumToString to native .name
• Update and fixed JSON serialization of HealthDataPoints
• Removed auth request in writeWorkoutData to avoid bug when denying the auth.
• Merged pull requests #653, #652, #639, #644, #668
• Further developed #644 on android to accommodate having the writeBloodPressure api.
• Small bug fixes

• Merged pull request #566, #578, #596, #623, #632
• ECG added as part of #566
• Small fixes

• upgrade to device_info_plus: ^8.0.0

• upgrade to device_info_plus: ^7.0.0

• fix of #572.

• update of device_info_plus: ^4.0.0
• upgraded to Dart 2.17 and Flutter 3.0

• Large refactor of the HealthDataPoint value into generic HealthValue and added NumericHealthValue, AudiogramHealthValue and WorkoutHealthValue
• Added support for Audiograms with writeAudiogram and in getHealthDataFromTypes
• Added support for Workouts with writeWorkout and in getHealthDataFromTypes
• Added all HealthWorkoutActivityTypes
• Added more HealthDataUnit types
• Fix of #432
• updated documentation in code
• updated documentation in README.md
• updated example app
• cleaned up code
• removed requestPermissions as it was essentially a duplicate of requestAuthorization

• Fix of #500.
• Added Headache-types to HealthDataTypes on iOS

• fix of #401.

• Resolved concurrent issues with native threads PR#483.
• HealthKit CategorySample PR#485.
• update of API documentation.

• Add sleep in bed to android PR#457.
• Add the android.permission.ACTIVITY_RECOGNITION setup to the README PR#458.
• Fixed (regression) issues with metric and permissions PR#462.
• Get total steps PR#471.
• update of example app to reflect new features.
• update of API documentation.

• DISTANCE_DELTA is for Android, not iOS PR#428.
• added missing READ_ACCESS PR#454.

• Write support on Google Fit and HealthKit PR#430.

• Updated device_info_plus version dependency

• added simple HKWorkout and ExerciseTime support PR#421.

• added functions to request authorization PR#394

• added sleep data to Android + fix of permissions and initialization PR#372
• testability of HealthDataPoint PR#388.
• update to using the device_info_plus plugin

• Added two new fields to the HealthDataPoint - SourceId and SourceName and populate when data is read. This allows data points to be disambiguous and in some cases allows us to get more accurate data. For example the number of steps can be reported from Apple Health and Watch and without source data they are aggregated into just "steps" producing an inaccurate result PR#281.

• Null safety in Dart has been implemented
• The plugin supports the Android v2 embedding

• Upgrade to device_info version 2.0.0

• Merged various PRs, mostly smaller fixes

• Upgrade to device_info version 1.0.0

• Bugfix regarding BMI from https://github.com/cph-cachet/flutter-plugins/pull/258