给公司APP找到了一个生成高清GIF的库,作者提供了ios版本的a文件,和一个c的头文件给ios端调用,但是没有提供对应Android使用的so库,ios产品集成进去后效果不过,核心使用了一些色彩抖动算法,打算移植到Android端使用,该库底层是RUST实现。
以下是移植到Android端的过程(基于windows 10 64位操作系统):
1.配置Android开发使用rust的环境
安装rust
下载并配置 mingw-w64环境变量
下载并配置llvm-mingw-20211002-ucrt-x86_64环境变量
安装NDK并配置toolchains\llvm\prebuilt\windows-x86_64\bin 的环境变量
确保NDK_HOME,JAVA_HOME 等用户变量配置正确
为了应对部分rust依赖编译报错找不到 stdio.h标准库的错误(原因是因为默认下载的LLVM环境没有设置好NDK需要的编译链),设置CC环境和PKG_CONFIG_SYSROOT_DIR环境
cc指的是clang路径(上图里的llvm中包含clang.exe程序),PKG_CONFIG_SYSROOT_DIR 指的是ndk中sysroot路径(百度 clang ndk sysroot 可以了解相关知识)
配置结果如下图所示
path:
关于NDK交叉编译rust(c)项目的编译环境准备完毕
2 . cargo目录下添加 配置文件
例如在 C:\Users\Administrator\.cargo文件夹下 新增 config文件
为了打包出v7a 和 arm64-v8a 的俩个so库,需要进行如下配置,ar 和linker直接指向ndk提供的预编译文件即可,我看好多文章都说使用sh文件生成,感觉没有必要。
[source.crates-io]registry = "https://github.com/rust-lang/crates.io-index"replace-with = 'ustc'[source.ustc]registry = "https://mirrors.ustc.edu.cn/crates.io-index/"
[target.aarch64-linux-android]
ar = "C:\\Users\\mayn\\AppData\\Local\\Android\\Sdk\\ndk-bundle\\toolchains\\llvm\\prebuilt\\windows-x86_64\\bin\\aarch64-linux-android-ar.exe"
linker = "C:\\Users\\mayn\\AppData\\Local\\Android\\Sdk\\ndk-bundle\\toolchains\\llvm\\prebuilt\\windows-x86_64\\bin\\aarch64-linux-android28-clang.cmd"
[target.armv7-linux-androideabi]
ar = "C:\\Users\\mayn\\AppData\\Local\\Android\\Sdk\\ndk-bundle\\toolchains\\llvm\\prebuilt\\windows-x86_64\\bin\\arm-linux-androideabi-ar.exe"
linker = "C:\\Users\\mayn\\AppData\\Local\\Android\\Sdk\\ndk-bundle\\toolchains\\llvm\\prebuilt\\windows-x86_64\\bin\\armv7a-linux-androideabi28-clang.cmd
3.在源rust项目中的Cargo.toml文件下添加 jni支持,即可开始编写我们需要的jni接口了
[package]name = "mylib"
version = "0.1.0"
authors = ["Josh Chase <josh@prevoty.com>"]
edition = "2018"
[dependencies]
jni = "0.19.0"
[lib]
crate_type = ["cdylib"]
可以参考官方链接
https://github.com/jni-rs/jni-rs/tree/master/example
配置好cargo项目后,使用
cargo build --target aarch64-linux-android --release
cargo build --target armv7-linux-androideabi --release
可以打出对应的Android 架构so库 在 target/对应架构/release/deps下面可以找到
然后放到项目中使用,因为是交叉编译,Android想调试目前还没有好的办法,我的做法是一步步调试参数去进行开发。
4 . 开发中遇到的问题
首先肯定是不熟悉rust语言导致的问题,尤其是 rust语言的数据类型和jni的数据类型转换之间遇到的困难。
如何获得句柄?
通常我们在rust 拿到 对象指针 形如
pub struct Handle{
}
g = *const Handle
可以直接 g as jlong 返回一个long类型地址给java层
使用句柄的时候 handle as *const Handle 即可拿到此地址的对象,和C的操作别无二致
env.get_string_utf_chars 也会报错?
pub extern "system" fn Java_com_xxx(env: JNIEnv,_class: JClass,add_path: JString,jj jlong){
env.get_string_utf_chars(add_path).unwrap();
}
遇到过getStringUTF报错 疯狂注释-》打包再调试之后发现是我的入参有一个不和规范,但是通过logcat看到的错误是获取字符串错误,由此可知
RUSTJNI 如果函数入口参数报错 会报错在内部第一句话上,通常有日志 invalid object时,请检测 接口参数是否和java层有出入
5,总结
最后还是成功的把一个rust项目集成进了Android项目中,也通过这次经历实践了一下NDK交叉编译的过程,有时候标准库头文件找不到,链接器等等的配置,包括 rust c java里面的数据转换