History

dependabot[bot] 6ab9f8eab4 Bump flutter_lints from 3.0.2 to 4.0.0 in /experimental/pedometer/example (#2274 )		6 months ago
..
android	Pedometer dependency updates and regeneration (#2133 )	10 months ago
example	Bump flutter_lints from 3.0.2 to 4.0.0 in /experimental/pedometer/example (#2274 )	6 months ago
ios	Pedometer dependency updates and regeneration (#2133 )	10 months ago
lib	Bump jni from 0.8.0 to 0.9.0 in /experimental/pedometer (#2268 )	6 months ago
src	Update pedometer sample for jni 0.8.0 (#2237 )	7 months ago
.gitignore	Add `experimental/pedometer` (#1587 )	2 years ago
.metadata	[experimental/pedometer] Use `jnigen` and `jni` version from pub instead of git url. (#1655 )	2 years ago
CHANGELOG.md	Add `experimental/pedometer` (#1587 )	2 years ago
LICENSE	Add `experimental/pedometer` (#1587 )	2 years ago
README.md	Pedometer dependency updates and regeneration (#2133 )	10 months ago
analysis_options.yaml	Add `experimental/pedometer` (#1587 )	2 years ago
ffigen.yaml	Simplify experimental pedometer example (#2104 )	11 months ago
jnigen.yaml	[experimental/pedometer] Update jni and jnigen to 0.6 (#2006 )	1 year ago
pubspec.yaml	Bump flutter_lints from 3.0.2 to 4.0.0 in /experimental/pedometer (#2286 )	6 months ago

README.md

FFIgen + JNIgen pedometer

This is a demo for some of our tooling around calling platform APIs directly from dart code. This repository represents a demo of a plugin that leverages FFIgen & JNIgen. There is also an example pedometer app that uses the bindings generated from these tools.

FFIgen is used to generate bindings for C, Objective-C and Swift APIs.
JNIgen is used to generate bindings for Java and Kotlin APIs.

These tools are both experimental and are currently a work in progress. If you find any issues or have feedback, please file it on the corresponding GitHub repositories.

Re-generating bindings

The bindings that allow the Dart code to call the platform code have already been generated in the \lib folder. You can regenerate them by following the steps below:

FFIgen

Configuration of FFIgen for the CoreMotion framework is in the ffigen.yaml file. FFIgen currently does not support autogenerating code to handle callbacks. So, there are a few extra steps needed to appropriately handle callbacks in Objective-C. You can read more about this limitation on dart.dev.

dart run ffigen --config ffigen.yaml

JNIgen

Configuration of JNIgen for the HealthConnect API is in the jnigen.yaml file.

Build an Android APK file from the example app. Currently, JNIgen requires at least one APK build to obtain the classpaths of Android Gradle libraries.
```
cd example && flutter build apk
```

Return to the /pedometer directory and run jnigen:

cd .. && dart run jnigen --config jnigen.yaml

Running the example app

The example app is located in the /example directory, and the following commands assume they are being run from that location.

Note that step counting is only available on physical devices.

iOS

Run flutter run and choose your physical device.
Allow the pedometer app access to step counting.

Android

Make sure that Google Fit is installed (to ensure that steps are being counted).
Run flutter run and choose your physical device.
Install Health Connect and grant access to Google Fit and the jni_demo app.

Project structure

src: Contains the native source code, and a CMakeLists.txt file for building that source code into a dynamic library.
lib: Contains the Dart code that defines the API of the plugin and calls into the native code using dart:ffi.
platform folders (ios etc.): Contain the build files for building and bundling the native code library with the platform application.
example: Contains the native source code for building that source code into a dynamic library.