当前公开版本为 0.2.0。普通 SDK 包面向 netstandard2.0 / netstandard2.1，CLI 需要 .NET 10。目标框架兼容不代表所有操作系统、RID、AOT 或单文件发布方式都已验证。
安装转换元包
需要 DOCX、PDF 和 SVG 转换时，安装聚合包即可：
dotnet add package Ofdrw.Net.Converter --version 0.2.0该元包引用 Converter.Docx、Converter.Pdf 和 Converter.Svg，适用于快速开始中的转换示例。
按任务选择包
只需一个能力时，直接安装对应包，版本保持一致。
| 任务 | 包 | 主要入口 |
|---|---|---|
| DOCX ↔ PDF、DOCX → OFD | Ofdrw.Net.Converter.Docx |
DocxToOfdConverter、DocxToPdfConverter |
| PDF → OFD、OFD → PDF/PNG/JPEG、图片 → OFD | Ofdrw.Net.Converter.Pdf |
PdfToOfdConverter、OfdToPdfConverter、图片转换器 |
| OFD → SVG/静态 HTML | Ofdrw.Net.Converter.Svg |
OfdToSvgConverter、OfdToHtmlConverter |
| 流式排版、表格、绘图、页面编辑 | Ofdrw.Net.Layout |
FlowDocument、OfdDocumentBuilder、OfdGraphics |
| 写出 OFD 包 | Ofdrw.Net.Packaging |
OfdPackageWriter |
| 读取 OFD、提取文本 | Ofdrw.Net.Reader |
OfdReader、OfdTextExtractor |
| 签名结构与摘要完整性检查 | Ofdrw.Net.Signatures |
OfdSignatureService、OfdSignatureVerifier |
| 固定字体塑形与有界查询 | Ofdrw.Net.Text.HarfBuzz |
HarfBuzzTextPrelayout |
例如，只生成和写出 OFD：
dotnet add package Ofdrw.Net.Layout --version 0.2.0
dotnet add package Ofdrw.Net.Packaging --version 0.2.0只读取已有 OFD：
dotnet add package Ofdrw.Net.Reader --version 0.2.0常用类的完整命名空间见 SDK 入口索引。随程序集分发的 XML 文档可用于查看具体公开成员。
安装 CLI
先安装 .NET 10，再安装全局工具并检查帮助：
dotnet tool install --global Ofdrw.Net.Cli --version 0.2.0
ofdrw --help如已安装 CLI，可用以下命令更新至 0.2.0。
dotnet tool update --global Ofdrw.Net.Cli --version 0.2.0常用命令和页号规则见 CLI 参考。
字体、原生依赖与可选扩展
- 字体不随主包分发。 处理中文 DOCX 或要求跨机器一致显示时，准备许可明确的实际字体文件，并按字体指南配置。仅设置
FontFamily名称不等于提供字体字节。 - Native DOCX 不调用 Office。 直接 DOCX→PDF 和 DualLayer 可能使用 Word、LibreOffice 或 BuiltIn 渲染路径；图片导出还依赖 PDF/PDFium 原生链路。
- 可选扩展单独核对。 PDF Vector、Skia、Password、SES interop 是独立源码扩展，不在默认 12 包发布集合中。使用前核对各自目标框架、原生资产、许可和本地构建版本，不假定存在与主包同号的公开扩展包。