rust-android-sample

This is a sample app that shows how we can use Rust programming language to build shared code that can be used by Android apps. This project is based in the mozilla/rust-android-gradle plugin, specifically in its app sample.

What does this sample do?

In this sample we build a very small Rust library and a very simple Kotlin Android app that uses that library. The app just call the Rust library and gets a result back using callback

How to build and deploy?

Follow the Get started section from the Rust main site.
Clone the repo, and open it in Android Studio.
Install all the specific toolchains that you will need/use. Find more info here.
Click on build/deploy app. It should automatically build and deploy in an emulator/device.

If you are in Windows and you find some issues when building about not able to find lgcc, please, have a look to this issue. I followed this hack and it works. At least is good enough till this issue is fixed.

If you want just to create your own app using the rust-android-gradle plugin, follow its README instructions.

Useful resources

Get started with Rust.
Rust language reference.
Building and deploying a Rust library on Android.
Rust on Android + its sample code.
Rust-Android-Gradle plugin and its samples.
Crate JNI (note: as writing this latest is 0.19.0).
The Manifest format.
If you found issues when using NDK >= 23, please check this.
How to fix NDK is not installed issue. Please, read this.
If you find issues when using NDK >- 23 on Windows complaining about not finding lgcc library, please, read this.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License