cn-font-split

Crates.iocn-font-split
lib.rscn-font-split
version
sourcesrc
created_at2024-12-07 01:23:15.422227
updated_at2024-12-07 01:23:15.422227
description划时代的字体切割工具，CJK与任何字符！支持 otf、ttf、woff2 字体多线程切割，完美地细颗粒度地进行包大小控制。A revolutionary font subetter that supports CJK and any characters! It enables multi-threaded subset of otf, ttf, and woff2 fonts, allowing for precise control over package size.
homepagehttps://chinese-font.netlify.app/
repositoryhttps://github.com/konghaYao/cn-font-split
max_upload_size
id1474951
Cargo.toml error:TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
江夏尧 (KonghaYao)

documentation

README

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

Commit count: 125

cargo fmt