health 1.0.0 copy "health: ^1.0.0" to clipboard
health: ^1.0.0 copied to clipboard

outdated

Wrapper for the iOS HealthKit and Android GoogleFit services.

health #

This library combines both GoogleFit and AppleHealthKit. It support most of the values provided.

Supports iOS and Android X

Data Types #

Data Type Available on iOS Available on Android Comments
BODY_FAT yes yes
HEIGHT yes yes
WEIGHT yes yes
BODY_MASS_INDEX yes yes
WAIST_CIRCUMFERENCE yes
STEPS yes yes
BASAL_ENERGY_BURNED yes
ACTIVE_ENERGY_BURNED yes yes
HEART_RATE yes yes
BODY_TEMPERATURE yes yes
BLOOD_PRESSURE_SYSTOLIC yes yes
BLOOD_PRESSURE_DIASTOLIC yes yes
RESTING_HEART_RATE yes
WALKING_HEART_RATE yes
BLOOD_OXYGEN yes yes
BLOOD_GLUCOSE yes yes
ELECTRODERMAL_ACTIVITY yes Requires Apple Watch
HIGH_HEART_RATE_EVENT yes Requires Apple Watch
LOW_HEART_RATE_EVENT yes Requires Apple Watch
IRREGULAR_HEART_RATE_EVENT yes Requires Apple Watch

Setup #

Apple HealthKit #

Step 1: Append the Info.plist with the following 2 entries

<key>NSHealthShareUsageDescription</key>
<string>We will sync your data with the Apple Health app to give you better insights</string>
<key>NSHealthUpdateUsageDescription</key>
<string>We will sync your data with the Apple Health app to give you better insights</string>

Step 2: Enable "HealthKit" inside the "Capabilities" tab.

Google Fit #

Follow this setup.

Android X #

Replace the content of the android/gradle.properties file with the following lines:

org.gradle.jvmargs=-Xmx1536M
android.enableJetifier=true
android.useAndroidX=true

Usage #

Below is a snippet from the example app showing the plugin in use.

Check authorization #

The following example shows prompting the user for authorization to the API, which is necessary in order to fetch any data.

Calls to fetch data from the API should be done within the inner if-clause.

Future.delayed(Duration(seconds: 2), () async {
    _isAuthorized = await Health.requestAuthorization();
    if (_isAuthorized) {
        /// Do something with the API here
    }
}

Specify data type #

Data types indicate the type of data to fetch from the API and are available from the enum class HealthDataType.

Below is an example of a few data types:

List<HealthDataType> types = [
        HealthDataType.WEIGHT,
        HealthDataType.HEIGHT,
        HealthDataType.STEPS,
    ];

For an overview of all data types see the table in Data Types section above.

Check if data type available #

Not all data types are available on both platforms. In order to check whether or not a data type is available for the current platform,

bool weightAvailable = Health.isDataTypeAvailable(HealthDataType.WEIGHT);

Fetch data for a given type #

Given the list of data types (types) we can now fetch all the data, for each data type with a call to the Health.getHealthDataFromType function.

This call must be inside a try catch block, since when some data type is not available, an exception will be thrown. Also, make sure the access to the API has been authorized (see Check authorization).

List<HealthDataPoint> healthDataList = List<HealthDataPoint>();

for (HealthDataType type in types) {
    /// Calls to 'Health.getHealthDataFromType' must be wrapped in a try catch block.
    try {
        List<HealthDataPoint> healthData = await Health.getHealthDataFromType(startDate, endDate, type);
        healthDataList.addAll(healthData);
    } catch (exception) {
        print(exception.toString());
    }
}
486
likes
0
pub points
97%
popularity

Publisher

verified publishercachet.dk

Wrapper for the iOS HealthKit and Android GoogleFit services.

Homepage
Repository (GitHub)
View/report issues

License

unknown (LICENSE)

Dependencies

flutter

More

Packages that depend on health