Shiny.Health

Shiny Health

Apple Health and Google Fit for your .NET7+ .NET Mobile apps

Features

• Read summary values between timestamps and specified interval
• Query distance, step count, calory intake, & heart rate
• TODO: Write values

How To Use

IHealthService health; // inject, resolve, etc

// request permissions
var result = await health.RequestPermission(
    new Permission(DistanceHealthMetric.Default, PermissionType.Read),
    new Permission(CaloriesHealthMetric.Default, PermissionType.Read),
    new Permission(StepCountHealthMetric.Default, PermissionType.Read),
    new Permission(HeartRateHealthMetric.Default, PermissionType.Read)
);
if (!result)
{
    // say something useful
}

var end = DateTimeOffset.Now;
var start = DateTimeOffset.Now.AddDays(-1);

// now run your queries
var distance = (await health.Query(DistanceHealthMetric.Default, start, end, Interval.Days)).Sum(x => x.Value);
var calories = (await health.Query(CaloriesHealthMetric.Default, start, end, Interval.Days)).Sum(x => x.Value);
var steps = (await health.Query(StepCountHealthMetric.Default, start, end, Interval.Days)).Sum(x => x.Value);
var heartRate = (await health.Query(HeartRateHealthMetric.Default, start, end, Interval.Days)).Average(x => x.Value);

Setup

The fastest way to get going in a new application is to use our community dotnet template. Just run

dotnet new install Shiny.Templates

MAUI

Install Shiny.Health from

Now, in your MauiProgram.cs, add:

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp
        .CreateBuilder()
        .UseShiny()
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold"); 
        });

    builder.Services.AddHealthIntegration();
    return builder.Build();
}

iOS

To use iOS (and therefore the sample), you need to have a provisioning profile with all of the necessary Apple Health setup for your application.

Take a look at the Xamarin docs for more info

Add the following:

Info.plist

<key>UIRequiredDeviceCapabilities</key>
<array>
        <string>healthkithealthkit</string>
</array>
<key>NSHealthUpdateUsageDescription</key>
<string>We need to say something useful here</string>
<key>NSHealthShareUsageDescription</key>
<string>We need to say something useful here</string>

Entitlements.plist

<key>com.apple.developer.healthkit</key>
<true />
<key>com.apple.developer.healthkit.background-delivery</key>
<true />

Google Fit

Google Fit

To Test Locally:

• You have added your x to your Project's configuration setting on Google or Firebase Account.
• Downloaded and added google-services.json to your android project after adding the debug SHA1 key in your account.
• Package name (on Firebase account) and Application Id (on android) must be same .. Android's package name might be different, no problems with that.

** https://github.com/android/fit-samples/blob/main/StepCounterKotlin/app/src/main/java/com/google/android/gms/fit/samples/stepcounterkotlin/MainActivity.kt ** https://github.com/android/fit-samples/blob/main/BasicHistoryApiKotlin/app/src/main/AndroidManifest.xml

Setup

1. Sign Up at https://console.cloud.google.com/apis/dashboard
2. Under "Enabled APIs and services", search for "Fitness API"
3. After selecting "Fitness API" - enable the service
4. Now go to Firebase and add your project created in step 1
5. When creating your app, you need to ensure that your android app package name matches between firebase, cloud console, & androidmanifest.xml
6. You will need to add your debug SHA-1 debug key using

   keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore Password is 'android'

7. Download the google-services.json
8. Copy/paste file into your MAUI app at Platforms/Android and alter your csproj to the following

<ItemGroup Condition="'$(TargetFramework)' == 'net8.0-android'">
	<GoogleServicesJson Include="Platforms\Android\google-services.json" />
</ItemGroup>

AndroidManifest.xml

The following entry is needed for step data

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"/>