2、FreeCAD源代码组织

源代码与文档

        源代码文件夹中包含由Python脚本生成的文件和文件夹列表，以及FreeCAD Mod文件夹中的模块列表。此外，FreeCAD的文档包括由Doxygen从C++和Python源代码中的文档字符串自动生成的文档，这些文档提供了关于源代码的详细信息和说明。

        除了Doxygen生成的文档外，FreeCAD还有一个维基，提供了关于软件设计、特定模块等信息的额外文档。这个维基包含三个用户中心：用户中心、高级用户中心和开发者中心，分别针对不同层次的用户和开发者提供有用的资源和指导。

         FreeCAD项目有一个专门的Wiki Doxygen页面：Doxygen - FreeCAD Documentation.

        生成的doxygen文档（静态HTML内容）可以在作者的个人网站上找到：Doxygen生成的0.19dev版本的源代码在线文档

维基上有三个用户中心：

• 用户中心：包含对FreeCAD用户有用的文档，如所有工作台的列表、安装和使用FreeCAD应用程序的详细说明、教程等。
• 高级用户中心：汇集了为高级用户和编写Python脚本感兴趣的人提供的文档。这里还可以找到宏的存储库、安装和使用它们的说明，以及更多关于根据特定需求定制FreeCAD的信息。
• 开发者中心：包含面向开发者的材料，如如何自己编译FreeCAD、FreeCAD源代码的结构以及如何在其中导航，以及如何开发新的工作台或将FreeCAD嵌入到您的应用程序中。开发者中心是模块开发者必读的资料。

        FreeCAD手册是另一种更线性的方式来呈现这个维基中包含的信息。它像一本书一样被制作出来，将温和地引导您访问上述中心中的许多页面。

持续集成与测试

        FreeCAD采用多种持续集成（CI）工具，如Travis CI、CircleCI和AppVoyer等，以确保代码的质量和稳定性。这些工具可以自动化构建和测试过程，提高软件开发的效率。

打包与部署

        FreeCAD的二进制发行版可以在其维基页面上找到下载链接。针对不同操作系统，如Linux、Windows和MacOS X，FreeCAD提供了相应的安装包或安装程序。此外，还提供了其他跨平台包管理器如Conda的支持。

学习路径

        对于想要深入了解FreeCAD的开发者或用户，官方提供了一个详细的学习路径。这包括熟悉FreeCAD的GUI操作、学习Python脚本编写、了解关键类以及开发/扩展纯Python模块或混合C++和Python模块等步骤。

        总的来说，FreeCAD的源代码组织结构清晰，文档丰富，构建系统和持续集成工具完善，为开发者和用户提供了良好的支持和指导。

学习路径

熟悉FreeCAD GUI操作作为用户，请参阅FreeCAD维基用户中心、YouTube上的教程和用户手册。

熟悉Python脚本编写，从宏录制中学习。FreeCAD的惊人特性之一是所有GUI操作都在Python控制台中记录。

熟悉FreeCAD源代码中的关键类：Base、App、Gui、Part。虽然使用C++、Python GIL、Coin3D、OCC进行编码具有挑战性，但模块开发者不需要了解OCC。

开发/扩展纯Python模块，避免复杂的Python包装任务。

开发/扩展混合C++和Python模块。

编写3D渲染代码，即ViewProvider派生类。

​