本地发布

您正在阅读的是 23. 版本。关于最新版本,请前往 本地发布 阅读 25 版本
除了托管(在线)发布模式项目发布器还支持本地的、非托管的(离线)发布。通常,如果您不使用工作区,或者当前无法连接到您的工作区,就会使用这种发布模式。而且,尽管项目发布器会在可能的情况下自动确定模式,或在不那么明确的情况下提供选项,您始终可以强制使用离线模式。后者是通过在项目发布选项对话框的发布选项标签页上设置发布目标来执行的(在发布过程的第一阶段,点击按钮),设置为以下之一:
  • 未管理 - 文件夹:设置此选项以将生成的数据释放到本地文件夹。根文件夹路径在对话框的输出路径标签页上指定。默认情况下,这被设置为[OutputPath](使用输出路径字段中定义的路径,在项目选项对话框的选项标签上)。
  • 未管理 - Zip:设置此选项以将生成的数据释放到本地文件夹。数据将被打包成一个Zip文件。Zip路径/名称在对话框的输出路径标签页上指定。默认情况下,这被设置为[OutputPath][ProjectName].zip(使用输出路径字段中定义的路径,在选项标签的项目选项对话框中)。
您可以在定义所需的输出路径时使用[ProjectName][<ProjectParameterName>]条目。

您可以通过以下方式快速判断项目发布器是否配置为其离线模式:

  • 如果第1阶段的标题显示为配置本地发布,而不是在线模式下的配置服务器发布
  • 如果第5阶段的标题显示为打包数据,而不是在线模式下的上传数据


在本地、未管理(离线)模式下配置的项目发布器

发布过程与之前描述的在线(管理)发布模式非常相似,只是目标是将数据发布到本地文件夹。这里我们不再重复之前描述的信息,而是简要概述所涉及的阶段,并突出任何差异。

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

这里是您配置希望从设计项目中生成的数据的地方。源数据始终作为发布的一部分包含在内,您可以选择包括制造、装配(基础和/或变体)以及任何所需的自定义数据。

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

  • 源数据 – 将在Sources文件夹中生成。
  • 制造数据 – 将在Fabrication文件夹中生成。
  • 无变体的装配数据 – 将在Assembly文件夹中生成。
  • <VariantName>的装配数据 – 将在Assembly <VariantName>文件夹中生成。
  • 自定义数据 <Custom - n> – 将在<Custom - n>文件夹中生成。
您当然可以根据自己的需求更改这个默认的命名。要这样做,请点击当前的目标文件夹条目,输入文件夹的新名称,然后按回车键
当向本地文件夹或打包的Zip文件释放时,请记住使用相同定义的文件夹名称重新释放将简单地覆盖这些文件夹中的现有数据文件。
在配置了按需创建的数据集后,点击视图右下角的按钮继续。
按钮有两种状态。这两种状态在两个未管理的发布选项之间略有不同:
  • 未管理 - 文件夹:点击按钮将启动标准的准备命令。这将继续执行发布流程直至审查数据阶段 - 允许你基本上再次检查所有内容是否就绪,然后再发布到目标文件夹。如果你不想暂停进行审查,可以使用与按钮关联的下拉菜单并选择准备 & 探索命令。
  • 未管理 - Zip:点击按钮将启动标准的准备命令。这将继续执行发布流程直至审查数据阶段 - 允许你基本上再次检查所有内容是否就绪,然后再将数据打包进Zip文件。如果你不想暂停进行审查,可以使用与按钮关联的下拉菜单并选择准备 & 打包命令。

现在执行了几项发布前检查,包括:

  • 确保项目及所有文件已被保存。
  • 如果适用,确保项目及所有相关文件已提交至版本控制系统(VCS)。
  • 确保每个启用的数据项都已指定目标文件夹。

如果发现任何问题,将提供解决方案以解决这些问题(例如保存本地修改的文件并提交至VCS)。

此阶段将生成源数据 —— 将源设计项目文件的快照发布到目标文件夹。

离线阶段2 – 验证项目

在第一阶段顺利完成后,如果在指定的OutJob文件中检测到一个或多个验证类型的报告,下一个发布过程阶段将自动运行。所有在分配给正在发布的数据项的输出作业文件中定义的验证输出生成器都将被执行。这个阶段的运行方式与在线(Online)模式下发布时的运行方式相同。

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

离线阶段 3 – 生成数据

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

点击视图右下角的 将停止发布过程。

离线阶段 4 – 审核数据

所有验证检查通过,并且生成了输出数据后,发布过程的这个阶段允许您审查生成的数据。这个阶段的行为与在线(Managed)模式下发布时非常相似。

如果您使用了准备 & 探索命令(非托管 - 文件夹发布目标),或准备 & 打包命令(非托管 - Zip发布目标),这个阶段将不会对您开放 - 换句话说,不会有审查的暂停,数据将会直接发布 - 分别发布到目标文件夹,或打包进目标Zip文件。


在提交发布之前,检查生成的数据是否都符合要求,并将数据发送到目标文件夹,或根据所选择的非托管发布选项,将数据打包到本地化的zip文件中。

在生成的数据的紧凑视图中,点击查看链接以打开关联的数据文件或文件集,可以在Altium Designer内的相关编辑器中打开(例如CAM编辑器),或在相关的外部应用程序中打开(例如Microsoft Excel)。在详细视图中,双击一个条目以仅查看该文件。 如果在审查数据后,你发现需要进行修改,请点击视图右下角的按钮。一个确认对话框将会出现,提醒你所有生成的数据将会丢失 - 点击确定将取消发布,并且你将返回到流程的第一阶段。
系统自然会防止在准备发布和将数据释放到目标文件夹之间修改设计文件。如果您以任何方式更改了设计文件,发布过程将终止,并且您将返回到发布准备之前的初始阶段。

如果生成的数据看起来都不错,请通过点击按钮(也在视图的右下角)继续进行发布。接下来会发生什么取决于您正在使用的目标发布选项:

  • 未管理 - 文件夹:生成的文件将被释放到目标文件夹中,流程将直接跳转到最后阶段,查看执行报告
  • 未管理 - 压缩包:流程将继续进入下一阶段 - 打包数据

离线阶段 5 – 打包数据

在确认了上一阶段的发布后,自动进入下一个阶段,该阶段涉及将数据打包成一个单一的、本地化的压缩文件。压缩文件的路径/名称在项目发布选项对话框的输出路径标签页上指定。默认设置为[OutputPath][ProjectName].zip(使用项目选项对话框的选项标签页上定义的输出路径字段)。

此阶段仅适用于您使用Unmanaged - Zip目标发布选项时。

离线阶段 6 – 执行报告

这是流程的最后一个阶段,提供发布的总结。

发布的最终报告,使用未管理 - 文件夹作为发布目标时显示的样子。将鼠标悬停在图片上,可以看到将发布目标设置为未管理 - 压缩包时的等效情况。
发布的最终报告,使用未管理 - 文件夹作为发布目标时显示的样子。将鼠标悬停在图片上,可以看到将发布目标设置为未管理 - 压缩包时的等效情况。

使用提供的导航链接可以快速地在Windows文件资源管理器中探索输出文件夹或相应的压缩zip文件。

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

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

软件的功能取决于您购买的Altium产品级别。您可以比较Altium Designer软件订阅的各个级别中包含的功能,以及通过Altium 365平台提供的应用程序所能实现的功能。

如果您在软件中找不到某个讨论过的功能,请联系Altium销售团队以获取更多信息。

Content