. 12 2.3.8.2 使用写入时复制（Copy-On-Write）共享封装 . . . . . . . . . . . . . . . . . . . . . . . 12 2.3.8.3 缓存 GitHub 请求 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 2.3.9 使用模式 您还可以使用 KiCad 插件使用相关库的本地 Git 克隆为库开发做出贡献，并向库维护者提交拉取请求。 2.3.8.3 缓存 GitHub 请求 GitHub 插件可能很慢，因为它必须先从 Internet 下载所有库才能使用它们。 Nginx 可以用作 GitHub 服务器的缓存，以加快封装的加载速度。它可以安装在本地或网络服务器上。在 “pcbnew/github/nginx.conf”的 KiCad 其他环境变量指定模型的其他基目录。当前版本的 KiCad 具有专门的 别名系统，用于处理 3D 模型名称。新文件名 管理系统（文件名解析系统）的目的是提供一种与早期版本的 KiCad 兼容的方案，同时提供更灵活的机制来指定 3D 模型文件名并提高共享项目文件的能力。 由于需要支持先前的方案，同时提供用于查找 3D 模型的灵活的新方案，因此有两种不同的方法来指定 3D 模型的基 本搜索路径。 Figure

提示 您还可以使用 KiCad 插件使用相关库的本地 Git 克隆为库开发做出贡 献，并向库维护者提交拉取请求。 缓存 GitHub 请求 GitHub 插件可能很慢，因为它必须先从 Internet 下载所有库才能使用它们。 Nginx 可以用作 GitHub 服务器的缓存，以加快封装的加载速度。 它可以安装 在本地或网络服务器上。 在“pcbnew/github/nginx.conf”的 可以使用其他环境变量指定模型的其他基目录。 当前版本的 KiCad 具有专门的 别名 系统，用于处理 3D 模型名称。 新文件名 管理系统（文件名解析系统）的目的是提供一种与早期版本的 KiCad 兼容的方 案，同时提供更灵活的机制来指定 3D 模型文件名并提高共享项目文件的能 力。 由于需要支持先前的方案，同时提供用于查找 3D 模型的灵活的新方案，因此 有两种不同的方法来指定 3D 模型的基本搜索路径。 图 13.2.

符号名称和符号库昵称限制 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 6 符号缓存库可用性 19 7 板文件格式更改 20 7.1 全局封装库表。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 原理图文件，不包含元件本身。 *.lib 原理图元件库文件，包含元件描述：图形形状，引脚，字段。 *.dcm 原理图元件库文档，包含一些元件描述：评论，关键字，数据表参考。 *_cache.lib 原理图元件库缓存文件，包含原理图工程中使用的元件的副本。 sym-lib-table 符号库列表（符号库表）：原理图编辑器中可用的符号库列表。 板编辑器文件和文件夹： *.kicad_pcb 板文件，包含除图框之外的所有信息。 果它们包含原理图中的符号）。否则，将找不到正确的符号，您的原理图中最终会出现符号链接断开。您可以 通过左键单击原理图中的符号并验证是否未从缓存库加载符号来对此进行测试。如果从缓存库加载符号，则 Eeschema 无法在系统或工程符号库中找到您的元件。如果需要缓存部件可供系统上的其他工程使用，则需要手 动将其集成到系统或工程库中。 3. 如果在重映射过程中需要符号恢复，请不要忽略它。无法恢复符号将导致符号链接断开或原理图中链接的符号

原理图文件，不包含元件本身。 *.lib 原理图元件库文件，包含元件描述：图形形状，引脚，字段。 *.dcm 原理图元件库文档，包含一些元件描述： 评论，关键字，数据表 参考。 *_cache.lib 原理图元件库缓存文件，包含原理图工程中使用的元件的副本。 sym-lib- table 符号库列表（符号库表）： 原理图编辑器中可用的符号库列表。 板编辑器文件和文件夹： *.kicad_pcb 板文件，包含除图框之外的所有信息。 原理图中的符号）。 否则， 将找不到正确的符号，您的原理图中最终会出现符号链接断开。 您可以通 过左键单击原理图中的符号并验证是否未从缓存库加载符号来对此进行测 试。 如果从缓存库加载符号，则 Eeschema 无法在系统或工程符号库中找到 您的元件。 如果需要缓存部件可供系统上的其他工程使用，则需要手动将 其集成到系统或工程库中。 3. 如果在重映射过程中需要符号恢复，请不要忽略它。 无法恢复符号将导致 符号链接断开或原理图中链接的符号错误。 4. 在重映射过程中，未在全局符号库表中找到的符号库将用于创建工程特定 的符号库表。 如果这是您的首选项，您可以手动将它们移动到全局符号库 表。 5. 要获得最准确的重映射，请通过将工程缓存文件（project-name-cache.lib） 复制到其他文件并将其添加到符号库列表的顶部来创建工程库。 您必须在 符号库表实现之前使用 KiCad 版本才能执行此操作。 注意 提供了一个工具来尝试修复重映射问题。

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 6.7 抢救缓存的符号 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 这一过程的成功取决于几个因素： • 原理图中使用的原始库仍然可用，并且在符号添加到原理图时保持不变。 • 在检测到所有恢复行动时，执行所有恢复行动以创建恢复库或使现有恢复库保持最新状态。 • 项目符号缓存库的完整性尚未损坏。 Warning 重新映射将备份在重新映射期间在项目文件夹中的 rescue-backup 文件夹中更改的所有文件。在重新映射之 前，请务必备份项目以防万一出错。 Warning 即使已禁用恢复操作以执行恢复操作以确保正确的符号可用于重新映射。请勿取消此操作，否则重映射将无 法正确重新映射原理图符号。任何损坏的符号链接都必须手动修复。 Note 如果已删除原始库并且未执行恢复，则可以将缓存库用作恢复库作为最后的手段。将缓存库复制到新文件名，并在 符号库表实现之前使用 Eeschema 版本将新库文件添加到库列表的顶部。 Eeschema 简介 37 / 151 Chapter 6 原理图创建和编辑

号库链接重新映射到相应的库表符号。 这一过程的成功取决于几个因素： 原理图中使用的原始库仍然可用，并且在符号添加到原理图时保持不变。 在检测到所有恢复行动时，执行所有恢复行动以创建恢复库或使现有恢复 库保持最新状态。 项目符号缓存库的完整性尚未损坏。 警告 重新映射将备份在重新映射期间在项目文件夹中的 rescue-backup 文件 夹中更改的所有文件。 在重新映射之前，请务必备份项目以防万一出 错。 警告 即使已 即使已禁用恢复操作以执行恢复操作以确保正确的符号可用于重新映 射。 请勿取消此操作，否则重映射将无法正确重新映射原理图符号。 任何损坏的符号链接都必须手动修复。 注意 如果已删除原始库并且未执行恢复，则可以将缓存库用作恢复库作为 最后的手段。 将缓存库复制到新文件名，并在符号库表实现之前使用 Eeschema版本将新库文件添加到库列表的顶部。 第 6 章 原理图创建和编辑 6.1. 简介 原理图可以用单张纸表示，但是，如果足够大，则需要多张纸。 Y）会自动更新。 6.7. 抢救缓存的符号 默认情况下，Eeschema 根据设置的路径和从项目库加载符号 库顺序。这在加 载非常旧的项目时可能会导致问题：如果 库已更改或已被删除，或者库自使 用后已不存在。 在项目中，项目中的项目将自动替换为新版本。 新版本可能 没有正确对齐，或者可能方向不同，导致出现。 破损的原理图。 保存项目时，将包含具有当前库符号内容的缓存库以及原理图。 这允许在没 有完整库的情况下分发项目。

原理图库文件。可以读取，但不能写入。 *.dcm 旧版 (KiCad 5.x 和更早版本) 原理图库文档。可以读取，但不能写入。 *_cache.lib 旧版 (KiCad 5.x 和更早版本) 原理图元件库缓存文件。 正确加载旧版原理图 (.sch) 文件所 需。 sym-lib-table 符号库列表 (符号库表)： 原理图编辑器中可用的符号库列表。 板编辑器文件和文件夹： 3 *.kicad_pcb x 和更早版本) 封装库文件。 可由封装或线路板编辑器读取，但不能写入。 fp-lib-table 封装库列表（ 封装库表 ）： 线路板编辑器中可用的封装库的列表。 fp-info-cache 缓存以加速封装库的加载。 ＊常用文件：* *.kicad_wks 图框页面布局 (图形边框和标题栏) 描述文件 *.net 原理图创建的网表文件，由电路板编辑器读取。 此文件与 .cmp 文件相关联，适用于偏爱 在编辑原理图和电路板文件时，KiCad 会定期自动保存您的工作。设置为 0 将禁用此功能。 文件历史大小： 配置最近打开的文件列表中的条目数 3D 缓存文件时长： KiCad 创建 3D 模型缓存，以提高 3D 观看速度。 您可以配置在删除旧文件之前保留此缓存的时 间。 自动备份工程：开启后，KiCad 工程将根据以下设置自动存档为 ZIP 文件。 存档将保存在工程文件夹的子文件夹 中。 在工程中保存文件时会创建备份。

及更早版本）原理图库文件。可以读取但不能写入。 *.dcm 遗留 (KiCad 5.x 及更早版本) 原理图库文件。可以读取但不能写入。 *-cache.lib 遗留 (KiCad 5.x 及更早版本) 原理图元件库缓存文件。为正确加载遗留原理图(.sch)文件 所必需。 sym-lib-table 原理图编辑器中可用的符号库列表。 3 PCB 编辑器的文件和文件夹 *.kicad_pcb 包含除页面布局外的所有信息的板块文件。 (KiCad 4.x 及更早版本) 封装库文件。可以被封装或 PCB 编辑器读取，但不能写入。 fp-lib-table 封装库表：在 PCB 编辑器中可用的封装库列表。 fp-info-cache 缓存，以加快加载封装库的速度。不需要与工程一起发布或置于版本控制之下。 通用文件 *.kicad_prl Local settings for the current project; helps KiCad 在编辑原理图和电路板文件时，KiCad 会定期自动保存您的工作。设置为 0 将禁用此功能。 文件历史大小： 配置最近打开的文件列表中的条目数 3D 缓存文件时长： KiCad 创建 3D 模型缓存，以提高 3D 观看速度。 您可以配置在删除旧文件之前保留此缓存的时 间。 自动备份工程：开启后，KiCad 工程将根据以下设置自动存档为 ZIP 文件。 存档将保存在工程文件夹的子文件夹 中。 在工程中保存文件时会创建备份。

及更早版本）原理图库文件。可以读取但不能写入。 *.dcm 遗留 (KiCad 5.x 及更早版本) 原理图库文件。可以读取但不能写入。 *-cache.lib 遗留 (KiCad 5.x 及更早版本) 原理图元件库缓存文件。为正确加载遗留原理图(.sch)文件 所必需。 sym-lib-table 原理图编辑器中可用的符号库列表。 3 PCB 编辑器的文件和文件夹 *.kicad_pcb 包含除页面布局外的所有信息的板块文件。 (KiCad 4.x 及更早版本) 封装库文件。可以被封装或 PCB 编辑器读取，但不能写入。 fp-lib-table 封装库表：在 PCB 编辑器中可用的封装库列表。 fp-info-cache 缓存，以加快加载封装库的速度。不需要与工程一起发布或置于版本控制之下。 通用文件 *.kicad_prl Local settings for the current project; helps KiCad 在编辑原理图和电路板文件时，KiCad 会定期自动保存您的工作。设置为 0 将禁用此功能。 文件历史大小： 配置最近打开的文件列表中的条目数 3D 缓存文件时长： KiCad 创建 3D 模型缓存，以提高 3D 观看速度。 您可以配置在删除旧文件之前保留此缓存的时 间。 自动备份工程：开启后，KiCad 工程将根据以下设置自动存档为 ZIP 文件。 存档将保存在工程文件夹的子文件夹 中。 在工程中保存文件时会创建备份。

本教程将引导用户开发名为 “PLUGIN_3D_DEMO2” 的 3D 插件。 本教程的目 的是演示 KiCad 预览器可以渲染的非常基本的场景图的构造。 该插件声称处 理 ‘txt’ 类型的文件。 虽然文件必须存在，以便缓存管理器调用插件，但此插 件不处理文件内容; 相反，插件只是创建一个包含一对四面体的场景图。 本教 程假定第一个教程已完成，并且已创建 CMakeLists.txt 和 FindKICAD.cmake 由于这个插件会为 KiCad 创建一个场 景图，我们需要链接到 KiCad 的场景图库 ‘kicad_3dsg’。 KiCad 的场景图库提 供了一组可用于构建场景图对象的类; 场景图对象是 3D 缓存管理器使用的中 间数据可视化格式。 所有支持模型可视化的插件都必须通过此库将模型数据 转换为场景图。 第一步是扩展 ‘CMakeLists.txt’ 来构建这个教程项目： cd ${DEMO_ROOT} SGPOINT& p1, const SGPOINT& p2, const SGPOINT& p3 ); /** * 函数 WriteCache * 将 SGNODE 树写入二进制缓存文件。 * * @param aFileName 是要写入的文件的名称。 * @param overwrite 必须设置为 true 才能覆盖现 有文件。 *