规范设计指南

1. 简介

本文件的目的是为 KiCad 开发人员提供一份关于 KiCad 中源代码的注意事项的指南。它并不是一个全面的指南,因为它并没有涵盖所有的主题。 然而,我们希望所有为 KiCad 项目贡献代码的开发者都能遵守本文档所涵盖的所有主题。

2. 库的依赖关系

KiCad 是一个跨平台项目。 因此,所有依赖库都必须为所有 支持的平台 打包。如果某个平台上没有软件包,引入任何新的依赖关系的开发者有责任在提交新的依赖关系之前确保它们被打包。 平台的特定功能将不被接受。

3. 底层对象设计

所有与用户界面设计不直接相关的 KiCad 底层对象必须不依赖于用户界面代码。 这包括所有 SCH_*LIB_*PCB_*FP_* 和 `I/O 插件对象

唯一的例外是 wxWidgets 调试宏。原因是 wxWidgets 的用户界面代码只用于调试构建。 这样做的好处是,开发人员可以意识到编码问题,而不必从命令行或调试器中运行来查看断言信息。