cn-font-split Rust Version!

cn-font-split 代码架构

cn-font-split 是一个复杂的字体分包系统，整体架构分为三个主要部分：core、message_channel 和 wrapper。

1. Core

core 是 cn-font-split 的核心部分，负责实际的字体分包操作。它通过接收回调函数作为参数，实现异步数据返回。core 内部主要包含以下三个核心逻辑模块：

• 预分包（pre_subset）：在进行实际分包操作之前，预处理字体数据，进行多语言的分包优化，确定分包内字符。
• 批量分包（run_subset）：处理大批量字体数据的分包操作，确保在高负载情况下依然能够高效运行。
• 链接分包（link_subset）：将分包后的字体数据进行链接和整合，生成最终的分包结果。

这些操作基于 harfbuzz 和 opentype 库实现，确保了对字体操作的高效和准确。

2. Message Channel

message_channel 是 cn-font-split 与外部系统交互的桥梁，基于 protobuf（Protocol Buffers）实现。所有的交互接口通过 cn-font-proto 库进行定义和创建。protobuf 提供了二进制数据传输和自动代码生成功能，保障了接口的稳定性和可扩展性。

需要注意的是，在 Rust 项目之间，message_channel 仅借用了 protobuf 生成的结构定义，并不需要构建为二进制格式。只有在 Rust 与其他语言交互时，才会使用到二进制序列化。

3. Wrapper

wrapper 是 cn-font-split 对外提供的功能接口，支持多种语言调用和不同的部署方案。wrapper 主要包括以下几种实现：

• ✅ gRPC Wrapper：基于 HTTP/2 协议，提供独立的字体构建服务。gRPC 方案简单易用，适用于所有支持 gRPC 的项目。
• ✅ FFI Wrapper：通过标准的 C API 调用 Rust 生成的二进制动态链接库，使用 protobuf 解析二进制数据，支持双边语言通信。
• ✅ CLI Wrapper：提供一个命令行接口，完全由 Rust 编写，用户可以通过简单的命令完成基础的字体分包操作。
• ✅ WASI Wrapper：基于 WebAssembly System Interface (WASI)，支持在多种操作系统环境中运行，提供更广泛的部署可能性。浏览器可以通过 WASI（@tybys/wasm-util ）实现完成接入。

命名规范

1. Rust 项目统一采用 snake_case, 会有 IDE 相应提示。

2. 包名统一用 - 链接，而不是 _。

Dev

为统一不同开发环境，采用 VSCode Dev Container 方法

开发使用设备最好 MacOS 8GB、Windows 16GB 以上, 具备 Docker 环境，一键进入开发状态！

如果遇到某些依赖没安装，可以参考 Developer.md