Rust在Android端集成使用详解

 更新时间:2024年11月05日 10:02:07   作者:良技漫谈  
本文介绍了如何在Android平台上调用Rust编写的组件,详细说明了开发环境的搭建、Rust库的创建、配置和编译过程,以及如何在Android应用中使用Rust编写的代码,文中提到飞书底层使用Rust编写通用组件,展示了Rust在移动端开发中的应用价值

Andorid调用Rust

  • 目前Rust在移动端上的应用,一般作为应用sdk的提供,供各端使用,目前飞书底层使用Rust编写通用组件。
  • 该篇适合对Android、Rust了解,想看如何做整合,如果想要工程源码,可以评论或留言有解疑也可进行询问(更多最新文章也可关注微信公号:良技漫谈)

一.开发环境:

  •  确保rust开发环境,推荐官方文档, 安装即可
  •  Android相关开发环境,需要NDK的下载安装
  •  环境变量的配置,为命令行使用提供全局环境

开发工具:

1. 如果对android studio比较熟悉,可安装rust插件 

安装完毕,对Rust Toolchain 位置进行配置确认,否则可能对rs文件无法识别,就无法愉快使用studio编写rust

2. 推荐使用VSCode编写rust代码,可以去下载 Visual Studio Code,然后安装rust相关插件即可。

二.创建Android工程:

• 如果对Android比较熟悉,使用studio来创建工程,和其他Android工程创建一样,创建Empty Activity,工程名 AndroidIntegratingRust

先编译通过该空工程,确保依赖资源下载完整。

三,添加rust lib库:

进入到刚创建的AndroidIntegratingRust工程下

1.使用rust Cargo创建 lib库:

Cargo new rust_lib --lib

• 创建成功后会有rust_lib库,结构如下:

├── app
│   ├── build
│   ├── build.gradle
│   ├── libs
│   ├── proguard-rules.pro
│   └── src
├── build
│   └── kotlin
├── build.gradle
├── gradle
│   └── wrapper
├── gradle.properties
├── gradlew
├── gradlew.bat
├── local.properties
├── rust_lib //位置在这
│   ├── Cargo.lock
│   ├── Cargo.toml
│   ├── src
│   └── target
└── settings.gradle

2.编辑Cargo.toml

输入目前需要的jni库依赖, https://crates.io/地址下确认版本, create-type 填写cdylib 动态链接库

[lib]
name = "rust_lib"
crate-type = ["cdylib"]
[dependencies]
jni = "0.20.0"  

3.配置要编译so的linker及target

  • 这个在rust_lib下创建.cargo目录,添加config.toml配置文件
  • 填入linker对应的ndk地址:
[target.aarch64-linux-android]
linker = "/Users/android-sdk-macosx/ndk-bundle/toolchains/llvm/prebuilt/darwin-x86_64/bin/aarch64-linux-android21-clang++"
[target.armv7-linux-androideabi]
linker = "/Users/android-sdk-macosx/ndk-bundle/toolchains/llvm/prebuilt/darwin-x86_64/bin/armv7a-linux-androideabi21-clang++"

ps: 这是我的mac上ndk所在位置,参考Android官方ndk文档。

 准备编译rust代码为so的环境已经准备完

四,编写Android和Rust代码:

创建Android代码, RustGreetings类, 使用kotlin所以用external声明JNI函数

class RustGreetings {
    fun sayHello(to: String): String {
        return greeting(to)
    }
    companion object {
        @JvmStatic external fun greeting(pattern: String): String
    }
}

在Rust lib库下,编写对应的JNI函数映射,从create.io下可以看到有关JNI的使用,代码如下

use jni::JNIEnv;
// These objects are what you should use as arguments to your native
// function. They carry extra lifetime information to prevent them escaping
// this context and getting used after being GC'd.
use jni::objects::{JClass, JString};
// This is just a pointer. We'll be returning it from our function. We
// can't return one of the objects with lifetime information because the
// lifetime checker won't let us.
use jni::sys::jstring;
// This keeps Rust from "mangling" the name and making it unique for this
// crate.
#[no_mangle]
pub extern "system" fn Java_com_android_integratingrust_RustGreetings_greeting(
    env: JNIEnv,
    // This is the class that owns our static method. It's not going to be used,
    // but still must be present to match the expected signature of a static
    // native method.
    class: JClass,
    input: JString,
) -> jstring {
    // First, we have to get the string out of Java. Check out the `strings`
    // module for more info on how this works.
    let mut input: String = env
        .get_string(input)
        .expect("Couldn't get java string!")
        .into();
    input = append_string(&input);
    // Then we have to create a new Java string to return. Again, more info
    // in the `strings` module.
    let output = env
        .new_string(format!("Hello, {}!", input))
        .expect("Couldn't create java string!");
    // Finally, extract the raw pointer to return.
    output.into_raw()
}
//============== rust code ===============
fn append_string(value: &str) -> String {
    let mut origin = String::from(value);
    origin.push_str("this is Rust");
    return origin;
}
 

五,编译Rust代码为so

  • 编译之前确认之前rust环境是可以使用的了,且要看下rustup target 下是否已经有要交叉编译的工具了。
  •  rustc --print target-list | grep android 可以查看相关android 交叉编译工具,(我们demo之前在配置target时,使用了32和64位的ARM CPU 架构linker)
aarch64-linux-android
arm-linux-androideabi
armv7-linux-androideabi
i686-linux-android
thumbv7neon-linux-androideabi
x86_64-linux-android

 如果没有安装,需要安装下对应的

rustup target add aarch64-linux-android armv7-linux-androideabi
  •  rustup show 可以看到当前rust开发语言环境,包括 (installed targets for active toolchain)
  •  rustup target list可以查看到那些已经安装和rust支持的。

执行编译

到rust_lib目录下执行编译

cargo build --target aarch64-linux-android --release

 编译成功到target目录下release下去查看对应的so文件

.
├── CACHEDIR.TAG
├── aarch64-linux-android
│   ├── CACHEDIR.TAG
│   └── release
├── armv7-linux-androideabi
│   ├── CACHEDIR.TAG
│   └── release
├── debug
│   ├── build
│   ├── deps
│   ├── examples
│   └── incremental
└── release
    ├── build
    ├── deps
    ├── examples
    └── incremental

六,使用rust代码运行工程

    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/libs']
        }
    }
  •  copy 对应的so文件到 Android工程下src/main/libs下
  •  在Android工程下build.gradle下记得引用so为jniLibs

到此这篇关于Rust在Android端集成使用介绍的文章就介绍到这了,更多相关Rust Android集成使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 在Rust中编写自定义Error的详细代码

    在Rust中编写自定义Error的详细代码

    Result<T, E> 类型可以方便地用于错误传导,Result<T, E>是模板类型,实例化后可以是各种类型,但 Rust 要求传导的 Result 中的 E 是相同类型的,所以我们需要编写自己的 Error 类型,本文给大家介绍了在Rust中编写自定义Error的详细代码,需要的朋友可以参考下
    2024-01-01
  • Rust实现面向对象的方法

    Rust实现面向对象的方法

    这篇文章主要介绍了Rust实现面向对象的方法,Rust 并不是面向对象的语言,但是面向对象的功能都可以通过自身的特点来实现,本文通过示例代码给大家详细讲解,需要的朋友可以参考下
    2022-10-10
  • Tauri 打开本地文件踩坑分析解决

    Tauri 打开本地文件踩坑分析解决

    这篇文章主要为大家介绍了Tauri 打开本地文件踩坑分析解决,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • 关于Rust编译时报link.exe not found错误问题

    关于Rust编译时报link.exe not found错误问题

    这篇文章主要介绍了Rust编译的时候报出link.exe not found错误问题,解决方法是在命令行就是CMD执行相应的命令即可,本文给大家分解决方法,需要的朋友可以参考下
    2022-09-09
  • Rust突破编译器限制构造可修改的全局变量

    Rust突破编译器限制构造可修改的全局变量

    这篇文章主要为大家介绍了Rust突破编译器限制构造可修改的全局变量示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • 如何使用Rust写个猜数字游戏

    如何使用Rust写个猜数字游戏

    这篇文章主要介绍了Rust写个猜数字游戏,本项目通过动手实践,介绍了Rust新概念:let、match、函数、使用外部 crate 等,接下来的文章,你会继续深入学习这些概念,并且介绍大部分编程语言都有的概念,如变量、数据类型和函数,以及如何在 Rust 中使用它们,需要的朋友可以参考下
    2023-12-12
  • Rust用宏实现参数可变的函数的实现示例

    Rust用宏实现参数可变的函数的实现示例

    本文主要介绍了Rust用宏实现参数可变的函数的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-03-03
  • 深入讲解下Rust模块使用方式

    深入讲解下Rust模块使用方式

    很多时候,我们写的代码需要按模块组织,因为我们无法将大量的代码都写在一个文件上,那样不容易维护,下面这篇文章主要给大家介绍了关于Rust模块使用方式的相关资料,需要的朋友可以参考下
    2022-03-03
  • 如何使用bindgen将C语言头文件转换为Rust接口代码

    如何使用bindgen将C语言头文件转换为Rust接口代码

    这篇文章主要介绍了使用bindgen将C语言头文件转换为Rust接口代码,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-01-01
  • rust交叉编译问题及报错解析

    rust交叉编译问题及报错解析

    这篇文章主要为大家介绍了rust交叉编译问题及报错解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-07-07

最新评论