创建项目和文档

Altium Training

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 中创建项目、选择项目类型和模板,以及如何配置存储位置,包括已连接的工作区、外部版本控制存储库或本地文件夹。本文还介绍版本控制、约束管理、文件夹路径和项目参数等设置选项。继续阅读,为您的下一个设计奠定坚实基础。

- 了解可用的项目存储选项,以及基于工作区进行管理的优势。
- 学习如何使用“创建项目”对话框选择模板并配置项目设置。
- 了解新项目如何显示在“项目”面板中,以及在什么情况下项目仅包含空结构。
使用 AI 深入了解:

在 Altium Designer 中创建的每个设计都以项目为起点。Altium Designer 项目将一组设计文档汇集在一起,这些文档的输出最终定义了您所要创建对象的一种具体实现。例如,PCB 项目中的原理图和 PCB 包含制造印制电路板所需的文件集。 相比之下,线束项目输出的文件集用于采购和组装线束,而多板项目中的逻辑原理图和物理装配文件则输出用于制造和组装完整产品的文件集,该产品包含多块相互连接的 PCB。

项目中的设计文档可以来自任何可访问的位置,无论是本机还是其他位置,项目文件会将这些文档关联为一个统一的设计。软件使用动态编译来创建和管理统一的数据模型,其中包含项目的元件及其连接关系。随后,此数据模型可用于在不同设计域之间传递设计变更,例如,通过同步来消除原理图域与 PCB 域中文档之间的差异。

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

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

使用“创建项目”对话框创建新项目

在 Altium Designer 中,可以使用 Create Project 对话框(File » New » Project)创建新项目。

Create Project 对话框支持在已连接的工作区中创建新项目、将新项目添加到现有的外部版本控制存储库(工作副本位于您选择的位置),以及在本地硬盘上的指定文件夹中创建新项目。

  1. 在 Locations 列表中,选择您的工作区条目(该条目将以为工作区定义的名称显示)——您必须已连接到该工作区,才能在列表中看到此选项。该工作区将作为存储新工作区项目的目标服务器。

    简而言之,项目管理的重点是在整个设计过程中安全地存储数据并跟踪变更,最终将设计成果转化为实物,例如用于最终产品的已组装 PCB。为满足这些需求,Altium Designer 提供了一系列项目管理方式,其完善程度和功能逐步提升,同时从设计人员的角度简化了操作流程。这些方式涵盖基于本地文件的存储和管理、本地/远程版本控制系统(VCS)存储方式,以及以工作区功能为核心来管理设计数据的高级推荐方式。

    已连接的工作区及其内部 VCS 服务可托管和管理 Altium Designer 项目,还提供简化的 VCS 操作、内置设计协作功能、高级设计数据共享、历史记录跟踪、生命周期管理等众多功能。与工作区集成的项目可以直接从 Altium Designer 中访问,例如通过 Projects 面板访问,也可以通过工作区自身基于浏览器的界面访问。

    借助工作区服务内置的智能功能,VCS 操作等任务得以简化并自动执行,同时,用户访问控制(共享)、评论和历史记录等其他设计协作功能也可直接在 Altium Designer 中使用。最终,项目得以采用稳健、安全的存储格式和存储位置,并以此作为项目协同设计的中心。

    当连接的工作区针对“项目创建”流程主题具有一个或多个有效的流程定义时,通过 Create Project 对话框创建新项目的功能将仅限于本地和 VCS 类型的项目。此时,基于工作区的项目创建将由有效的流程定义控制。 了解有关 基于流程的项目创建的更多信息。

  2. 在 Project Type 列表中,选择要创建的项目类型,并根据需要从可用的适用模板中进行选择。<Empty> 条目将创建一个不含初始源文档的空项目。

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

  3. 输入Project Name,并可选择输入项目Description。

    项目名称应以 A-Z、a-z 或 0-9 开头,也可以包含这些字符。允许使用下划线、连字符和空格,但空格只能用于名称中间(开头和结尾的空格将被忽略)。不能使用以下词语:AUX、COM1-COM9、LPT1-LPT9、CON、NUL 和 PRN。此外,名称不能包含以下字符:\ . / ? % * : | " < >。

Create Project 对话框还包含以下选项:

  • 选中 Version Control 选项(默认选中),可为项目启用所有 VCS 功能,例如历史记录和高级共享功能。取消选中时,项目将存储在工作区中,并与本地副本同步,即采用 Simple Sync 格式的“镜像”项目。

    Version Control 选项仅在连接到 Altium 365 工作区时可用。连接到 Enterprise Server 工作区时,此选项实际上始终处于选中状态。
  • 创建 PCB 类型的项目时,选中 Constraint Management 选项,即可使用约束管理器管理此项目的设计约束。禁用此选项时,此项目将使用设计规则系统。

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

  • 连接到 Enterprise Server 工作区时,Repository 下拉菜单(如有)将列出通过工作区的版本控制服务管理且已共享给您使用的所有设计存储库。选择用于存储新项目及其文件的存储库——默认提供一个基于 Git 的存储库(Versioned Storage)。如果选择 SVN 类型的存储库,还会提供额外的 Repository Folder 选项,用于指定或浏览选择存储库中的其他目标文件夹。

    只有当您的 Enterprise Server 是从启用了 SVN 存储库的版本或服务器产品升级而来时,才会显示 Repository 下拉菜单。 否则,Enterprise Server 会提供一个基于 Git 的设计存储库,用于存放所有工作区设计项目,此时不会显示 Repository 下拉菜单。

    从 7.2 版本开始,Altium On-Prem Enterprise Server 不再支持 SVN。为避免管理 SVN 项目时受到限制,建议将 SVN 项目迁移到 Enterprise Server 工作区的内置 Git 仓库。您可以在升级服务器之前,按照此处所述的方法完成迁移。

    有关 Altium On-Prem Enterprise Server 停止支持 SVN 的更多信息,请参阅知识库文章 Altium On-Prem Enterprise Server 7.2.1 停止支持 SVN。

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

    • 使用 Folder 字段指定在工作区文件夹结构中创建项目文件夹的位置。新项目的默认路径在工作区浏览器界面的 Admin – Settings – Projects 页面中指定(默认为 Projects\<ProjectName>)。如有需要,单击 按钮,浏览并选择其他工作区文件夹。

      如果在已连接的 工作区 中创建项目的用户没有默认项目文件夹的写入权限,系统将自动创建该用户专属的 Personal Folder 结构,用于存储新项目。此结构显示为以成员电子邮件地址(对于 Altium 365 工作区)或用户名(对于 Enterprise Server 工作区)命名的顶层文件夹,其中包含一个用于存储该用户项目的 My Projects 子文件夹。此文件夹结构/层次结构仅对已登录用户和管理员可见,其他用户无法查看。详细了解 Managing Project Creation Permissions (Altium 365 工作区、Enterprise Server 工作区)。

    • 使用 Local Storage 字段指定项目本地版本在硬盘上的存储位置。默认位置在 Preferences 对话框的 系统 – 默认位置 页面中定义。如有需要,单击 按钮,浏览并选择其他文件夹位置。这是项目及其提交目标 local Git 仓库的“工作”文件夹。项目最终或在提交时会被推送到工作区中的集中式设计仓库(Versioned Storage),即 remote Git 仓库。

     

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

    在对话框的 Project Type 列表中选择项目模板后, Parameters 列表区域将加载该模板中的参数。如有需要,您可以更改这些参数(名称和/或值)或将其移除。创建工作区项目时,如果未更改参数名称,所选模板中的参数将保存为设计端的项目级参数;否则,它将保存为工作区端的项目级参数。

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

按需定义项目后,单击 按钮。系统将在指定的本地文件夹和工作区文件夹中创建新项目结构。项目将在 Projects 面板中打开,该面板将显示远程设计仓库(位于工作区中)与本地(工作副本)仓库中的文件已完全同步,并以相应的 图标指示。如果创建时未选中 Version Control 选项(仅在 Altium 365 工作区中可用),镜像项目将显示在 Projects 面板中,并带有相应的 图标。

新创建的项目已提交到工作区中的 Versioned Storage 设计仓库。新创建的项目已提交到工作区中的 Versioned Storage 设计仓库。

另一种情况是,如果新项目not分配包含文档的模板,则只会创建项目文件(*.PrjPcb),也就是仅创建项目结构。随后,项目将在 Projects 面板中打开,该面板会将其显示为 Scheduled for addition,并以相应的 图标标识。此时,您可以向项目添加文档,也可以直接将当前的空项目结构保存到工作区。为此,单击 Projects 面板中项目条目对应的 Save to Server 控件,也可以从右键快捷菜单或主 File 菜单中执行此操作。在随后出现的保存到服务器对话框中,选择/取消选择要包含的文件,按需添加 Comment,然后单击 按钮确认保存。项目添加到服务器后,Projects 面板将显示服务器仓库与本地工作副本中的文件已完全同步,并以 图标指示。

  • 项目将显示在 Projects 面板中目标工作区的条目下,该条目以该工作区的名称显示。

  • 此外,工作区浏览器界面的 Projects 页面上也会显示该项目的条目。

  • 项目最初将与创建它的设计人员(所有者)以及工作区的所有管理员共享,并授予他们读/写访问权限。

    有关配置项目访问权限的更多信息,请参阅共享设计。

  • 您也可以通过工作区浏览器界面的设计页面直接创建新项目(选择 Projects),随后在 Altium Designer 中打开该项目进行编辑并添加内容。

  • 创建项目文件(*.PrjPcb)的同时,还会创建项目结构文件(*.PrjPCBStructure)。无论项目采用扁平结构还是层次结构,此文件都包含有关项目层次结构的信息。对项目进行动态编译时(打开项目文档时),系统会重新生成此文件。

  • 您也可以右键单击 Projects 面板中的工作区条目,然后从菜单中选择 Create Project 命令,打开 Create Project 对话框。

复制项目

要在 Altium Designer 中复制工作区项目,请在 Projects 面板中右键单击该项目条目,然后从上下文菜单中选择 Make a copy 命令。使用 Create Project Copy 对话框设置 Project Name(默认情况下为原项目名称加上后缀 - Copy)、Description(不会预先填充)、Folder 路径(工作区内的路径)以及 Local Storage 路径(工作副本的路径)。

复制项目不需要任何特殊权限。复制的项目与原工作区项目完全相同,具有相同的编辑属性且不受任何限制,也就是说,您无法创建“只读”项目。另请注意,复制的项目将存储在与原项目相同的设计存储库中,无法在复制过程中更改存储库。

工作区 Folder 默认与原项目所在的文件夹相同。单击 打开 Choose Folder 对话框(Explorer 面板的精简版),以根据需要更改文件夹。Local Storage 默认使用 Preferences 对话框的 系统 - 默认位置 页面中定义的位置。单击 打开标准 Windows 对话框,以根据需要更改此位置。

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

每次复制项目时,复制项目的历史记录时间轴中都会添加一个 Project Copied 事件卡片。此外,项目副本的 Project Created 卡片还会包含指向原项目的链接。了解有关项目历史记录的更多信息。
您可以通过 打开项目对话框复制现有的工作区项目。在已连接的工作区中选择项目,然后单击右侧 Information 窗格底部的 Open Project As Copy 控件。此外,通过 Altium Designer 的 Explorer 面板浏览项目时,如果面板配置为默认的 Project View 而不是 Classic View,则可以单击面板右上角的 Copy 按钮来复制项目。
您只能复制从当前连接的 Altium 工作区打开的工作区项目。如果 Altium Designer 当前未连接到该项目的工作区,或者该项目不是工作区项目,则右键菜单中的 Make a copy 命令将不可用。

添加和移除设计文档

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

  • 如果所选文档类型可在 Preferences 对话框的 数据管理 - 模板 页面中指定默认设置,则会使用该默认设置作为模板创建所选类型的文档。
  • 文档最初处于未保存状态。

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

也可以向项目添加其他与项目相关的文档,例如文本文件、PDF、电子表格等。为此,请使用 Add Existing to Project 选项(或活动文档编辑器主菜单中的 Project » Add Existing to Project 命令),并将 Choose Document to Add 文件浏览对话框中的 File Type 下拉列表设置为 All Files (*.*),以便访问所有文件类型。

设计项目并非只能包含由 Altium Designer 创建的文件,几乎任何文档都可以包含在项目中。从 Altium Designer 内访问文档时,系统会尝试根据文件扩展名和 Windows 注册表中的设置,确定相应的创作或查看工具。如果找到匹配的工具,Altium Designer 随后便会在其自身的编辑环境中或以独立应用程序的形式启动关联的编辑器。这意味着,您可以在设计项目中包含各种测试文档、说明文档、背景资料和规范文档,并且可以放心,无论设计项目移至何处,所有配套文档都会随之一起移动。
向 Altium 365 工作区项目添加现有文档时,请注意,大于 256 MB 的 zip、7z 和 rar 文件受到限制。包含此类文件的项目无法保存到工作区,系统会提示 Git 错误。请参阅知识库文章如何在出现状态码为 471 的 Git 错误后修复项目数据,了解如何解决此问题。

要从项目结构中移除文档,请在 Projects 面板中右键单击其名称,然后选择 Remove from Project 菜单选项,或从主菜单中选择 Project » Exclude from Project 命令。系统将提示您选择:

  • Delete File – 永久删除源文档文件本身。
  • Exclude from Project – 移除项目指向该文档的链接(不删除源文档文件本身)。如果该文档当前已在设计编辑器窗口中打开,它将从所属项目中移除,但仍会作为自由文档在面板中保持打开状态。但是,如果该文档当前未在设计空间中打开,移除操作实际上会将其关闭。

您也可以右键单击所需类别的条目,然后从上下文菜单中选择 Remove All 命令,将当前选中类别(子文件夹)中的所有文档从其所属项目中移除。

移除项目

对于本地项目,移除项目只需从硬盘中删除文件。在 Windows 资源管理器中打开项目文件夹,然后删除其中的内容。

要在项目存储位置快速打开 Windows 资源管理器窗口,请右键单击 Projects 面板中的项目条目,然后选择 Explore 命令。

对于工作区项目(以及元件和已发布数据等其他工作区内容),您可以使用灵活的移除功能,直接在 Altium Designer 的 Explorer 面板中执行移除操作。此操作采用“软删除”方式,移除过程中会提供更多选项和信息,包括指向源条目的相关链接,便于查看。在工作区中,已删除的内容会移至专用的 Trash 位置,您可以通过工作区浏览器界面的 Trash 页面恢复或彻底删除这些内容。

对于项目,只有所有者或管理员才能从 Trash 中将其永久删除或恢复。

要软删除 Workspace 项目,请在 Explorer 面板中找到项目文件夹,右键单击其条目,然后从右键菜单中选择 Delete Folder 命令。在弹出的 Confirm Delete 对话框中确认删除。如果项目包含已发布的数据,系统将打开另一个确认对话框,提示您这些数据也将被删除。单击 Delete 继续。

要快速打开 Explorer 面板并选中项目文件夹,请右键单击 Projects 面板中的项目条目,然后选择 Show in Explorer 命令。

软删除操作示例。此处正在删除一个项目及其相关的发布版本(如果曾基于任何发布版本创建制造数据包,这些数据包也将被删除)。
软删除操作示例。此处正在删除一个项目及其相关的发布版本(如果曾基于任何发布版本创建制造数据包,这些数据包也将被删除)。

AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。
Contents
功能可用性

您可使用的功能取决于您所采用的 Altium 解决方案——Altium Develop、Altium Agile Teams、Altium Agile Enterprise,或 Altium Designer(在有效订阅期内)。

如果您在实际软件中未看到文档中介绍的某项功能, 请联系 Altium Sales 了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档,请前往其他安装程序页面的旧版文档部分。

Contents