AsmDraw

嘉立创EDA 专业版（EasyEDA Pro）扩展插件 —— 一键导出 PCB 装配图（矢量 PDF）。

顶层 / 底层各一页合并为单个 PDF，位号自动居中并自适应字号，全过程不修改、不保存原工程。

导出PDF效果图

功能特性

• 一键出图：PCB 编辑器菜单 AsmDraw > 生成装配图，自动完成顶/底层装配图导出；
• 双页矢量 PDF：第 1 页顶层、第 2 页底层（镜像视角），板框定幅 + 标题栏，圆形板框渲染为真圆弧；
• 位号居中：出图前自动将所有器件位号移到器件焊盘包围盒中心，导出后按快照还原；
• 位号字号自适应：按焊盘包围盒缩放（可缩可放，尽可能填满），字体统一 Arial，上限 2mm、下限 0.6mm；
• 位号压顶防遮挡：位号经独立 Gerber 导出包最后绘制，不被丝印、实心钻孔等任何图元遮挡；
• 原工程零污染：所有修改仅发生在编辑器内存，快照还原 + 全程不 save()，异常路径同样回滚；
• 健壮性：重入保护、非 PCB 页守卫、阶段进度条、Gerber 导出失败自动回退默认一键导出。

使用方法

1. 在嘉立创EDA 专业版中安装扩展包 build/dist/asmdraw_v1.0.0.eext；
2. 打开 PCB 编辑器页面，点击菜单 AsmDraw > 生成装配图；
3. 在保存对话框中选择输出位置，得到 <工程名>_Assembly.pdf（如 MyBoard_Assembly.pdf，工程名前导 _ 自动去除）。

配置项（AsmDraw > 设置）

渲染色号规范

项目结构

├── extension.json      扩展配置（菜单注册、logo、版本）
├── images/             扩展图标
├── src/
│   ├── index.ts        入口：菜单注册与回调导出
│   ├── orchestrator.ts 主流程编排：预检 → 位号调整 → 导出 → finally 还原
│   ├── refCenter.ts    位号快照/还原、居中、字号自适应（Arial）
│   ├── asmRender.ts    Gerber 导出调度 → ZIP 解包 → 角色分类 → pdf-lib 合成
│   ├── gerber.ts       RS-274X / Excellon 解析器（纯函数，可离线测试）
│   ├── config.ts       配置模型与持久化（sys_Storage）
│   ├── settings.ts     设置菜单（配置向导）
│   └── guard.ts        还原兜底与保存事件守卫
├── build/              打包脚本（esbuild + .eext 打包）
└── docs/               技术方案文档

数据流：getGerberFile() 顶/底/位号共 4 次导出 → JSZip 解包 → parseGerber/parseExcellon → renderAssemblyPdfBytes()（纯函数）→ sys_FileSystem.saveFile()。

主要依赖：jszip（解 Gerber ZIP）、pdf-lib（矢量 PDF 合成），esbuild 全部打包进 dist/index.js。

开发与构建

基于 easyeda-api-sdk 开发工具组（SDK 1.6.28 / @jlceda/pro-api-types）。

npm install        # 安装依赖
npm run compile    # 编译到 dist/
npm run build      # 编译并打包 build/dist/asmdraw_v1.0.0.eext

静态检查：

npx tsc --noEmit
npm run lint

文档

详细设计、决策记录与真机验证踩坑记录见 AsmDraw 插件技术方案 v2.0。

开源许可

Apache License 2.0