使用指南:cargo-ndk —— 面向Android的Rust编译工具
cargo-ndk 是一个专为在Android平台上构建Rust代码而设计的Cargo扩展,它简化了环境配置,确保能够顺利生成适用于Android的库文件,并支持正确的jniLibs目录结构布局。
安装指南
要开始使用cargo-ndk,首先通过Cargo安装该扩展:
cargo install cargo-ndk
紧接着,确保安装所需的Android目标平台工具链:
rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android i686-linux-android
上述命令将添加对不同架构的支持。
项目使用说明
cargo-ndk自动检测由Android Studio安装的NDK的默认位置并使用最新版本。如需指定特定NDK路径,则设置ANDROID_NDK_HOME
环境变量。
构建示例
若需为32位和64位ARM系统构建库,执行以下命令:
cargo ndk -t armeabi-v7a -t arm64-v8a -o ./jniLibs build --release
这指定了构建的目标、输出目录以及传递给Cargo的常规标志。
链接与复制libc++_shared.so
在项目中创建build.rs
文件,并加入以下代码来自动处理共享库的链接与复制:
use std::{env, path::PathBuf};
fn main() {
if env::var("CARGO_CFG_TARGET_OS").unwrap() == "android" {
android();
}
}
fn android() {
println!("cargo:rustc-link-lib=c++_shared");
if let Ok(output_path) = env::var("CARGO_NDK_OUTPUT_PATH") {
let sysroot_libs_path = PathBuf::from(env::var_os("CARGO_NDK_SYSROOT_LIBS_PATH").unwrap());
let lib_path = sysroot_libs_path.join("libc++_shared.so");
std::fs::copy(
lib_path,
Path::new(&output_path)
.join(&env::var("CARGO_NDK_ANDROID_TARGET").unwrap())
.join("libc++_shared.so"),
).expect("Copying shared library failed.");
}
}
控制日志级别
在Cargo命令后加上-v
或-vv
以调整详细程度。
API使用文档
cargo-ndk不直接提供API接口供应用程序调用,但通过一系列环境变量影响构建过程和脚本行为。重要环境变量有:
CARGO_NDK_ANDROID_PLATFORM
:Android平台API编号。CARGO_NDK_ANDROID_TARGET
:当前构建目标(例如armeabi-v7a
)。CARGO_NDK_OUTPUT_PATH
:指定的输出目录。- 其他环境变量允许你在构建脚本和其他场景下利用这些信息进行更精细的控制。
支持的主机系统
- Linux
- macOS (
x86_64
,arm64
) - Windows
对于本地开发,直接从源码安装即可:
git clone [仓库URL]
cd [克隆的仓库]
cargo install --path .
cargo-ndk为开发者提供了便捷途径来整合Rust与Android生态,通过以上步骤,您现在应该具备了所有必要的知识来有效地在Android项目中使用Rust代码。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考