4 stable releases
2.12.6 | Feb 14, 2023 |
---|---|
2.10.1 | Jul 25, 2022 |
2.7.0 | Mar 22, 2022 |
2.5.0 | Feb 10, 2022 |
#506 in Cargo plugins
33KB
745 lines
cargo-xdk - Build Rust code for Android
This cargo extension handles all the environment configuration needed for successfully building libraries
for Android from a Rust codebase, with support for generating the correct jniLibs
directory structure.
Installing
cargo install cargo-xdk
You'll also need to install all the toolchains you intend to use. Simplest way is with the following:
rustup target add \
aarch64-linux-android \
armv7-linux-androideabi \
x86_64-linux-android \
i686-linux-android
Modify as necessary for your use case.
Usage
If you have installed the NDK with Android Studio to its default location, cargo ndk
will automatically detect
the most recent NDK version and use it. This can be overriden by specifying the path to the NDK root directory in
the ANDROID_NDK_HOME
environment variable.
Example: building a library for 32-bit and 64-bit ARM systems
cargo ndk -t armeabi-v7a -t arm64-v8a -o ./jniLibs build --release
This specifies the Android targets to be built, the output directory to use for placing the .so
files in the layout
expected by Android, and then the ordinary flags to be passed to cargo
.
Supported hosts
- Linux
- macOS (x86_64 and arm64)
- Windows
Why not using cargo-ndk?
This project is just a fork of cargo-ndk; But the author refused to add features, such as #43, so I republish it.
Local development
git clone
and then install the crate with cargo
:
cargo install --path .
Similar projects
- cargo-cocoapods - for building .a files for all Apple platforms, and bundling for CocoaPods
License
This project is licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
Dependencies
~5–14MB
~179K SLoC