Android Rust JNI系列教程(一) 环境配置

序

本系列文章将从rust环境搭建开始,逐步带大家了解使用rust进行Android JNI开发的基本技能.相关文章共分为如下几步:

1. Rust JNI环境搭建.
2. 创建第一个Rust JNI项目
3. Rust与Android互相调用
4. Rust 调用Android API 实现签名验证
5. Rust 使用openssl 实现Android签名验证

每一章文末都会稍带一些扩展知识,大家了解即可,真正需要时再去细究.

安装

在Linux或者mac上安装rust

一行命令

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

如果你使用的是Windows系统,可以参考https://www.rust-lang.org/tools/install和https://course.rs/first-try/installation.html

验证rust是否安装成功

1. 验证rustc,命令行输入:

rustc --version  

安装成功的话会有如下输出:

rustc 1.65.0 (897e37553 2022-11-02)

其中1.65.0 (897e37553 2022-11-02)为版本号,读者们不必追求版本号与文章一致,以本地的版本号为准.

2. 验证cargo,命令行输入:

cargo --version 

输出如下:

cargo 1.65.0 (4bc8f24d3 2022-10-20)

同样,1.65.0 (4bc8f24d3 2022-10-20)只是版本号,不必追求与文章一致.

交叉编译环境

1. rust 安装交叉编译组件,其中:

aarch64-linux-android 对应 arm64-v8a
armv7-linux-androideabi 对应 armeabi-v7a
我们以aarch64-linux-android 为例,安装命令如下:

rustup target add aarch64-linux-android 

2. 验证

安装完成后,使用以下命令进行验证:

rustup target list

获取输出如下:

aarch64-apple-darwin
aarch64-apple-ios
aarch64-apple-ios-sim
aarch64-fuchsia
aarch64-linux-android (installed)
aarch64-pc-windows-msvc
aarch64-unknown-linux-gnu
aarch64-unknown-linux-musl
aarch64-unknown-none
aarch64-unknown-none-softfloat
arm-linux-androideabi
arm-unknown-linux-gnueabi
arm-unknown-linux-gnueabihf
arm-unknown-linux-musleabi
...

其中aarch64-linux-android (installed),代表我们已经安装好aarch64-linux-android组件了.
同时我们也可以看到,rust交叉编译所支持的平台非常多,更加完整的介绍可见https://doc.rust-lang.org/nightly/rustc/platform-support.html.

3. 配置config文件

• 在~/.cargo文件夹下,查看是否存在名为config的文件,不存在的话直接创建即可.
• 编辑config文件,内容如下:

[target.aarch64-linux-android]
ar = "<path>/NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android-ar"
linker = "<path>/NDK/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android30-clang"

另请注意,rust官方关于配置ndk的文档已经很久没更新过了,仅供参考https://mozilla.github.io/firefox-browser-architecture/experiments/2017-09-21-rust-on-android.html. 文中所说${NDK_HOME}/build/tools/make_standalone_toolchain.py --api 26 --arch arm64 --install-dir NDK/arm64 这部分操作已经不再需要了.在我的NDK版本22.1.7171670下已经内置了aarch64-linux-android-ar和aarch64-linux-android30-clang,不再需要重新编译.

扩展知识(了解即可,等到真正需要的时候再去研究)

cross (https://github.com/cross-rs/cross)

“Zero setup” cross compilation and “cross testing” of Rust crates

cross这个工具会让交叉编译更简单,简单理解就是cross在容器里已经配置好了NDK等环境,我们只管开发完代码之后执行 cross build --target aarch64-linux-android --release就可编译出android对应的arm64-v8a的so文件了,不再需要在本机上再手动配置NDK和config文件.笔者本机环境Ubuntu 22.04使用cross编译android平台的so文件,x86_64的Windows可执行文件以及mips的路由器端可执行文件,使用起来很方便.

结语

本章结束后,本机环境信息如下

$ rustc --version                                                          
rustc 1.65.0 (897e37553 2022-11-02)
$ cargo --version                                                      
cargo 1.65.0 (4bc8f24d3 2022-10-20)

NDK: 22.1.7171670

交叉编译组件:aarch64-linux-android
我们将在此环境下开始接下来的rust-jni的学习.

Android项目地址:https://github.com/tangxuesong6/Android_Rust_JNI_Demo
rust项目地址:https://github.com/tangxuesong6/Rust_JNI_Demo