tauri-plugin-healthkit 0.1.3

A Tauri plugin for accessing HealthKit (iOS) and Health Connect (Android)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

[README in Japanese](README.ja.md)

# tauri-plugin-healthkit

This plugin provides access to HealthConnect (Android) and HealthKit (iOS).

| Platform | Supported |
|----------|-----------|
| Linux    | x         |
| Windows  | x         |
| macOS    | x         |
| Android  | ✓         |
| iOS      | ✓         |

## Install

_Coming soon._
We plan to publish this plugin on `crates.io` and `npm`.

## Usage

### Requirements

- Gradle 8.1.1 or higher
- Android Gradle Plugin 8.9.1 or higher
- compileSdk 36 or higher (Android 14+)
- minSdk 26 or higher (Android 8.0+)

`src-tauri/gen/android/app/build.gradle.kts`

```kotlin
android {
    compileSdk = 36
    namespace = "com.tauri.dev"
    defaultConfig {
        minSdk = 26
        targetSdk = 36
    }
}
```

`src-tauri/gen/android/build.gradle.kts`

```kotlin
    dependencies {
        classpath("com.android.tools.build:gradle:8.9.1")
    }
```

`src-tauri/gen/android/buildSrc/build.gradle.kts`

```kotlin
dependencies {
    compileOnly(gradleApi())
    implementation("com.android.tools.build:gradle:8.9.1")
}
```

`src-tauri/gen/android/gradle/gradle-wrapper.properties`

```properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
```

### Adding the Plugin

Add the plugin to your Tauri application:

`src-tauri/src/lib.rs`

```rust
fn run() {
    tauri::Builder::default()
        .invoke_handler(tauri::generate_handler![greet])
        .plugin(tauri_plugin_healthkit::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}
```

### Usage Example

Specify the permissions you need for HealthConnect (Android):

`src-tauri/gen/android/app/src/AndroidManifest.xml`

```xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- Health Connect permissions -->
    <uses-permission android:name="android.permission.health.READ_WEIGHT"/>
    <uses-permission android:name="android.permission.health.WRITE_WEIGHT"/>
    <uses-permission android:name="android.permission.health.READ_SLEEP"/>
    <uses-permission android:name="android.permission.health.WRITE_SLEEP"/>
    <uses-permission android:name="android.permission.health.READ_EXERCISE"/>
    <uses-permission android:name="android.permission.health.WRITE_EXERCISE"/>
    <uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
    <uses-permission android:name="android.permission.health.WRITE_HEART_RATE"/>
    <uses-permission android:name="android.permission.health.READ_STEPS"/>
    <uses-permission android:name="android.permission.health.WRITE_STEPS"/>
</manifest>
```

## Contributing

Pull requests are welcome.  
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for more information.