创建项目和文档

在 Altium Designer 中创建的每个设计的起点都是一个项目。Altium Designer 项目汇集了一系列设计文档，其输出最终定义了您打算创建的内容的单一实现。例如，PCB 项目中的原理图和 PCB 包括制造印刷电路板所需的文件集。相反，线束项目输出的文件集用于购买和组装线束，而多板项目中的逻辑原理图和物理组装文件输出的文件集用于制造和组装带有多个连接 PCB 的完整产品。

项目的设计文件集可以从任何可访问的来源（本地机器或其他）汇集到一起，项目文件将它们作为统一的设计联系在一起。软件使用动态编译来创建和管理项目组件及其连接的统一数据模型。然后，该数据模型可用于在设计域之间传播设计变更，例如，同步解决原理图域和 PCB 域文件之间的差异。

项目文档可以创建并存储在 Altium 工作区、版本控制系统或本地可用网络上的文件中。

以下章节将介绍如何创建新项目和向现有项目添加设计文档。

使用 "创建项目 "对话框创建新项目

可在 Altium Designer 中使用 Create Project对话框 (File » New » Project).

1. 在 Locations列表中，选择工作区的条目（该条目将以为其定义的名称显示）--您必须已连接到工作区， 才能在列表中看到该选项。这将是存储新工作区项目的目标服务器。

   简而言之，项目管理的重点是在整个设计过程中安全地存储和跟踪变更，并最终将设计结果导入到物理项目的创建中--例如用于最终产品的组装 PCB。为了满足这些需求，Altium Designer 提供了一系列项目管理方法，这些方法的复杂程度和功能不断提高，但从设计者的角度来看却简化了流程。这些方法包括基于本地文件的存储和管理、本地/远程版本控制系统（VCS）存储方法，以及以工作区功能为中心管理设计数据的高级推荐形式。

   一个连接的工作区及其内部 VCS 服务可托管和管理 Altium Designer 项目，并提供简化的 VCS 操作、固有的设计协作功能、高级设计数据共享、历史跟踪、生命周期管理等功能。与工作区集成的项目可直接从 Altium Designer 访问，如从 Projects面板，或通过基于浏览器的界面从工作区本身进行访问。

   由于工作区提供的服务具有智能性，VCS 操作等任务得以简化和自动化，用户访问控制（共享）、评论和历史记录等附加设计协作功能也可直接从 Altium Designer 中获得。最终，一个强大而安全的项目存储格式和位置将成为项目协作设计的中心点。

   当连接到具有一个或多个项目创建流程主题活动流程定义的工作区时，通过gh 对话框创建新项目的功能仅限于本地和 VCS。 Create Project对话框创建新项目的功能仅限于本地和 VCS 类型的项目。而基于工作区的项目创建则由活动流程定义控制。进一步了解基于流程的项目创建。

2. 在 Project Type列表中，选择要创建的项目类型，并根据需要从可用的适用模板中进行选择。该 条目将创建一个没有初始源文件的空壳项目。

   了解有关创建项目模板的更多信息。

3. 输入一个 Project Name以及项目 Description.

   项目名称应以 A-Z、a-z 或 0-9 开头，可以包含 A-Z、a-z 或 0-9。允许使用下划线、破折号和空格，但空格只能在名称中间使用（前导空格和尾部空格将被忽略）。不能使用以下单词： AUX, COM1-COM9, LPT1-LPT9, CON, NUL和 PRN.此外，名称中不能包含以下字符： \ . / ? % * : | " >.

对话框还包括其他选项 Create Project对话框包含更多选项：

• 选中 Version Control选项（默认值）可将所有 VCS 功能强加给项目，如历史记录和高级共享功能。如果不选中该选项，项目将存储在工作区中，并与本地副本同步，即简单同步格式的 "镜像 "项目。

  该 Version Control选项仅在连接到Altium 365 工作区时可用。当连接到企业服务器工作区时，该选项被有效选中。

• 创建 PCB 类型的项目时，选中 Constraint Management选项可使用 "约束管理器"管理此项目的设计约束。禁用该选项后，该项目将使用设计规则系统。

  该 Constraint Management选项在 Create Project对话框中默认启用该选项。 System.ConstraintManager选项在高级设置对话框中启用时，对话框中的该选项将默认启用。

• 当连接到企业服务器工作区时，下拉菜单（如果存在 Repository下拉菜单（如果存在）将列出通过 Workspace 的版本控制服务管理的所有设计资源库，这些资源库已共享给您使用。选择存储新项目及其文件的版本库，默认情况下只有一个基于 Git 的版本库 (Versioned Storage) 默认可用。如果选择的是 SVN 类型的版本库，则会有一个额外的 Repository Folder选项可用于指定或浏览该版本库中的其他目标文件夹。

  下拉菜单 Repository下拉菜单只有在从启用 SVN 资源库的版本或服务器产品升级到企业服务器时才会出现。或者，企业服务器提供了一个基于 Git 的设计资源库，用于容纳所有 Workspace 设计项目，在这种情况下，下拉菜单不会出现。 Repository下拉菜单。

  Altium On-Prem 企业服务器从 7.2 版开始不支持 SVN。为避免管理 SVN 项目时受到限制，建议将 SVN 项目迁移到企业服务器工作区的内置 Git 资源库。这可以在升级服务器之前完成，如此处所述。

  有关 Altium On-Prem Enterprise Server SVN 退役的更多信息，请参阅《Altium On-Prem Enterprise Server 7.2.1 停止使用 SVN》（SVN Discontinuation with Altium On-Prem Enterprise Server 7.2.1Knowledge Base）一文。

• 点击 Advanced控件指定文件夹路径。

  • 使用 Folder字段指定在工作区文件夹结构中创建项目文件夹的位置。新项目的默认路径在 Admin – Settings – Projects页面上指定（默认为 Projects\).如果需要，单击 按钮浏览并选择不同的工作区文件夹。

    如果在已连接的工作区中创建项目的用户没有默认项目文件夹的写入权限，系统将自动创建一 个特定于用户的结构来存储新项目。 Personal Folder结构来存储新项目。这将显示为一个基于成员电子邮件地址（对于 Altium 365 工作区）或用户名（对于企业服务器工作区）的顶级文件夹，并带有一个 My Projects子文件夹来存储用户的项目。文件夹结构/层次结构只对登录用户和管理员开放，其他用户看不到。了解更多 Managing Project Creation Permissions(Altium 365 工作区、企业服务器工作区）。

  • 使用 Local Storage字段指定项目本地版本在硬盘驱动器上的存储位置。默认位置在对话框的系统 - 默认位置页面中定义。 Preferences对话框的系统 - 默认位置页面中定义。如果需要，单击 按钮浏览并选择不同的文件夹位置。这是项目的 "工作 "文件夹及其提交的 localGit 仓库的 "工作 "文件夹。项目最终或在提交时会推送到工作区中的集中设计库 (Versioned Storage) 中的集中设计库，也就是 remoteGit 仓库。

• 使用 Parameters列表区域添加或删除与项目关联并保存在工作区中的自定义名称/值参数对。使用 按钮向列表中添加新的参数名称-值配对，或使用 按钮移除选定的配对。名称和值字段最多允许 255 个字符。创建工作区项目时，这些工作区项目参数将作为工作区项目级参数与新项目一起保存在工作 区中。

  在 Project Type对话框的 Parameters列表区域将加载该模板的参数。如果需要，可以更改这些参数（名称和/或值）或删除它们。创建工作区项目时，如果未更改参数名称，所选模板中的参数将保存为设计端项目级参数。否则，将保存为工作区项目级参数。

  工作区侧项目级参数可在工作区内编辑。相比之下，设计端参数保存在项目文件 (*.PrjPcb)，并可在 Altium Designer 中进行编辑。这两种类型的项目级参数都可以在 "参数"选项卡上的 Project Options对话框 (Project » Project Options) 中查看，并可在 Altium Designer 中用作特殊字符串。

按要求定义项目后，单击 按钮。新项目结构将在指定的本地文件夹和工作区文件夹中创建。项目将在 "项目 "面板中打开，该面板将反映远程设计资源库（工作区中）和本地（工作副本） 资源库中文件的完全同步状态，相关的 图标将显示该状态。如果创建时未选中 Version Control选项时（仅在 Altium 365 工作区中可用），镜像项目将显示在 Projects面板中显示，并带有相关的 图标。

新创建的项目将提交到 Versioned Storage设计库中。

或者，如果新项目已 not的模板，项目文件 (*.PrjPcb），因此将只创建项目结构。然后在 "项目 "面板中打开项目，显示为 Scheduled for addition，由相关的 图标表示。此时，您可以向项目添加文档，或者直接将结构保存到工作区的当前外壳状态。为此，请单击 Save to Server控件。 Projects面板中与项目条目相关的控件--也可从右键单击上下文菜单和主 File菜单。在下面的 "保存到服务器 "对话框中，选择/取消选择要包含的文件，添加可选的 Comment然后点击 按钮确认保存过程。项目添加到服务器后，面板上的 Projects 面板将反映服务器资源库中的文件与本地工作副本之间的完全同步状态，如 图标所示。

复制项目

要在 Altium Designer 中复制 Workspace 项目，请右键单击面板中的项目条目，然后选择 "复制 "对话框。 Projects面板中的项目条目上单击右键，然后从右键菜单中选择 Make a copy 命令。使用 Create Project Copy对话框确定 Project Name(默认情况下，这将是带后缀的原始项目名称。 - Copy), Description(未预先填入）、 Folder路径（在工作区内）和 Local Storage路径（到工作副本的路径）。

工作区 Folder 默认情况下，工作区将与原始项目所在的文件夹相同。单击 打开 Choose Folder对话框（资源管理器面板的缩小版），根据需要更改文件夹。默认情况下 Local Storage默认情况下，工作区将设置为使用对话框的 "系统 - 默认位置"页面上定义的位置。 Preferences对话框中定义的位置。单击 打开标准 Windows 对话框，根据需要更改该位置。

从 Altium Designer 中复制工作区项目。

添加和删除设计文档

项目建立后，可以从活动项目中添加、编辑或删除设计文档。向项目添加新设计文档的最简单方法是右键单击面板中的项目名称，然后选择 "添加 "或 "删除"。 Projects面板中的项目名称上单击右键，然后从上下文菜单选项中选择 Add New to Project选项。或者，从主菜单的 Project » Add New to Project子菜单中选择所需的文档类型，将新文档添加到活动项目中。

在项目中添加特定或其他类型的文档。

其他类型的项目相关文档也可以添加到项目中，如文本文件、PDF、电子表格等。为此，请使用 Add Existing to Project选项（或 Project » Add Existing to Project命令），并在 "添加 "选项的下拉菜单中设置 File Type下拉列表 Choose Document to Add浏览器对话框中的下拉列表设置为 All Files (*.*)这样就可以访问所有文件类型。

要从项目结构中删除文档，请右键单击其在 Projects面板上的 Remove from Project菜单选项或从主菜单中选择 Project » Exclude from Project命令。系统将提示您选择：

• Delete File- 永久删除源文档文件本身。

• Exclude from Project- 删除项目与该文档的链接（但不删除源文档文件本身）。如果该文件当前在设计编辑器窗口中打开，它将从父项目中移除，但仍作为自由文件在面板中打开。但是，如果该文档当前未在设计空间中打开，则删除将有效地关闭该文档。

  

删除项目

对于本地项目，删除项目就是从硬盘中删除文件。在 Windows 资源管理器中打开项目文件夹并删除其内容。

对于工作区项目（以及其他工作区内容，如组件和发布的数据），可使用灵活的功能直接从 Altium Designer 中的资源管理器面板删除。作为一种 "软删除 "操作，删除过程在进行时会提供更多选项和信息，包括用于审查的源项目相关链接。在工作区中，删除的内容会被移动到一个专门的 Trash 位置，在那里可以检索或从 Trash工作区浏览器界面的页面上完全删除。

要软删除工作区项目，请导航到 Explorer面板中的项目文件夹，右键单击其条目并从上下文菜单中选择 Delete Folder命令。在出现的 Confirm Delete对话框中确认删除。如果项目包含已发布的数据，则会打开另一个确认对话框，通知您这些数据也将被删除。单击 Delete继续删除。

软删除操作。在这里，一个项目正在被删除，同时删除的还有其相关的发布版本（如果从任何发布版本中创建了制造包，这些也将被删除）。