利用Rust与Flutter开发一款小工具

1.起因

起因是年前看到了一篇Rust + iOS & Android｜未入门也能用来造轮子？的文章，作者使用Rust做了个实时查看埋点的工具。其中作者的一段话给了我启发：

无论是 LookinServer 、 Flipper 等 Debug 利器，还是 Flutter / Web Debug Tools，都是在电脑上调试 App。那我们也可以用类似的方式，把实时埋点数据显示在电脑上，不再局限于同一块屏幕。

我司目前的埋点走查是在测试盒子中有一个埋点查看页面，Debug包在数据上报的同时会将信息临时保存起来。当进入这个页面时会以列表的形式展示出来。并且iOS 和Android的页面展示和使用方式也略有不同。

后面我觉得这样进入退出页面查看不方便，就将页面改成了悬浮窗。虽然方便了一些，但是也发现了新的问题：

• 手机上屏幕大小有限，悬浮窗只有屏幕的一半，可展示信息有限。
• 悬浮窗会遮挡页面，有时不便于点击页面上的按钮。

刚好前阵子升级了手机系统到Android 13，发现log在控制台都打印不出来了（后面发现App适配到13就正常了。。）。所以有了一个想法，使用Rust通过WebSocket进行数据发送，使用Flutter实现服务端接收App发送的信息并显示出来。

当然了，如果我们的应用是flutter写的，可以直接使用Dart的ffi来直接调用Rust函数。这个我后面有时间会单独写一篇来分享。

2.实现

之所以选择Rust与Flutter是看中它们的跨平台能力。使用Rust进行WebSocket数据发送，就不用Android和iOS端去重复开发这个功能，只需要简单调用即可，并且Rust有许多开箱即用的库。

Flutter的跨平台能力就更不用说了。比如这个小工具我就可以一套代码输出Windows和macOS两个平台的安装包，保证接收端逻辑和UI的一致。

发送端

Rust部分

关于Rust库的打包以及双端的使用可以看我上一篇分享的Rust库交叉编译以及在Android与iOS使用。这里主要说一下具体的实现代码。

首先是添加WebSocket 库 ws-rs依赖到Cargo.toml文件：

[dependencies]
ws = "0.9.2"
# 全局的静态变量
lazy_static = "1.4.0"

实现代码如下：

use std::collections::HashMap;
use std::sync::Mutex;
use std::{ffi::CStr, os::raw::c_char};
use ws::{connect, Handler, Sender, Handshake, Result, Message, CloseCode, Error};
use ws::util::Token;
#[macro_use]
extern crate lazy_static;lazy_static! {static ref DATA_MAP: Mutex<HashMap<String, Sender>> = {let map: HashMap<String, Sender> = HashMap::new();Mutex::new(map)};
}struct Client {sender: Sender,host: String,
}impl Handler for Client {fn on_open(&mut self, _: Handshake) -> Result<()> {DATA_MAP.lock().unwrap().insert(self.host.to_owned(), self.sender.to_owned());Ok(())}fn on_message(&mut self, msg: Message) -> Result<()> {println!("<receive> '{}'. ", msg);Ok(())}fn on_close(&mut self, _code: CloseCode, _reasonn: &str) {DATA_MAP.lock().unwrap().remove(&self.host);}fn on_timeout(&mut self, _event: Token) -> Result<()> {DATA_MAP.lock().unwrap().remove(&self.host);self.sender.shutdown().unwrap();Ok(())}fn on_error(&mut self, _err: Error) {DATA_MAP.lock().unwrap().remove(&self.host);}fn on_shutdown(&mut self) {DATA_MAP.lock().unwrap().remove(&self.host);}}#[no_mangle]
pub extern "C" fn websocket_connect(host: *const c_char) {let c_host = unsafe { CStr::from_ptr(host) }.to_str().unwrap();if let Err(err) = connect(c_host, |out| {Client {sender: out,host: c_host.to_string(),}}) {println!("Failed to create WebSocket due to: {:?}", err);}
}#[no_mangle]
pub extern "C" fn send_message(host: *const c_char, message: *const c_char) {let c_message = unsafe { CStr::from_ptr(message) }.to_str().unwrap();let c_host = unsafe { CStr::from_ptr(host) }.to_str().unwrap();let binding = DATA_MAP.lock().unwrap();let sender = binding.get(&c_host.to_string());match sender {Some(s) => {if s.send(c_message).is_err() {println!("Websocket couldn't queue an initial message.")};} ,None => println!("None")}
}#[no_mangle]
pub extern "C" fn websocket_disconnect(host: *const c_char) {let c_host = unsafe { CStr::from_ptr(host) }.to_str().unwrap();DATA_MAP.lock().unwrap().remove(&c_host.to_string());
}

简单实现了连接，发送，断开连接三个方法。思路是连接成功后会将发送结构体（Sender）保存在Map中，每次发送时先检查是否连接再发送。这样也就实现了连接多台设备，一对多发送的功能。

Android还需要添加对应的JNI方法：

#[cfg(target_os = "android")]
#[allow(non_snake_case)]
pub mod android {extern crate jni;use self::jni::objects::{JClass, JString};use self::jni::JNIEnv;use super::*;#[no_mangle]pub unsafe extern "C" fn Java_com_weilu_utils_EventLogUtils_sendMessage(env: JNIEnv,_: JClass,host: JString,message: JString,) {send_message(env.get_string(host).expect("invalid pattern string").as_ptr(),env.get_string(message).expect("invalid pattern string").as_ptr(),);}#[no_mangle]pub unsafe extern "C" fn Java_com_weilu_utils_EventLogUtils_connect(env: JNIEnv,_: JClass,host: JString,) {websocket_connect(env.get_string(host).expect("invalid pattern string").as_ptr(),);}#[no_mangle]pub unsafe extern "C" fn Java_com_weilu_utils_EventLogUtils_disconnect(env: JNIEnv,_: JClass,host: JString,) {websocket_disconnect( env.get_string(host).expect("invalid pattern string").as_ptr(),);}
}

至此，发送端部分完成。打包集成进项目就可以使用了。

Android部分

Android端调用代码如下：

public class EventLogUtils {static {System.loadLibrary("event_log_kit");}private static native void sendMessage(final String host, final String message);private static native void connect(final String host);private static native void disconnect(final String host);private static List<String> addressList = null;public static List<String> getAddressList() {return addressList;}/*** 保存 IP 地址，传空时断开所有连接*/public static void saveAddress(String address) {if (TextUtils.isEmpty(address)) {if (addressList != null) {for (String url : addressList) {disconnect(url);}}addressList = null;return;}// 多个地址逗号隔开if (address.contains(",")) {addressList = new ArrayList<>(Arrays.asList(address.split(",")));} else {addressList = new ArrayList<>();addressList.add(address);}for (String url : addressList) {// 子线程调用，可替换为其他方案，这里使用了线程池Executor.getExecutor().getExecutorService().submit(new Runnable() {@Overridepublic void run() {// 循环，如果意外断开，自动重连while (addressList != null) {connect("ws://" + url);}// 工具连接彻底断开}});}}/*** 发送信息*/public static void sendMessage(String message) {if (addressList == null) {return;}for (String url : addressList) {sendMessage("ws://" + url, message);}}
}

代码也比较简单，连接方法在子线程调用，如果发现连接断开会自动重连。

iOS部分就不具体说明了，实现思路一样的。

接收端

首先是发送数据的定义，发送的是json格式字符串。定义的主要参数如下：

class EventLogEntity {/// event/logString type = '';/// 事件名称或log tagString? name;/// 手机型号String? deviceModel;/// 时间戳int time = 0;String data = '';...
}

• type：用于区分数据类型，目前分为埋点事件与log。
• name：事件名称或log tag，用于数据的筛选。
• deviceModel：设备名用于区分数据来源，如果有多个设备同时发送数据可以便于分类。
• time：时间戳，用于数据排序。

其他参数可以根据自己的需求添加，比如log的等级，数据展示时展开或者收起。

UI组件我使用了fluent_ui，它提供了原生Windows应用风格的组件，比较适合桌面端程序。状态管理使用flutter_riverpod。

具体的代码实现就不多说了，主要说一下核心的数据接收部分。

// https://doc.xuwenliang.com/docs/dart-flutter/2499
class WebSocketManager{HttpServer? requestServer;Future startWebSocketListen() async {final String ip = '192.168.31.232';final String port = '51203';stopWebSocketListen();//HttpServer.bind(主机地址，端口号)requestServer = await HttpServer.bind(ip, int.parse(port)).catchError((error) {debugPrint('bind error: $error');});await for(HttpRequest request in requestServer!) {serveRequest(request).catchError((error){debugPrint('listen error: $error');});}}void stopWebSocketListen() {requestServer?.close();requestServer = null;}Future serveRequest(HttpRequest request) {//判断当前请求是否可以升级为WebSocketif (WebSocketTransformer.isUpgradeRequest(request)) {//升级为webSocketreturn WebSocketTransformer.upgrade(request).then((webSocket) {//webSocket消息监听webSocket.listen((msg) async {debugPrint('listen:$msg');if (webSocket.closeCode == null) {// 这里可以回复客户端消息webSocket.add('收到');}// 可以在这里解析数据，刷新页面...});});} else {return Future((){});}}
}

然后为了便于使用，避免使用者自己查询填写ip，我们需要获取当前设备ip地址：

  Future<String> getDeviceIp() async {String ip = "";if (!kIsWeb) {for (var interface in await NetworkInterface.list()) {for (var address in interface.addresses) {ip = address.address;}}}return ip;}

端口可以给个默认值或者自己随便输入一个，然后可以用shared_preferences插件保存用户配置。下次启动时就自动连接了。

手机端可以实现一个输入连接地址的页面，输入电脑端的ip和端口号后就可以发送数据了。或者扫描二维码连接。

3.成果展示

目前实现功能如下：

• 可同时接收多台设备发送数据，数据按机型名称分类展示。
• 数据的筛选，搜索（关键字高亮）。
• 搜索记录的保存。
• json数据格式化展示。

---

因为小工具在公司内部使用，所以就不开源完整的代码了。有了文章中的核心代码，你可以根据自己的需求实现。也不必局限于这些功能，你完全可以通过Rust和Flutter的跨平台能力开发更多功能，本篇也只是抛砖引玉。

如果本篇对你有所启发帮助，不妨点赞支持一下。如果你有好的想法，也欢迎评论交流。

4.参考

• Rust + iOS & Android｜未入门也能用来造轮子？