通过确保开发人员仅编译与正在开发的 插件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发 期间删除构建 KiCad 的要求极大地提高了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而 无需对支持的每种新模型类型的 KiCad 源进行重大更改。 插件框架后来被推 广，以便将来开发人员可以创建不同类型的插件。 目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 声明了 3D 插件类的加载器。加载器负 责加载给定的插件并使其功能可用于 KiCad。插件加载器的每个实例代表一个 实际的插件实现，并充当 KiCad 和插件功能之间的透明桥梁。加载器不是 KiCad 中支持插件所需的唯一代码：我们还需要代码来发现插件和代码，以通 过插件加载器调用插件的功能。在 3D 插件的情况下，发现和调用功能都包含 在 S3D_CACHE 类中。 除非正在开发新的插件类，否则插件开发人员不需要关心 插件类 API 的版本信息，提供 特定插件的版本信息，并提供插件类 API 的基本版本兼容性检查。 简而言 之，这些功能是： /* 返回命名插件类的 UTF-8 字符串 */ /* Return a UTF-8 string naming the Plugin Class */ char const* GetKicadPluginClass( void ); /* 返回插件类API的版本信息

. . . . . . . . 12 3 应用程序编程接口（API） 21 3.1 插件类 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.1 API：Base Kicad 插件类 . . . . . . . . . . . . . . . . . . . . . . . . 21 3.1.2 API：3D 插件类 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 3.2 场景图类 API . . . . . . . . . . . . . . . . . . . . . 插 件直接相关的代码，从而减少每个构建和测试周期所需的时间，在插件开发期间删除构建 KiCad 的要求极大地提高 了工作效率。 插件最初是为 3D 模型查看器开发的，因此可以支持更多类型的 3D 模型，而无需对支持的每种新模型类型的 KiCad 源进行重大更改。插件框架后来被推广，以便将来开发人员可以创建不同类型的插件。目前，只有 3D 插件在 KiCad 中实现，但可以想象最终将开发 PCB

和缺失的连接 以多种格式导出绘图文件（Postscript，PDF，HPGL 和 SVG） 物料清单生成（通过 Python 或 XSLT 脚本，允许许多灵活的格式）。 原理图编辑器以几种方式支持多原理图设计： 扁平的层次结构（原理图页面在主图中没有明确的连接）。 简单的层次结构（每张原理图只使用一次）。 复杂的层次结构（有些原理图页面被多次使用）。 层次结构原理图会在后续章节详细描述。 有相同名称的标签将被连接。 27 添加和编辑标签 使用相应按钮或快捷键创建标签后，会出现标签属性对话框。 标签 字段设置了标签的文本，它决定了标签分配给其连接线的网络。标签文本支持上划线、下标等标记 ，也支持变 量替换。 使用对话框中的 语法帮助 链接获得帮助。 有几个选项可以控制标签的外观。你可以改变文本的 字体、大小和颜色，并设置粗体和斜体以便强调。 你还可以设 置文本相对于标签 automatically reflow text within that border. 这两种文本项目都支持多行文本和基本的格式设置功能，文本框还可以将文本换行以适应文本框外框，并有额外的格 式选项。所有的文本都有可调整的字体、颜色、大小、黑体和斜体，左右对齐，以及垂直和水平方向。文本框还支持 水平居中，垂直对齐选项，以及彩色边框和填充。 NOTE 默认文本大小可以在原理图设置中设置，默认字体可以在优选项中设置。

和 13 个通用绘图层的印刷电路 板。 KiCad 中所有对象的内部测量分辨率为 1 纳米，测量值以 32 位整数存储。 这意味着可以创建最大约 4 米乘 4 米的电 路板。 KiCad 目前支持每个工程/原理图一个电路板文件。 从原理图开始 从原理图创建电路板是 KiCad 的推荐工作流程。 当您创建一个新工程时，KiCad 会生成一个与工程名称相同的空板 文件。 要在创建原理图后开始设计电路板，只需打开电路板文件。 these features, it is a good idea to ensure that the stackup thickness is correct. NOTE KiCad 目前仅支持铜层数为偶数的层叠。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)， 只需选择下一个最高的偶数，而忽略多余的层。 接下来，如果需要，可以使用电路板编辑器层部分重命名或隐藏您 义布线尺寸之一，则将使用该宽度。 NOTE 布线宽度永远不能小于在电路板设置对话框的约束部分中配置的最小布线宽度。如果添加的预定 义宽度低于此最小约束，则将使用最小约束值。 KiCad 的布线器支持活动布线过程中的布线宽度调整。 换句话说，要改变导线中间的宽度，必须结束布线，然后从 上一个布线的末端重新开始一条新的布线。 要改变活动布线的宽度，可使用快捷键 和 + ，切换在电路板 设置对话框中配置的布线宽度。

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 15.2 基本 API 参考 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 管理封装库 从 4.0 版本开始，Pcbnew 使用名为“封装库表”的文件组织封装库。封装库表包含一些单独的封装库的描述，以及每 个库的“昵称”，用于在引用封装时引用该库。 Pcbnew 支持几种库，每种都由“插件”支持： • KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） • Github - .pretty 格式的原生 此处，选择了远程库选项。 然后，向导将引导您完成添加库的步骤，这将取决于您要添加的库的类型。下面将解释每种类型的过程。 选择一组库后，下一页将验证选项： Pcbnew 9 / 163 如果某些选定的库不正确（不支持，而不是封装库⋯⋯），它们将被标记为“无效”。 最后一个选择是要填充的封装库表： • 全局表，或 • 项目特定表 2.3.6.1 添加现有本地库 您的计算机上可能已有本地库。例如： • 以前下载的

从 4.0 版本开始，Pcbnew 使用名为“封装库表”的文件组织封装库。 封装库表 包含一些单独的封装库的描述，以及每个库的“昵称”，用于在引用封装时引用 该库。 Pcbnew 支持几种库，每种都由“插件”支持： KiCad - 以 .pretty 格式存储在本地文件系统上的本机 KiCad 封装库（包含 .kicad_mod 文件的文件夹） Github - .pretty 格式的原生 在这里，选择了本地库选项。 此处，选择了远程库选项。 然后，向导将引导您完成添加库的步骤，这将取决于您要添加的库的类型。 下面将解释每种类型的过程。 选择一组库后，下一页将验证选项： 如果某些选定的库不正确（不支持，而不是封装库……），它们将被标记 为“无效”。 最后一个选择是要填充的封装库表： 全局表，或 项目特定表 添加现有本地库 您的计算机上可能已有本地库。 例如： 以前下载的 KiCad 漂亮的目录 GitHub URL 采用以下形式： https://github.com/user_name/repo_name “插件类型”必须设置为“Github”。 下表显示了具有默认选项（无 COW 支持）的封装库表条目： 昵称 库路径 插件类 型 选 项 描述 GitHub 上 https://github.com/liftoff- sr/pretty_footprints GitHub

libraries, which allow connecting KiCad to a networked component database or ERP system via a REST API. The REST endpoint can provide symbol and footprint mappings and other metadata. A search panel in Windows、苹果 macOS 和一些 Linux 发行版保持兼容和支持。 一些平台有特定的安装或升级说明。 请随时查看 https://www.kicad.org/download/ 了解您所在平台的最新发布信息和说明。 KiCad 可能会在不被官方支持的平台上编译和运行。 KiCad 开发团队不保证 KiCad 将来会在这些平台上继续运行。 有关支持的平台和硬件要求的详细信息，请参见 https://www 工作流程的某一部分的术语将在本手册的后面进 行定义。 一个 原理图 是由一页或多页（张）的电路原理图组成的集合。 每个 KiCad 原理图文件代表一个单页。 层次原理图 是由多个页面相互嵌套而成的原理图。 KiCad 支持层次原理图，但在层次结构的顶部必须有一个 根原理 图。 层次结构中的工作表（除根原理图外）可以被多次使用，例如，创建一个子电路的重复副本。 符号 是一个可以放在原理图上的电路元件。 符号可以代表

integers. This means it is possible to create boards up to approximately 4 meters by 4 meters. KiCad 目前支持每个工程/原理图一个电路板文件。 从原理图开始 Creating a board from a schematic is the recommended workflow for KiCad. When 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad 目前仅支持铜层数为偶数的压层。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)， 只需选择下一个最高的偶数，而忽略多余的层。 接下来，如果需要，可以使用电路板编辑器层部分重命名或隐藏您 层铜层之一开始，到内层之一结束。 埋孔是机械钻孔，在内部铜层开始和结束。 允许微孔 在使用布线器放置微孔之前，必须启用此设置。 微孔是典型的激光钻孔，将外层铜 层连接到相邻的内层。 KiCad 支持单独的微孔尺寸限制，因为它们通常比机械钻孔 的埋孔小。 由线段近似的圆弧/圆 在某些情况下，KiCad 必须使用一系列直线段来近似圆形，如圆弧和圆的形状。 此 设置控制此近似所允许的最大误差：

和 13 个通用绘图层的印刷电路 板。 KiCad 中所有对象的内部测量分辨率为 1 纳米，测量值以 32 位整数存储。 这意味着可以创建最大约 4 米乘 4 米的电 路板。 KiCad 目前支持每个工程/原理图一个电路板文件。 从原理图开始 从原理图创建电路板是 KiCad 的推荐工作流程。 当您创建一个新工程时，KiCad 会生成一个与工程名称相同的空板 文件。 要在创建原理图后开始设计电路板，只需打开电路板文件。 在左上角设置铜层的数量，然后根据需要输入压层的物理参数。 这些参数可以保留其默认值，但请注意，在导出电 路板的 3D 模型时，将使用电路板的厚度值，所以如果你打算使用这个功能，最好确保压层厚度是正确的。 NOTE KiCad 目前仅支持铜层数为偶数的压层。 要创建具有奇数层的设计 (例如，柔性印刷电路板或金 属芯印刷电路板)， 只需选择下一个最高的偶数，而忽略多余的层。 接下来，如果需要，可以使用电路板编辑器层部分重命名或隐藏您 Ctrl Shift E 20 在属性对话框中，任何包含数字值的字段也可以接受一个基本的数学表达式，从而得到一个数字值。 例如，一个尺 寸可以被输入为 2 * 2mm ，结果是 4mm 的值。 支持基本算术运算符以及用于定义运算顺序的圆括号。 使用封装 Adding footprints to the board Footprints are automatically added to

对象的 选择和拖动现在可以按照大多数用户从其他软件来的方式工作。 支持任意信号的总线、每个网络的自定义导线和结点颜色、替代引脚功能以及许多其他新的原理图功能。 PCB 编辑器中的新设计规则系统支持自定义规则，可用于约束具有高电压、信号完整性、射频或其他特殊需求的 复杂设计。 对 PCB 编辑器功能进行了大量改进，包括支持圆形 (圆弧) 布线、阴影区域填充、矩形基元、新标注样式、移除 未连 以及对 Linux 和 macOS 上 深色窗口主题的支持。 A full listing of new features and changes in KiCad 6.0 can be found here. 3 安装和升级 KiCad KiCad 与微软 Windows、苹果 macOS 和一些 Linux 发行版保持兼容和支持。 一些平台有特定的安装或升级说明。 请随时查看 https://www https://www.kicad.org/download/ 了解您所在平台的最新发布信息和说明。 KiCad 可能会在不被官方支持的平台上编译和运行。 KiCad 开发团队不保证 KiCad 将来会在这些平台上继续运行。 有关支持的平台和硬件要求的详细信息，请参见 https://www.kicad.org/help/system-requirements/ 。 KiCad 使用 "Major