管理项目文档

Applies to Altium Designer versions: 23 and 24

父页面: 熟悉Altium设计环境

项目面板

项目面板显示当前打开的所有项目及其组成文档和结构。面板的右键上下文菜单提供了用于处理设计文档所需的大部分命令。

项目面板
项目面板

请注意,项目面板中文档的展示并不反映它们在硬盘驱动器或其他地方的存储方式。面板的内容可以被视为项目的逻辑表示,而文档文件存储的物理位置和组织(及其类型)则由您决定 - 文档可能存储在本地机器或局域网的文件夹中,当然,也可能托管在由基本的Git/SVN VCS系统或完全管理的系统如Workspace提供的版本控制仓库中。

可以使用首选项对话框中的系统 - 项目面板页面上的选项来配置项目面板的行为。这些选项也可以通过面板顶部的控件访问。

连接到Workspace时,Workspace图标( / )会显示在此Workspace的最上层条目旁边。打开Workspace项目时,其条目会显示一个指示性图标,例如对于PCB项目显示为 。当项目的本地工作副本被打开但未连接到项目所在的Workspace时,会出现灰色的Workspace图标( / ),项目图标也会改变(例如,对于PCB项目显示为 )。

工作区项目也可以与您共享,而无需邀请您加入该项目所在工作区的团队。通过共享访问打开的项目旁边会显示一个与我共享的标签和图标。

如果一个项目是与您共享的,而您只能查看它,那么在面板中的项目条目旁边会显示仅查看的标签,以此表示。

一个仅供您查看的共享项目的指示。
一个仅供您查看的共享项目的指示。

本地项目会列在项目组的条目下( *.DsnWrk)- 不管是默认的一个(Project Group 1.DsnWrk),还是您创建或打开的一个。

要访问与您当前连接的工作区相关的上下文菜单,请右键点击您的工作区名称,或点击其最右侧的控件。这些命令包括:

  • 打开项目 – 打开打开项目对话框
  • 创建项目 – 打开创建项目对话框
  • 在资源管理器中显示 – 打开资源管理器面板
  • 在网页浏览器中显示 – 在您的默认浏览器中打开工作区浏览器界面的项目页面。
  • 登出 – 将您从工作区登出。
  • 登录 – 将您登录到工作区。只要您在项目面板中打开了至少一个工作区项(例如,项目),并且您当前与该项所在的工作区断开连接,就可以使用此命令。

您必须连接到一个工作区才能访问这些命令。当从工作区登出时,右键点击您想要连接的工作区,然后点击登录命令。

  • 要打开项目面板中列出的工作区项目的Web 查看器,请右键点击其条目并选择在网页浏览器中显示命令,或从主菜单选择项目 » 在网页浏览器中显示命令。要在资源管理器面板中显示项目,请选择在资源管理器中显示命令,或从主菜单选择项目 » 在资源管理器中显示命令。
  • 在活动的 Altium 365 工作区项目的Web 查看器中,可以使用主菜单中的项目 » 组装助手命令访问组装视图。

项目文档树

当您打开现有项目或创建新项目时,其条目将出现在项目面板中。项目的任何现有文档(以及任何新添加的文档)将根据其用途和/或类型出现在子文件夹下。例如,以下常见文件夹和内容文档类型可以出现在项目下:

  • 源文件 – 核心设计文件,如原理图、PCB等。
  • 设置 – 提供项目中使用的各种文件,包括输出作业文件、线束定义文件和注释文档等其他相关文件。
  • – 本地源库文件。文件根据库类型进一步细分(例如,原理图库、PCB库等)。
  • 文档 – 已添加到项目中的额外文档,Altium Designer已知的类型(例如,文本、PDF等)。
  • 其他文档 – 已添加到项目中的额外文档,Altium Designer不认识的类型。如果Windows认识所有者应用程序,这些文档可以由Altium Designer打开(例如,Word文档、Excel电子表格等)。
  • 生成的 – 作为输出生成的文档。文档根据类型进一步细分(例如,BOM文档、文本文档等)。随着项目输出的生成,主树中的相应子文件夹将被创建并填充。
  • 组件 – 此文件夹列出了每个组件以及每个组中的组件数量。如果此文件夹未显示,请验证项目(项目 » 验证)。默认情况下,组件按设计器中的第一个字母分组 - 右键单击组件(或组件分组文件夹)的条目,并从上下文菜单中选择组件分组命令,以快速访问项目面板的组件分组控件,并根据需要更改分组样式或禁用分组。请参阅在项目结构中搜索组件和网络部分的在原理图中创建电路连通性页面了解更多信息。
  • 网络 – 此文件夹列出了项目中使用的每个网络。如果此文件夹未显示,请验证项目(项目 » 验证)。请参阅在项目结构中搜索组件和网络部分的在原理图中创建电路连通性页面了解更多信息。
存储在项目文件夹或项目文件夹的子文件夹中的文档在项目文件中使用相对引用关联。存储在不同文件夹路径中的文档在项目文件中使用绝对引用关联。这些文档在底部角落有一个小箭头,表示它们与项目链接,如上图中的 文件所示。

在文档树中工作的注意事项:

  • 与项目无关的文档将显示为自由文档,并将出现在相应的子文件夹下。通过右键单击一个自由文档并从上下文菜单中选择添加到项目<ActiveProjectName>命令,您可以将当前打开的自由文档添加到活动项目中。或者,您也可以将其拖放到项目面板中所需的项目名称上。
  • 除了允许同时打开多个文档进行编辑,环境还支持同时打开多个项目。这些项目可能是相关的,也可能是无关的。
  • 项目面板中的文档会自动按逻辑分组或“文件夹”排列,例如源文档(原理图、PCB等)、设置文档(线束、输出作业等)以及在分层设计中的顶层原理图文档。每个文件夹组内的文档默认按添加顺序显示,但可以拖放到组内的新顺序位置。
  • 在新的分层设计中,文档之间的父子关系将在面板中显示。请注意,无法通过拖放原理图文档来定义连通性关系,因为跨页连接和设计层次实际上是由图纸符号和端口定义决定的。
  • 右键单击项目文档子文件夹(无论是展开还是关闭的),可以访问额外的文档管理命令,例如打开、关闭或保存聚焦项目文档子文件夹内的所有文档。
  • 可以通过点击和拖动在面板中的项目之间传输文档。文档不必拖放到正确的子文件夹中;它将自动正确放置在项目结构中。
  • 键盘快捷键上箭头HomeEnd下箭头可用于分别显示面板中的前一个、第一个、最后一个和下一个条目。使用右箭头左箭头键分别展开和折叠顶级条目或其子文件夹。
  • 要从项目面板中选定的组件或网络条目跨探到父PCB设计项目的原理图或PCB文档上的该实体,请右键单击条目并从上下文菜单中选择跨探到原理图跨探到PCB命令。
  • 要在存储项目文档的位置打开Windows资源管理器的实例,请在项目面板中右键单击其条目并选择浏览命令。对于项目面板中聚焦的文档,可以通过点击面板顶部的控件来完成。

项目选项

现有或新创建的项目都与一系列特定于该项目的选项设置相关联。这些设置存储在项目文件中(例如*.PrjPcb),并且会根据项目类型而有所不同。

选项设置在项目选项对话框中配置,可以通过主菜单上的项目 » 项目选项或在项目面板中右击项目名称然后从上下文菜单选择项目选项来访问。对于在项目面板中聚焦的项目,可以通过点击面板顶部的控件来访问对话框。

其他在不同对话框中定义然后存储在项目文件中的项目设置包括:

  • 原理图标注设置。
  • 输出设置,如报告、打印、Gerber等。注意,这些是通过原理图或PCB编辑器菜单访问的输出设置,而不是在OutJob文档中定义的输出设置。

指示文档状态

在Altium Designer中处理项目文档时,项目面板通过与每个设计文档和主项目文件相关联的状态图标提供了一个修改或保存的文档文件的视觉总结。这提供了一个快速的视觉总结,显示哪些文档被修改、保存、它们是工作区的还是本地的,以及它们的版本控制状态。下面列出了文档图标及其含义。

打开/修改状态图标

[空白] 文档已关闭。
打开 - 文档作为标签页在设计编辑器窗口中打开。

打开/已修改 - 文档已打开并且已被修改(尚未保存)。

已修改的文档在项目面板中的条目旁边会有一个星号标记。在其打开的文档标签页(或如果文档被分组,则在关联的弹出菜单上)中,已修改的文档名称旁也会有一个星号。
文档文件已打开并被此实例的Altium Designer锁定。
文档文件已打开并被另一个实例的Altium Designer锁定。
文档正在被另一用户编辑。此状态条件由协作者可视化与冲突预防功能启用,该功能不适用于Altium Designer标准订阅
正在被另一用户编辑的文档当前在编辑器中打开。此状态条件由协作者可视化与冲突预防功能启用,该功能不适用于Altium Designer标准订阅
文档丢失(了解更多关于丢失文档的信息)。
请注意,当多个用户正在编辑(或已编辑)共享文档时,悬停文本也会报告。
尚未本地保存的已修改文档或项目,会在项目面板中的条目旁边有一个星号区分。在主编辑器窗口的标签中,已修改的文档也会有一个星号表示。当启用文件锁定(参见数据管理 - 文件锁定)时,面板中与文档相关的图标会指示文件何时被打开、修改、打开并被此实例的Altium Designer锁定,或者被另一个实例的Altium软件打开并锁定。不管文件锁定与否,已修改的文档都会通过与其文件名相关联的星号来指示。

版本控制状态图标

版本控制系统本质上监控并比较工作文件夹中的文件与设计仓库中的对应文件。Altium Designer 通过其VCS接口向版本控制系统请求和交换信息,并根据比较文件状态条件做出相应的响应。在实践中,这通过项目文件图标、一系列VCS警告,以及可用文件管理命令的适当变化来体现。

图标及其含义如下:

[空白] 不适用 该文件未在版本控制系统(VCS)仓库中进行版本控制,
无修改 本地文件副本与仓库中的文件相匹配且是最新的。
计划添加 文件已添加到版本控制中,但尚未提交(检入)到VCS仓库。
已修改 本地文件副本已被修改并保存到工作文件夹中。提交文件以在仓库中创建新的修订版。
已过时 本地文件副本(在工作文件夹中)比仓库中的对应文件旧,因此已过时。使用更新更新整个项目命令,该命令位于项目面板的历史记录与版本控制右键菜单或项目 » 历史记录与版本控制主菜单中,以从仓库检索最新文件或保存文件,这将创建冲突条件。
冲突 在您提交自己编辑并保存的文件版本之前,另一个用户已经提交了该文件。使用版本控制更新或解决命令来确定哪个版本的文件将成为仓库中的最新修订版。
领先服务器(Git) 本地工作仓库中的文件比远程Git仓库中的对应文件更新。当本地文件被修改、保存并提交到本地仓库,但尚未推送到远程仓库时,会发生这种情况。
计划删除 项目文件已从版本控制中移除,并将在版本控制提交过程中从VCS仓库和数据库中删除。当文件从本地工作文件夹中缺失(已被删除、重命名或移动)时,也会出现此图标,这可以通过使用历史记录与版本控制 » 更新命令从仓库重新填充文件夹来解决。
已合并

PCB文档已使用PCB CoDesign面板与仓库中的较新修订版合并。将项目提交到工作区以将合并后的PCB文档保存到工作区的仓库。

  • 从面板的右键菜单选择历史记录和版本控制 » 刷新选项,或从主菜单选择项目 » 历史记录和版本控制 » 刷新命令(或按F5),以刷新每个文件条目的当前VCS状态。它将工作文件夹中的文件与设计仓库中的对应文件进行比较,相应地刷新每个文档的状态。
  • 将鼠标悬停在VCS图标上可以看到其含义的定义。
  • 点击VCS图标可以获取有关文档VCS状态的更多信息,并访问执行相关操作的选项。

更改项目文档顺序

项目面板中的文档会自动按逻辑分组或“文件夹”排列,例如源文档(原理图、PCB等)、设置文档(线束、输出作业等)以及在分层设计的情况下,顶层原理图文档。每个文件夹组内的文档默认按添加顺序显示,但可以拖放到组内的新顺序位置。

在新的分层设计中,文档之间的父子关系将在项目面板中显示。请注意,不能通过拖放原理图文档来定义连通性关系,因为跨页连接和设计层次实际上是由图纸符号和端口定义决定的。

► 有关项目层次结构的更多信息,请参阅创建连通性以及项目选项对话框的选项标签中的网络标识符范围部分。

文档重命名

您可以直接更改PCB项目构成设计文件的名称(*.PcbDoc*.SchDoc等)、PCB项目本身(*.PrjPcb)或项目组(*.DsnWrk),方法是使用重命名命令——可从项目面板中项目的右键上下文菜单中获得。

在Altium Designer内部本地重命名项目及其设计文件的示例。当您保存并将更改发送到该工作区时,这些更改将与工作区同步。在Altium Designer内部本地重命名项目及其设计文件的示例。当您保存并将更改发送到该工作区时,这些更改将与工作区同步。

重命名完成后,使用保存到服务器命令(也可从项目的同一上下文菜单中获得)将更改保存到工作区。文件重命名同步在本地工作副本的项目和工作区中的对应项目之间保持。此外,当项目文件名已重命名并且项目已保存到服务器时,工作区会自动更改托管项目的名称参数以匹配。

相反,当通过工作区的浏览器界面更新托管项目的名称时,下次打开项目时,更改将传播到Altium Designer。

要编辑工作区中现有托管项目的属性,请在项目页面上选择其条目,点击项目列表上方的控件,并在关联菜单上选择编辑项。在随后出现的编辑项目窗口中更改项目名称。

在Altium Designer中打开更新后的项目(文件 » 打开项目)时,初始对话框提供了将本地项目文件名与新项目名称对齐的选项,或强制服务器项目名称与现有项目文件名匹配。

如果您已在工作区侧重命名了项目,则可用的选项。如果您已在工作区侧重命名了项目,则可用的选项。

跨项目共享文档

因为Altium Designer项目定义并保存了对存储文档文件的链接,所以可以创建任意数量的项目来链接到这些相同的文档文件。

虽然这可能是一种方便的方式来重复使用已建立的设计文档——比如,在几个项目中包含一个标准的电源原理图——但这不是推荐的做法,因为文档的更改将影响所有链接到它的项目。设计重用的更好方法是建立并应用托管图纸

► 有关设计文档重用和托管图纸的更多信息,请参见托管图纸页面。

管理缺失文档

如果在项目文件夹中找不到项目文件中定义的项目文档(例如,文档已从Windows资源管理器中移除),则视为缺失。打开包含缺失文件的项目时,将在消息面板中显示相应的通知。文档条目将在项目面板中以灰色显示,并用一个区别图标标记为缺失。

提供了相关命令,让您完全控制处理缺失文档。使用项目面板中缺失文档的右键菜单来移除选定的或所有缺失文件,或更新文件路径(即用选定的文件替换缺失文件)。对于处于版本控制下的项目,您还可以恢复本地修改以从项目的VCS仓库中恢复缺失文件。

使用项目条目的右键菜单中的添加现有文件到项目命令将现有文件添加到项目时,如果被添加文件的名称和路径与缺失文件的名称和路径相同(例如,在Altium Designer中打开项目后,缺失文件被添加到项目文件夹中时可能会发生这种情况),将会打开一个确认对话框,询问您是否希望用所选文件替换缺失文件。

将本地文档与提交或发布数据进行比较

对于由工作区托管的项目,您可以将本地保存的原理图、PCB(仅限于Altium 365工作区)和BOM文档与该项目的提交或发布数据进行比较。可以从以下位置选择用于选择应与本地文档进行比较的所需数据集的命令:

Javascript

当选择最新提交最新发布命令时,将开始与最新提交/发布条目的项目数据比较。当选择选择提交或发布命令时,将为所选项目打开项目历史视图。选择提交或发布的磁贴以将本地保存的数据与该提交/发布的数据进行比较。

完成后,比较结果将在新标签页中的比较视图中呈现,该标签页将在您的默认浏览器中打开。

要了解有关工作区提供的设计数据比较功能的更多信息,请参阅设计数据比较Altium 365工作区企业服务器工作区)。

剪贴板面板

为了存储和显示可以在任何阶段添加(粘贴)到Altium Designer文档中的复制对象,从而允许多次复制/粘贴操作,可以使用剪贴板面板。

查看并应用(粘贴)剪贴板面板内容,适用于所有设计数据类型。

要访问该面板,必须启用UI.PanelClipboard 首选项名称字段,在高级设置对话框中默认是禁用的。通过在系统 - 通用页面的首选项对话框中点击高级按钮,可以访问高级设置对话框。如果在高级设置对话框中进行了任何更改,必须重启软件才能使更改生效。

可用的功能取决于您的 Altium Designer 软件订阅级别

Content