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