创建项目和文档
Altium Essentials: Project Creation and Storage
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
概览
- 了解可用的项目存储选项,以及基于工作区进行管理的优势。
- 学习如何使用“创建项目”对话框选择模板并配置项目设置。
- 了解新项目如何显示在“项目”面板中,以及在什么情况下项目仅包含空结构。
在 Altium Designer 中创建的每个设计都以项目为起点。Altium Designer 项目将一组设计文档汇集在一起,这些文档的输出最终定义了您所要创建对象的一种具体实现。例如,PCB 项目中的原理图和 PCB 包含制造印制电路板所需的文件集。 相比之下,线束项目输出的文件集用于采购和组装线束,而多板项目中的逻辑原理图和物理装配文件则输出用于制造和组装完整产品的文件集,该产品包含多块相互连接的 PCB。
项目中的设计文档可以来自任何可访问的位置,无论是本机还是其他位置,项目文件会将这些文档关联为一个统一的设计。软件使用动态编译来创建和管理统一的数据模型,其中包含项目的元件及其连接关系。随后,此数据模型可用于在不同设计域之间传递设计变更,例如,通过同步来消除原理图域与 PCB 域中文档之间的差异。
项目文档可以创建并存储在您的 Altium 工作区中、版本控制系统中,或作为本地文件存储在可用的网络位置。
以下各节介绍如何创建新项目以及向现有项目添加设计文档。
使用“创建项目”对话框创建新项目
在 Altium Designer 中,可以使用 Create Project 对话框(File » New » Project)创建新项目。
-
在 Locations 列表中,选择您的工作区条目(该条目将以为工作区定义的名称显示)——您必须已连接到该工作区,才能在列表中看到此选项。该工作区将作为存储新工作区项目的目标服务器。
-
在 Project Type 列表中,选择要创建的项目类型,并根据需要从可用的适用模板中进行选择。<Empty> 条目将创建一个不含初始源文档的空项目。
了解有关 创建项目模板的更多信息。
-
输入Project Name,并可选择输入项目Description。
Create Project 对话框还包含以下选项:
-
选中 Version Control 选项(默认选中),可为项目启用所有 VCS 功能,例如历史记录和高级共享功能。取消选中时,项目将存储在工作区中,并与本地副本同步,即采用 Simple Sync 格式的“镜像”项目。
-
创建 PCB 类型的项目时,选中 Constraint Management 选项,即可使用约束管理器管理此项目的设计约束。禁用此选项时,此项目将使用设计规则系统。
-
连接到 Enterprise Server 工作区时,Repository 下拉菜单(如有)将列出通过工作区的版本控制服务管理且已共享给您使用的所有设计存储库。选择用于存储新项目及其文件的存储库——默认提供一个基于 Git 的存储库(
Versioned Storage)。如果选择 SVN 类型的存储库,还会提供额外的 Repository Folder 选项,用于指定或浏览选择存储库中的其他目标文件夹。 -
单击 Advanced 控件以指定文件夹路径。
-
使用 Folder 字段指定在工作区文件夹结构中创建项目文件夹的位置。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面中指定(默认为
Projects\<ProjectName>)。如有需要,单击
按钮,浏览并选择其他工作区文件夹。
-
使用 Local Storage 字段指定项目本地版本在硬盘上的存储位置。默认位置在 Preferences 对话框的 系统 – 默认位置 页面中定义。如有需要,单击
按钮,浏览并选择其他文件夹位置。这是项目及其提交目标 local Git 仓库的“工作”文件夹。项目最终或在提交时会被推送到工作区中的集中式设计仓库(Versioned Storage),即 remote Git 仓库。
-
使用 Folder 字段指定在工作区文件夹结构中创建项目文件夹的位置。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面中指定(默认为
-
使用 Parameters 列表区域添加或移除与项目关联并保存在工作区中的自定义名称/值参数对。使用
按钮向列表中添加新的名称-值参数对,或使用
按钮移除选中的参数对。名称和值字段最多各允许输入 255 个字符。创建工作区项目时,这些工作区项目参数会随新项目一起保存在工作区中,作为工作区端的项目级参数。
在对话框的 Project Type 列表中选择项目模板后, Parameters 列表区域将加载该模板中的参数。如有需要,您可以更改这些参数(名称和/或值)或将其移除。创建工作区项目时,如果未更改参数名称,所选模板中的参数将保存为设计端的项目级参数;否则,它将保存为工作区端的项目级参数。
按需定义项目后,单击
按钮。系统将在指定的本地文件夹和工作区文件夹中创建新项目结构。项目将在 Projects 面板中打开,该面板将显示远程设计仓库(位于工作区中)与本地(工作副本)仓库中的文件已完全同步,并以相应的
图标指示。如果创建时未选中 Version Control 选项(仅在 Altium 365 工作区中可用),镜像项目将显示在 Projects 面板中,并带有相应的
图标。
新创建的项目已提交到工作区中的 Versioned Storage 设计仓库。
另一种情况是,如果新项目not分配包含文档的模板,则只会创建项目文件(*.PrjPcb),也就是仅创建项目结构。随后,项目将在 Projects 面板中打开,该面板会将其显示为 Scheduled for addition,并以相应的
图标标识。此时,您可以向项目添加文档,也可以直接将当前的空项目结构保存到工作区。为此,单击 Projects 面板中项目条目对应的 Save to Server 控件,也可以从右键快捷菜单或主 File 菜单中执行此操作。在随后出现的保存到服务器对话框中,选择/取消选择要包含的文件,按需添加 Comment,然后单击
按钮确认保存。项目添加到服务器后,Projects 面板将显示服务器仓库与本地工作副本中的文件已完全同步,并以
图标指示。
复制项目
要在 Altium Designer 中复制工作区项目,请在 Projects 面板中右键单击该项目条目,然后从上下文菜单中选择 Make a copy 命令。使用 Create Project Copy 对话框设置 Project Name(默认情况下为原项目名称加上后缀 - Copy)、Description(不会预先填充)、Folder 路径(工作区内的路径)以及 Local Storage 路径(工作副本的路径)。
添加和移除设计文档
项目建立后,即可在活动项目中添加、编辑或移除设计文档。向项目添加新设计文档的最简单方法是,在 Projects 面板中右键单击项目名称,然后从上下文菜单选项中选择 Add New to Project。或者,从主菜单的 Project » Add New to Project 子菜单中选择所需的文档类型,将新文档添加到活动项目中。
也可以向项目添加其他与项目相关的文档,例如文本文件、PDF、电子表格等。为此,请使用 Add Existing to Project 选项(或活动文档编辑器主菜单中的 Project » Add Existing to Project 命令),并将 Choose Document to Add 文件浏览对话框中的 File Type 下拉列表设置为 All Files (*.*),以便访问所有文件类型。
要从项目结构中移除文档,请在 Projects 面板中右键单击其名称,然后选择 Remove from Project 菜单选项,或从主菜单中选择 Project » Exclude from Project 命令。系统将提示您选择:
- Delete File – 永久删除源文档文件本身。
-
Exclude from Project – 移除项目指向该文档的链接(不删除源文档文件本身)。如果该文档当前已在设计编辑器窗口中打开,它将从所属项目中移除,但仍会作为自由文档在面板中保持打开状态。但是,如果该文档当前未在设计空间中打开,移除操作实际上会将其关闭。
移除项目
对于本地项目,移除项目只需从硬盘中删除文件。在 Windows 资源管理器中打开项目文件夹,然后删除其中的内容。
对于工作区项目(以及元件和已发布数据等其他工作区内容),您可以使用灵活的移除功能,直接在 Altium Designer 的 Explorer 面板中执行移除操作。此操作采用“软删除”方式,移除过程中会提供更多选项和信息,包括指向源条目的相关链接,便于查看。在工作区中,已删除的内容会移至专用的 Trash 位置,您可以通过工作区浏览器界面的 Trash 页面恢复或彻底删除这些内容。
要软删除 Workspace 项目,请在 Explorer 面板中找到项目文件夹,右键单击其条目,然后从右键菜单中选择 Delete Folder 命令。在弹出的 Confirm Delete 对话框中确认删除。如果项目包含已发布的数据,系统将打开另一个确认对话框,提示您这些数据也将被删除。单击 Delete 继续。



