引言

前面通过自定义函数去调用Android Log类的方式，实现了在 Rust NDK 中输出logcat。但是每次调用总归需要一个 env 对象去查找Log类，要如何像C/C++那样直接通过宏函数调用呢？

开发环境

操作系统：Windows 11

编码软件：Visual Studio Code 1.93.1 | Android Studio Ladybug | 2024.2.1 Beta 1

正文

其实像C/C++那样直接通过宏调用在 rust crates 社区已经有相关的 android log 实现库了。

也就是上面提到的这个库，使用方式呢也很简单，直接上例子。

首先，我们创建一个 rust lib 项目example_3，然后通过vscode打开它。

上图，修改了Cargo.toml增加了两个依赖。

其中，值得注意的是log这个 crates 并不是一个具体的实现，它类似于一个规范，提供了一系列的宏函数。用面向对象的说法来解释，你就将它当做一个接口吧（也不知道这么解释合不合理）。

然后，只需要在lib.rs中简单书写以下代码就可以完成logcat的打印输出。

结果展示

刨一下android_log_rs的实现

首先把仓库 android_log-rs clone下来，通过vscode打开。

这里贴一下上面的代码

#[no_mangle]
extern "C" fn Java_com_example_RustLog2_log2(_env: JNIEnv, _thiz: JObject) {
    android_log::init("RustLog2").unwrap(); //初始化
    info!("Hello, RustLog2! Level: INFO!");
    debug!("Hello, RustLog2! Level: DEBUG!");
    warn!("Hello, RustLog2! Level: WARN!");
    error!("Hello, RustLog2! Level: ERROR!");
}

首先，需要通过 android_log::init("RustLog2").unwrap(); 去初始化这个lib，我们跟进去。

可以看见，android_log::init在调用了 AndroidLogger::new 函数后，紧接着又调用了 AndroidLogger::init的函数，设置了log::set_logger。

到这儿，就表示全局日志记录被初始化了。

...
    log::set_logger(|max_level| {
        max_level.set(LogLevelFilter::max());
        Box::new(self)
    })
...

我们回到上一步android_log::init调用 AndroidLogger::new的时候，可以看到这个函数实际上是直接对LogBuilder::new(tag).build()进行调用了，如下图表示。

也就是把 AndroidLogger 构建了出来。

那么既然对象构建出来了，那如何调用呢？

别着急，我们往上看几行，从第100行的代码开始，AndroidLogger这个结构体就实现了Log这个trait。

那这个trait就允许通过程序通过info!(...), debug!(...), warn!(...) ... 等系列宏去调用log函数，来实现日志方法 log 的调用。

到了这里，文章开始写下的example_3各种打印日志的宏的具体实现才浮出了水面。

但是呢，上图圈出来的黄色框里的部分才是真正的android log打印方法。

我们点进去之后就会发现，它实际上是另一个 crates 库的实现，也就是下面贴的这个。

眼熟不？这不就是C/C++的用法么？

到这儿，这个 crates 的实现基本上就已经刨出来了。

简单总结一下流程，实际上 android_log 就是对 android_log-sys 进行了一个包装，并且引入了 log 这个 crates 来简化了log的打印调用，让它具有了宏的特性。

而真正的核心android log核心其实是 android_log-sys，它通过 rust 的 ffi 对于C接口提供了支持。

是不是很简单呢？Ok，本篇完。