Search In: Doc:Documentation: Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Developer Center
Close
搜索 Search on Documentation

发布到工作区

Updated: 一月 01, 2026

在 Online Mode 中使用 Release 视图时，发布流程是一个分阶段的流程；该视图左侧的条目会让你一目了然地看到当前处于哪个阶段：

  1. Configure Server Release – 发布流程的此阶段用于指定你希望生成的数据类型：源数据（始终生成）、制造数据、装配数据（针对基础设计以及每个检测到的变体）。

  2. Validate Project – 发布流程的下一阶段会在已分配的 OutJob 文件中检测到一个或多个“验证（Validation）”类型报告时自动运行。将运行分配给待发布数据项的 Output Job 文件中定义的所有验证输出生成器。

  3. Generate Data – 发布流程的下一阶段会自动运行。在此阶段，将运行分配给所包含数据项的 OutJob 文件中定义的所有其他输出，以生成要发布到 Workspace 中相关目标项的数据。

  4. Review Data – 当所有验证检查通过且输出数据已生成后，发布流程的此阶段允许你审查生成的数据。

    如果你选择使用 Prepare & Release 或 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单），则 Project Releaser 不会在 Review Data 阶段暂停。

  5. Upload Data – 在上一阶段确认发布后，会自动进入下一阶段。该阶段仅显示数据上传到目标 Workspace 中相关数据项修订版的进度。

  6. Execution Report – 这是流程的最后阶段，提供发布摘要。提供导航链接，可快速浏览 Explorer panel 中生成的 Item Revision。若你是作为“发布并发布到 PLM”流程的一部分访问 Project Releaser，则会显示 按钮。单击该按钮以继续该流程的底层工作流，将内容发布到 PLM。

    如果你选择使用 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单），则 Project Releaser 不会在 Execution Report 阶段暂停，并且不会显示 按钮。

  7. Publish to PLM – 仅当在相关已激活流程下运行发布（用于先发布再发布到 PLM）时，才会出现此阶段。当在上一阶段单击 按钮时会自动进入该阶段（或者如果使用了 Prepare & Release & Publish to PLM 命令（来自与 按钮关联的菜单）则会直接进入）。将出现 Login Credentials 对话框。输入你的 PLM 实例的 Username 和 Password，并选择要使用的 PLM 模板（以 <PLMInstance>:<PublishingTemplate> 的形式显示）。

    请注意，你的 PLM 实例登录凭据仅在首次向该实例发布时需要。之后这些凭据将与 Workspace 一起存储。此后，将该项目发布到同一 PLM 实例时，会按照已定义的工作流和所选发布模板直接进行。
    如果你是首次发布，并且（在 PLM 端）尚未将零件号与 Workspace 项目关联，则这些零件号会在 PLM 中创建，并在首次发布过程中与项目关联。你还可以在发布操作中为 Workspace 组件在 PLM 实例中定义组件条目——以便在 PLM 中获得组件 BOM（可选，取决于发布到 PLM 实例时所定义并使用的发布模板）。

在线阶段 1 – 配置服务器发布

发布流程的此阶段用于指定你希望生成的数据类型。可发布的数据项包括：

  • Source Data – 源设计的快照。
  • Fabrication Data – 制造厂（Fabrication House）用于制作裸板所需的数据。
  • Assembly Data for the Base Design (no variations) – 装配厂（Assembly House）依据物料清单（BOM）对裸板进行完整贴装所需的数据，适用于未变体的基础设计。
  • Assembly Data for Design Variant n – 装配厂依据物料清单（BOM）对裸板进行贴装所需的数据，适用于基础设计的 Variant n。

装配数据集的数量将对应于基础（无变体）设计，以及为该设计定义的所有检测到的变体。

此外，你还可以添加并配置 Custom Data 分区——从而创建一组自定义的发布数据。这更多用于向后兼容或自定义数据流。除源数据外，不会创建任何引用。可在发布过程中添加并配置任意数量的自定义数据集（单击当前已定义数据项列表下方的 Add Section 控件）。

项目发布流程的阶段 1——配置要包含在发布中的内容（要生成哪些数据）。
项目发布流程的阶段 1——配置要包含在发布中的内容（要生成哪些数据）。

Source Data 项始终会包含在发布中。其他数据项可选择性包含。

从 Project Release Options 对话框的 Item Naming 选项卡中，您可以直接单击某个命名方案条目，并按需更改命名。或者，单击该字段右侧的按钮以打开 Choose Item 对话框（Explorer 面板的一种形式），它允许您在当前已连接的 Workspace 中指定一个现有的 Item 作为目标。
Item 的命名可在 Release 视图的第一阶段期间随时更改，即在配置要发布到当前已连接 Workspace 的数据时。在单击 之后，相关命名将无法再更改，因为发布中包含的每个已启用数据集都会按该命名创建对应的计划 Item——并且这些 Item 会与项目关联。因此，即使您不继续将数据发布到这些 Item 中，它们仍会以就绪状态存在，相应的命名模板条目也会变为灰色。您可以删除这些计划 Item，或使用 Browse 命令（单击某个 Target Revision 条目以访问菜单），并在每种情况下创建一个具有所需命名的新目标 Item。

在按需配置好将作为发布一部分而创建的数据项后，单击视图右下角的 按钮以继续。

按钮有两种状态。单击它将启动标准 Prepare 命令。这会将发布推进到 Review Data 阶段——使您在提交数据发布之前，基本可以再次确认一切无误。如果您不想暂停进行复核，请使用该按钮的下拉菜单并选择 Prepare & Release 命令。

准备过程中会执行若干发布前检查，包括：

  • 确保项目及所有文件均已保存。
  • 确保项目及所有相关文件（如适用）已提交到 VCS。
  • 确保每个已启用的数据项都已命名。
  • 确保用户具有创建目标 Item（及修订版）的权限。
  • 在 Workspace 中创建所需的目标 Item（及计划修订版）（若当前不存在），并确保对已存在的 Item 使用下一个修订版。

如果发现任何问题，系统会提供解决方案以便您处理（例如保存本地修改的文件并提交到 VCS）。

如果在正在发布的项目中发现外部文档（与项目关联但存储在不同于项目文件夹或其子文件夹的位置的文档），将打开 External files 对话框，并列出外部文档（）。为避免潜在问题，建议将与项目相关的所有文档存储在项目文件夹或其子文件夹中。

Source Data Item 会在此时生成——源设计项目文件的快照将发布到目标 Item 修订版。

在线阶段 2 – 验证项目

当阶段 1 无问题完成后，如果在已分配的 OutJob 文件中检测到一个或多个验证类型报告，则会自动运行发布流程的下一阶段。将运行所有已定义的验证输出生成器（这些生成器定义在分配给正在发布的数据项的 Output Job 文件中）。这包括运行以下任意项：

  • Differences Report – 使用比较器判断源文档与 PCB 设计文档是否正确同步。
  • Electrical Rules Check – 检查所捕获源设计的电气/制图有效性。
  • Design Rules Check – 根据指定的板级设计约束检查 PCB 文档的有效性。
  • BOM Checks – 检查源 BOM 文档（*.BomDoc）中与 Design Items 或 Part Choices 相关的潜在违规（如可用）。
  • Footprint Comparison Report – 将板上封装与其源库进行比较，确保其为最新且匹配。
  • Component State Checking – 检查处于受限状态的元件。作为配置的一部分，您需要为目标 Workspace 中每个当前定义的 Lifecycle Definition 的每个当前定义状态确定要采取的动作：不处理、警告或生成错误。后者将阻止设计发布。此外，运行该检查会生成一个便捷的基于 HTML 的报告，使您可以一目了然地看到哪些设计元件不处于有效状态。
  • Environment Configuration Compliance Check – 检查是否仅使用了通过环境配置允许、且可供您所分配角色使用的数据项（如适用）。该检查还可确保所有设计项均来源于 Workspace。

如果验证成功，将显示 图标，并显示文本 Passed。如果失败，将显示 图标，并显示文本 Failed。

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

在线阶段 3 – 生成数据

当阶段 2 无问题完成后，会自动运行发布流程的下一阶段。在此阶段，将运行分配给所包含 Data Items 的 OutJob 文件中定义的所有其他输出，以生成要发布到 Workspace 中相关目标 Item 的数据。

与其他阶段一样（但在此阶段更明显，因为运行时间更长），会使用图标来显示生成进度：

– 尚未运行/生成。

– 正在运行/生成。

– 生成成功。

– 生成失败。

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

在线阶段 4 – 复核数据

在所有验证检查均已通过并生成输出数据后，发布流程的此阶段允许您查看已生成的数据。

如果您选择使用 Prepare & Release 命令（来自与 按钮关联的菜单），则 Project Releaser 将不会在 Review Data 阶段暂停。

在提交发布并将数据上传到 Workspace 之前，请先检查生成的数据，确认一切符合预期。
在提交发布并将数据上传到 Workspace 之前，请先检查生成的数据，确认一切符合预期。

页面默认以简单（紧凑）视图显示生成的数据。单击与感兴趣部分关联的 Details 控件可切换到更详细的视图。

单击某个 Details 控件，可将对应部分的生成数据从简单视图切换为详细视图。再次单击 Hide Details 控件可切换回去。
单击某个 Details 控件，可将对应部分的生成数据从简单视图切换为详细视图。再次单击 Hide Details 控件可切换回去。

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

许多设计人员常用的一个“可发布”测试，是将当前发布生成的 Gerber 文件与上一次发布的 Gerber 文件进行比较。单击某个 Gerber 输出旁的 Compare Gerber 链接，并从下拉菜单中选择先前的发布，即可将准备好的 Gerber 数据与所选发布的数据进行对比。系统将使用默认浏览器打开您的 Company Workspace 并显示结果。

在将数据发布到 Workspace 之前，从 Project Releaser 访问 Gerber 对比功能。
在将数据发布到 Workspace 之前，从 Project Releaser 访问 Gerber 对比功能。

► 了解有关 Gerber Comparison 功能的更多信息（Altium 365 Workspace、Enterprise Server Workspace）。

在 Source Data 部分的紧凑视图中，单击 View 链接将打开 Windows 文件资源管理器，并定位到保存项目源文件快照的临时文件夹。该功能也可通过各部分标题右侧的 Explore 链接使用。实际上，每个部分都有这样的控件，可快速跳转到临时文件夹中该数据对应的子文件夹。

在详细视图中，右键上下文菜单中的命令可用于打开文档，并定位到其生成位置（临时文件夹中）。您还可以添加“文件夹位置”和“创建日期”等数据列——在网格的标题区域右键并选择 Select Columns 命令，即可打开对话框来自定义要显示的数据。

如果在查看数据后发现需要修改，请单击视图右下角的 按钮。将出现确认对话框，提示所有已生成的数据都会丢失——单击 OK 将取消发布，并返回到流程的第 1 阶段。

系统会自然地阻止在“准备发布”和“将数据发布到 Workspace”之间对设计文件进行任何修改。如果您以任何方式更改了设计文件，发布流程将终止，并返回到发布准备之前的初始阶段。

如果生成的数据看起来都没问题，请单击 按钮继续发布（同样位于视图右下角）。将出现 Confirm Release 对话框，汇总将发布到 Workspace 的项目配置。您也可以在此添加 Name（此处默认条目为 [ProjectName]）、Description，并添加任何相关的发布说明。

确认将发布的内容（就生成的 Item-Revisions 而言），并可更改名称/描述以及添加发布说明。
确认将发布的内容（就生成的 Item-Revisions 而言），并可更改名称/描述以及添加发布说明。

在线阶段 5 – 上传数据

在上一阶段确认发布后，将自动进入此阶段。该阶段仅显示将数据上传到 Workspace 中相关数据 Item 的修订版的进度。

此阶段仅反映将生成的数据上传到 Workspace 中已链接的 Item-Revisions 的进度。
此阶段仅反映将生成的数据上传到 Workspace 中已链接的 Item-Revisions 的进度。

在线阶段 6 – 执行报告

这是流程的最后阶段，提供发布摘要。

发布的最终报告。
发布的最终报告。

使用导航链接可快速访问包含已发布数据（制造数据、装配数据以及任何自定义数据集）的关联 Item Revision，位置在 Explorer panel 中——这是您进入 Workspace 的入口。

借助 Explorer 面板，可直接在 Workspace 中查看项目的已发布数据。
借助 Explorer 面板，可直接在 Workspace 中查看项目的已发布数据。

为项目变体定义的参数会包含在相应的装配数据集修订版中。在 Explorer 面板的 Classic View 中查看项目时，选择所需的装配数据集修订版，并切换到 Parameters 视图选项卡即可查看变体参数。

已向项目变体 Default 添加了一个变体参数 VariantLabel = A。发布的装配数据集包含该参数，可在 Explorer 面板的 Parameters 视图选项卡中找到。
已向项目变体 Default 添加了一个变体参数 VariantLabel = A。发布的装配数据集包含该参数，可在 Explorer 面板的 Parameters 视图选项卡中找到。

就这些——项目发布完成后，您可以直接关闭 Release 视图（使用视图右下角的 按钮）。当您将来需要对同一项目重新发布时，Project Releaser 可让这一过程快速且轻松，并会自动递增目标 Item-Revisions。

每次执行项目发布时，都会在项目的 History 视图时间线中添加一个 Project Released 事件磁贴。磁贴中会显示执行发布的人员姓名（及头像）以及日期和时间。如果在将生成的数据发布到 Workspace 时通过 Confirm Release dialog 添加了发布说明，也会在磁贴中显示。发布中包含的每个数据集也会一并列出。

请注意，如果最新的项目提交（commit）尚未带有标签（tag），系统会自动为该最新提交分配一个标签。该标签的形式为 RELEASE_<RevisionID>，其中 <RevisionID> 是已发布项目源文件的修订号（A.1、A.2 等），例如 RELEASE_A.3。

项目的 History 视图中的 Project Released 事件磁贴示例。由于最新的项目提交没有标签，因此在发布后被打上了标签。
项目的 History 视图中的 Project Released 事件磁贴示例。由于最新的项目提交没有标签，因此在发布后被打上了标签。

► 了解有关 Project History 的更多信息。

发布到 PLM 实例

Related pages: PLM 集成（Altium 365 Workspace、Enterprise Server Workspace），发布到 PLM

作为在 Altium Designer 中运行 Project Releaser 的一部分，您可以将设计发布到某个 PLM 实例。发布操作会使用发布模板（publishing template）——该模板在该 PLM 实例的集成配置中定义——用于控制数据应如何传播到 PLM。此功能可通过适当配置的流程来使用。安装包中提供了一个示例流程定义——Project Releaser with Publish——其底层工作流可在 Project Releaser 中作为额外阶段，实现发布到已集成的 PLM 实例。其工作流图如下所示。

此流程定义无法直接激活并按原样使用。因此它更像是一个“模板”——请根据贵公司的需求进行编辑、命名，并另存为新的流程定义，然后您 can 再将其激活并使用。

默认 Project Releaser with Publish 示例流程定义的工作流图
默认 Project Releaser with Publish 示例流程定义的工作流图

激活后，作为 Project Releaser 的一部分，用于发布到 PLM 实例的流程可在 Altium Designer 中访问：可从活动项目的 Project » Project Releaser 子菜单进入，或从 Project Releaser 右键上下文子菜单进入（在 Projects 面板中右键单击设计项目条目即可访问）。

访问作为 Project Releaser
访问作为 Project Releaser

的一部分、用于发布到 PLM 实例的流程Project Releaser

将显示 Project Releaser，并新增一个阶段——7. Publish to PLM。此外，在与 按钮关联的菜单中还提供了一个命令——Prepare & Release & Publish to PLM——如果您希望运行 Project Releaser 时不停下来查看生成的数据和执行报告，可使用该命令。

用于运行 Project Releaser 的附加命令：不停下来查看生成的数据和执行报告
用于运行 Project Releaser 的附加命令：不停下来查看生成的数据和执行报告

如果您使用标准的 Prepare 命令运行 Project Releaser，在查看并发布数据后， 按钮会在 Execution Report 阶段出现。单击该按钮以继续该流程的底层工作流，从而发布到 PLM。随后将出现 Login Credentials 对话框。请输入您的 PLM 实例的 Username 和 Password，并选择要使用的 PLM 模板（其显示形式为 <PLMInstance>:<PublishingTemplate>）。

如果您选择使用 Prepare & Release & Publish to PLM 命令，最终将直接显示 Login Credentials 对话框。Project Releaser 不会在 Execution Report 阶段暂停，也不会显示 按钮。
请注意，PLM 实例的登录凭据仅在您首次向该实例发布时需要输入。之后这些凭据将与 Workspace 一起存储。此后，将该项目发布到同一 PLM 实例时会直接继续，遵循已定义的工作流以及所选的发布模板。

首次发布到 PLM 实例时访问的 Login Credentials 对话框。
首次发布到 PLM 实例时访问的 Login Credentials 对话框。

单击 Diagram 选项卡以查看该流程的底层工作流。

Login Credentials 对话框的 Diagram 选项卡
Login Credentials 对话框的 Diagram 选项卡

单击 按钮以按照该工作流继续发布流程。

如果您是首次发布，并且（在 PLM 端）尚未将料号与 Workspace 项目关联，则这些料号会在 PLM 中创建，并在首次发布过程中与项目关联。您还可以在发布操作中为 PLM 实例中的 Workspace 元器件定义元器件条目——以便在 PLM 中获得元器件 BOM（可选，取决于发布到 PLM 实例时所定义并使用的发布模板）。
您可以通过 Workspace 的浏览器界面，在项目详细管理页面的 Activities 视图中查看发布到 PLM 流程的状态。项目的详细管理页面可通过以下方式打开：在 Workspace 浏览器界面的 Projects 页面中选择所需项目，单击项目列表上方的 控件，并在相关菜单中选择 Open 条目。或者，直接在列表中双击所需项目条目。该页面会在新的浏览器标签页中打开。您始终可以在流程工作流的历史记录（History 选项卡）中准确查看已创建的内容，例如在 PLM 实例中创建的料号等。
AI-LocalizedAI 翻译
如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。
功能可用性

您可使用的功能取决于您所选择的 Altium 解决方案 —— Altium Develop、Altium Agile（Agile Teams 或 Agile Enterprise 版本），或仍在有效订阅期内的 Altium Designer。

如果您在软件中未找到文中提及的功能，请联系 Altium 销售团队了解更多信息。

旧版文档

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

Content