本地发布
概览
- 了解如何在文件夹发布和 ZIP 发布之间进行选择,以及如何自定义目标文件夹和输出路径。
- 了解发布前检查、验证要求,以及完成发布前审查已生成数据的相关选项。
- 了解重要的保护措施,包括覆盖行为以及发布准备期间对设计更改的限制。
除了受管(在线)发布模式,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字段中定义的路径)。
您可以通过以下信息快速判断Project Releaser是否已配置为离线模式:
-
阶段 1 的标题显示为
Configure Local Release,而不是Configure Server Release(在线模式下的标题)。 -
阶段 5 的标题显示为
Pack Data,而不是Upload Data(在线模式下的标题)。

配置为本地非受管(离线)模式的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。
按需配置好要在发布过程中创建的数据集后,单击视图右下角的
按钮以继续。
此时会执行多项发布前检查,包括:
-
确保项目及所有文件均已保存。
-
确保项目及所有相关文件均已提交到 VCS(如适用)。
-
确保已为每个启用的数据项指定目标文件夹。
如果发现任何问题,系统将提供相应的解决方案(例如,保存本地修改过的文件并提交到 VCS)。
此阶段会生成Source Data,并将源设计项目文件的快照发布到目标文件夹。
离线阶段 2 – 验证项目
阶段 1 顺利完成后,如果在指定的 OutJob 文件中检测到一个或多个验证类报告,发布流程将自动运行此阶段。系统会运行分配给待发布数据项的输出作业文件中定义的所有验证输出生成器。此阶段的运行方式与以受管(在线)模式发布时相同。
离线阶段 3 – 生成数据
阶段 2 顺利完成后,发布流程将自动运行此阶段。在此阶段,会执行分配给所含数据项的 OutJob 文件中定义的所有其他输出,以生成要发布到相应目标文件夹的数据。此阶段的运行方式与以受管(在线)模式发布时相同。
离线阶段 4 – 审查数据
所有验证检查通过且输出数据生成后,您可以在发布流程的此阶段审查生成的数据。此阶段的行为与以受管(在线)模式发布时基本相同。

在确认发布之前,请审查生成的数据,检查所有内容是否符合预期,然后根据所选的非托管发布选项,将数据发送到目标文件夹,或打包到本地 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 字段中定义的路径)。
离线阶段 6 — 执行报告
这是流程的最后一个阶段,提供此次发布的摘要。

使用 Unmanaged - Folder 发布目标时显示的最终发布报告。将鼠标悬停在图像上,可查看发布目标设置为 Unmanaged - Zip 时的相应报告。
使用提供的导航链接,可在 Windows 文件资源管理器中快速定位到相应的输出文件夹或打包的 zip 文件。

直接从界面的“执行报告”阶段快速浏览到本地发布数据的输出文件夹。将鼠标悬停在图像上,可查看浏览到本地发布数据的打包 zip 文件的示例。
)。为避免潜在问题,建议将与项目关联的所有文档存储在项目文件夹或其子文件夹中。