Flutter Rust Bridge 日志记录问题解析与解决方案

问题背景

在使用 Flutter Rust Bridge 进行跨平台开发时，开发者经常会遇到 Rust 日志无法正常显示的问题。这个问题尤其常见于 iOS 和 Android 平台，表现为各种日志宏（如 debug!、info!、warn! 和 println!）调用后控制台没有任何输出。

问题分析

经过深入调查，我们发现这个问题主要涉及以下几个方面：

1. 日志系统初始化：Flutter Rust Bridge 的日志系统需要显式初始化才能正常工作
2. 平台差异：不同平台（iOS/Android）使用不同的底层日志实现
3. Cargo 特性配置：需要正确配置 Cargo.toml 中的特性标志

解决方案

1. 基础配置

首先，确保在 Cargo.toml 中正确配置了依赖项：

[dependencies]
flutter_rust_bridge = { version = "=2.2.0", features = ["log"] }
log = "0.4.22"

关键点在于必须启用 log 特性，这是许多开发者容易忽略的步骤。

2. 初始化日志系统

在 Rust 代码中，需要在应用启动时初始化日志系统：

#[flutter_rust_bridge::frb(init)]
pub fn init_app() {
    flutter_rust_bridge::setup_default_user_utils();
}

这个初始化函数会在 Flutter 应用启动时被调用，设置好默认的日志工具。

3. 平台特定注意事项

Android 平台

在 Android 上，日志会通过 android_logger 输出。查看日志的方式有：

1. 直接查看 Flutter 调试控制台，日志会以 I/rust_lib_xxx::xx..(pid number): hello world 格式显示
2. 使用 adb logcat 命令查看完整系统日志

iOS 平台

iOS 使用 oslog 作为底层日志实现，查看日志的方式不同：

1. 使用 macOS 上的 Console 应用查看设备日志
2. 使用 Xcode 的 Instruments 工具查看详细日志

4. 日志宏使用说明

• 有效宏：debug!、info!、warn!、error! 等来自 log crate 的宏
• 无效宏：println! 宏不会显示，因为它是 Rust 标准库的一部分，无法通过常规配置重定向
• panic：panic! 宏会正常显示，但需要通过平台特定的方式查看

高级配置

对于需要更复杂日志处理的场景，可以考虑：

1. 自定义日志实现：覆盖默认的日志工具，实现自己的日志处理逻辑
2. 日志转发到 Dart：通过 Flutter Rust Bridge 的通道机制，将 Rust 日志转发到 Dart 层统一处理
3. 日志级别控制：实现动态调整日志级别的功能

最佳实践

1. 始终在 Cargo.toml 中启用 log 特性
2. 确保初始化函数被正确调用
3. 根据目标平台使用适当的工具查看日志
4. 避免使用 println! 宏，改用标准日志宏
5. 对于生产环境，考虑实现日志分级和过滤机制

总结

Flutter Rust Bridge 的日志系统需要正确的配置才能正常工作。通过理解其工作原理和平台差异，开发者可以有效地解决日志不显示的问题。记住关键的三步：正确配置依赖、初始化日志系统、使用平台特定工具查看日志。