使用指南:cargo-ndk —— 面向Android的Rust编译工具

使用指南:cargo-ndk —— 面向Android的Rust编译工具

cargo-ndk Compile Rust projects against the Android NDK without hassle cargo-ndk 项目地址: https://gitcode.com/gh_mirrors/ca/cargo-ndk

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代码。

cargo-ndk Compile Rust projects against the Android NDK without hassle cargo-ndk 项目地址: https://gitcode.com/gh_mirrors/ca/cargo-ndk

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

田廷珉

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值