本地发布

概览

当您不使用 Workspace 或当前无法连接到 Workspace 时,可以在 Altium Designer 中使用项目发布器的非托管(离线)模式,将设计发布到本地。本文介绍如何选择本地文件夹或 ZIP 文件作为发布目标、配置输出数据和路径,以及依次完成验证、数据生成、审查并查看最终执行报告。继续阅读,了解如何正确配置并完成本地设计发布。

- 了解如何在文件夹发布和 ZIP 发布之间进行选择,以及如何自定义目标文件夹和输出路径。
- 了解发布前检查、验证要求,以及完成发布前审查已生成数据的相关选项。
- 了解重要的保护措施,包括覆盖行为以及发布准备期间对设计更改的限制。
使用 AI 深入了解:

除了受管(在线)发布模式,Project Releaser还支持本地非受管(离线)发布。通常,如果您不使用工作区,或者当前无法连接到工作区,就会使用这种发布模式。虽然Project Releaser会尽可能自动确定模式,或在无法明确判断时提供选项,但您始终可以强制使用离线模式。具体方法是,将Project Release Options对话框(在发布流程的阶段 1 中单击按钮)中Release Options选项卡上的Release Target 设置为以下选项之一:

  • Unmanaged - Folder:选择此选项可将生成的数据发布到本地文件夹。根文件夹路径在该对话框的Output Path选项卡上指定。默认情况下,此路径设置为[OutputPath](使用“项目选项”对话框的“选项”选项卡上Output Path字段中定义的路径)。

  • Unmanaged - Zip:选择此选项可将生成的数据发布到本地文件夹。数据将打包为一个 Zip 文件。Zip 文件的路径/名称在该对话框的Output Path选项卡上指定。默认情况下,此项设置为[OutputPath][ProjectName].zip(使用Project Options对话框的Options选项卡上Output Path字段中定义的路径)。

定义所需的输出路径时,可以使用[ProjectName]和[<ProjectParameterName>]条目。

您可以通过以下信息快速判断Project Releaser是否已配置为离线模式:

  • 阶段 1 的标题显示为Configure Local Release,而不是Configure Server Release(在线模式下的标题)。

  • 阶段 5 的标题显示为Pack Data,而不是Upload Data(在线模式下的标题)。

配置为本地非受管(离线)模式的Project Releaser。
配置为本地非受管(离线)模式的Project Releaser。

其发布流程与前述受管(在线)发布模式的流程非常相似,只是将数据发布到本地文件夹。为避免重复前文内容,下面仅概述所涉及的阶段,并重点说明差异。

离线阶段 1 – 配置本地发布

在此阶段,您可以配置要从设计项目生成的数据。发布始终包含源数据,还可以根据需要包含制造数据、装配数据(基础设计和/或变体)以及任何自定义数据。

对于要生成的每个数据集,都需要指定用于存储该数据的目标文件夹。默认文件夹名称如下:

  • Source Data – 将生成到Sources文件夹中。

  • Fabrication Data (仅适用于 PCB 项目)– 将生成到Fabrication文件夹中。

  • Assembly Data for no variant – 将生成到Assembly文件夹中。

  • Assembly Data for <VariantName> (仅适用于 PCB 项目)– 将生成到Assembly <VariantName>文件夹中。

  • Custom Data <Custom - n> – 将生成到<Custom - n>文件夹中。

您当然可以根据需要更改这些默认名称。为此,单击当前的Target Folder条目,输入所需的新文件夹名称,然后按Enter。

发布到本地文件夹或打包的 Zip 文件时,请注意:如果使用相同的文件夹名称再次发布,将直接覆盖这些文件夹中现有的数据文件。

按需配置好要在发布过程中创建的数据集后,单击视图右下角的按钮以继续。

按钮有两种状态。在两种非受管发布选项中,其行为略有不同:
  • Unmanaged - Folder:单击该按钮将启动标准的Prepare命令。发布流程将执行至Review Data阶段,以便您在发布到目标文件夹之前,再次检查所有内容是否正确。如果不想暂停以供检查,请使用该按钮的下拉菜单并选择Prepare & Explore命令。
  • Unmanaged - Zip:单击该按钮将启动标准的Prepare命令。发布流程将执行至Review Data阶段,以便您在将数据打包到 Zip 文件之前,再次检查所有内容是否正确。如果不想暂停以供检查,请使用该按钮的下拉菜单并选择Prepare & Pack命令。

此时会执行多项发布前检查,包括:

  • 确保项目及所有文件均已保存。

  • 确保项目及所有相关文件均已提交到 VCS(如适用)。

  • 确保已为每个启用的数据项指定目标文件夹。

如果发现任何问题,系统将提供相应的解决方案(例如,保存本地修改过的文件并提交到 VCS)。

如果在正在发布的项目中发现外部文档(即与项目关联,但存储在项目文件夹及其子文件夹之外的文档),则会打开External files对话框,其中列出外部文档()。为避免潜在问题,建议将与项目关联的所有文档存储在项目文件夹或其子文件夹中。

此阶段会生成Source Data,并将源设计项目文件的快照发布到目标文件夹。

离线阶段 2 – 验证项目

阶段 1 顺利完成后,如果在指定的 OutJob 文件中检测到一个或多个验证类报告,发布流程将自动运行此阶段。系统会运行分配给待发布数据项的输出作业文件中定义的所有验证输出生成器。此阶段的运行方式与以受管(在线)模式发布时相同。

如果任何验证检查未能通过,发布将失败。
单击视图右下角的将停止发布流程。

离线阶段 3 – 生成数据

阶段 2 顺利完成后,发布流程将自动运行此阶段。在此阶段,会执行分配给所含数据项的 OutJob 文件中定义的所有其他输出,以生成要发布到相应目标文件夹的数据。此阶段的运行方式与以受管(在线)模式发布时相同。

单击视图右下角的将停止发布流程。

离线阶段 4 – 审查数据

所有验证检查通过且输出数据生成后,您可以在发布流程的此阶段审查生成的数据。此阶段的行为与以受管(在线)模式发布时基本相同。

如果您使用了 Prepare & Explore (Unmanaged - Folder 发布目标)或 Prepare & Pack 命令(Unmanaged - Zip 发布目标),则此阶段不可用。换言之,流程不会暂停以供审查;数据将立即发布,分别发送到目标文件夹或打包到目标 Zip 文件中。

在确认发布之前,请审查生成的数据,检查所有内容是否符合预期,然后根据所选的非托管发布选项,将数据发送到目标文件夹,或打包到本地 zip 文件中。
在确认发布之前,请审查生成的数据,检查所有内容是否符合预期,然后根据所选的非托管发布选项,将数据发送到目标文件夹,或打包到本地 zip 文件中。

在生成数据的精简视图中,单击 View 链接,即可在 Altium Designer 的相应编辑器中(例如,用于 Gerber 文件或压缩/未压缩 ODB++ 文件的 CAM 编辑器),或在相应的外部应用程序中(例如,用于物料清单的 Microsoft Excel)打开关联的数据文件或文件集。在详细视图中,双击某个条目可仅查看该文件。

如果在审查数据后发现需要修改,请单击视图右下角的 按钮。此时将显示确认对话框,提示所有生成的数据都将丢失。单击 OK 取消发布;您将返回流程的第 1 阶段。

从准备发布到将数据发布到目标文件夹期间,系统会阻止对设计文件进行任何修改。如果您以任何方式更改了设计文件,发布流程将终止,您将返回发布准备之前的初始阶段。

如果生成的数据均无问题,请单击 按钮(同样位于视图右下角)继续发布。接下来的操作取决于您使用的目标发布选项:

  • Unmanaged - Folder:生成的文件将发布到目标文件夹,流程将直接跳转到最后一个阶段,以查看 执行报告。

  • Unmanaged - Zip:流程将进入下一阶段 — Pack Data。

离线阶段 5 — 打包数据

在上一阶段确认发布后,系统将自动进入此阶段,将数据打包为单个本地 zip 文件。Zip 文件的路径/名称在 Project Release Options 对话框的 Output Path 选项卡中指定。默认设置为 [OutputPath][ProjectName].zip(使用 Project Options 对话框的 Options 选项卡上 Output Path 字段中定义的路径)。

此阶段仅适用于使用 Unmanaged - Zip 目标发布选项的情况。

离线阶段 6 — 执行报告

这是流程的最后一个阶段,提供此次发布的摘要。

使用 Unmanaged - Folder 发布目标时显示的最终发布报告。将鼠标悬停在图像上,可查看发布目标设置为 Unmanaged - Zip 时的相应报告。
使用 Unmanaged - Folder 发布目标时显示的最终发布报告。将鼠标悬停在图像上,可查看发布目标设置为 Unmanaged - Zip 时的相应报告。

使用提供的导航链接,可在 Windows 文件资源管理器中快速定位到相应的输出文件夹或打包的 zip 文件。

直接从界面的“执行报告”阶段快速浏览到本地发布数据的输出文件夹。将鼠标悬停在图像上,可查看浏览到本地发布数据的打包 zip 文件的示例。
直接从界面的“执行报告”阶段快速浏览到本地发布数据的输出文件夹。将鼠标悬停在图像上,可查看浏览到本地发布数据的打包 zip 文件的示例。

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

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

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

旧版文档

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

Contents