记录Android集成Rust项目的过程

给公司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 "]

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里面的数据转换

你可能感兴趣的:(记录Android集成Rust项目的过程)