使用变量管理器

父页面： 设计变体

变体管理器是一个基于文档的用户界面，允许您查看、创建和管理PCB设计项目的设计变体。要访问变体管理器，请在项目面板中右击项目条目并选择变体，或者在原理图或PCB编辑器的主菜单中选择项目 » 变体。

使用变体

创建新变体

要添加新变体，请在变体管理器的变体标签页处于活动状态时，使用位于左上角的添加变体按钮。一个带有默认标题的额外变体列将出现在网格区域，如下图所示。新列的所有单元格都将为空，空单元格表示该组件已安装并且与基础设计无变化。

默认情况下添加的新变体，所有组件都已安装。

配置变体属性

要更改变体选项，请使用其变体模式下的属性面板，可以通过右击所需变体的列标题并选择属性来访问。

访问变体模式下的属性面板以更改变体的选项。

• 使用名称字段为变体定义一个有意义的名称。

  也可以通过点击变体列标题以选中它，然后点击位于变体管理器左上角的 或者右键点击变体列标题然后选择重命名变体来更改变体的名称。

• 如果需要从设计中生成制造变体，请启用允许变更制造输出选项。如果输出作业为制造输出指定了一个变体，并且该变体没有启用该选项，作业的变体名称将以红色显示。请注意，红色的变体名称仅是一个警告标志，变体特定的输出文件仍将生成。

  如果需要为包含'未安装'组件的变体设计生成焊膏掩模输出，请启用允许变更焊膏掩模选项。这些组件的焊盘将不再包含焊膏掩模开口。

  有关如何在输出作业文件中添加和查看变体的信息，请访问在输出作业中准备多个输出页面。

• 使用面板中的变体参数区域来定义变体级别参数的列表。

  可以通过放置一个特殊字符串在原理图或PCB文档中显示变体参数。了解更多关于原理图上的特殊字符串和PCB上的特殊字符串。

  Altium Designer支持项目的不同级别的参数：项目、原理图文档、变体。项目中不同级别包含的参数存在层次结构，这意味着您实际上可以在项目的不同级别创建同名的参数，每个参数都有不同的值。Altium Designer使用优先级来解决这种情况，方式如下：

  1. 变体（最高优先级）
  2. 原理图文档
  3. 项目

  这种安排意味着在原理图文档中定义的参数值将覆盖在项目选项中定义的值，而在变体中定义的参数值将覆盖在原理图文档中定义的值。

变体的属性

右键单击一个单元格然后选择属性以打开显示所选组件/组详细信息的属性面板。变体的组件参数可以根据需要进行编辑。

参数也可以通过在网格中选择一个组件，然后展开网格底部出现的参数区域来查看和编辑。

定义组件变体

基础设计中的每个组件都可以配置为：

• 已安装 - 创建新变体时的默认设置。
• 未安装 - 在该设计变体中未安装/使用基础设计中使用的原始组件。
• 安装了修改过参数的组件，例如组件的值。
• 替代部件 - 完全用另一个组件替换一个组件。

通过点击变体列中的组件单元格并访问提供三个选项的单元格下拉菜单，可以更改设计变体中组件的状态：

• （已安装） - 基础设计中使用的原始组件也在该设计变体中安装/使用。请注意，对于已安装的组件，也可以变更单个参数 - 见下文。
• 未安装 - 在该设计变体中未安装/使用基础设计中使用的原始组件。

• 替代部件 - 此选项允许选择不同的（替代）部件。使用替换对话框（组件面板的模态对话框版本）来选择所需的替代部件。选择该部件后，单元格将显示替代部件的ID。

  选择替代部件后，软件会检查所选替代组件与原始基础设计组件之间的引脚兼容性。为了具有引脚兼容性，替代部件必须与原始组件具有相同数量的引脚，并且这些引脚在位置和电气类型上必须相同。两个组件的符号中使用的图形原语不需要匹配。如果软件检测到替代组件不具有引脚兼容性，则必须关闭确认对话框才能接受替换。在这种情况下，您需要注意对布线的潜在影响。

上述列出的组件状态也可以通过在网格中右键单击，选择设置所选为然后从关联菜单中选择所需状态，如下图所示。

使用所需变体列的单元格中的下拉菜单定义组件变体。选择替代部件选项时，使用替换对话框选择替代部件。

可以通过在属性面板中输入新的参数值来变更适配或替代组件的单个参数。点击所需变体列中组件的单元格，并在其组件变体模式下的属性面板的组件参数区域中使用选定变体的列输入变化的参数值。对于封装参数，如果组件分配了多个封装模型，点击单元格下拉菜单选择一个封装。与基础设计不同的参数值将以黄色显示，网格区域的组件单元格将显示组件名称。

定义适配组件的替代参数示例。如图所示输入新的参数值。将光标悬停在图像上以查看定义新参数值后的组件单元格。

克隆变体

您可以使用克隆命令克隆一个变体。在变体名称列的标题上右键单击，然后选择克隆选项。将添加一个具有相同数据和名称（附加有"副本"）的新列。您可以使用重命名选项为新列命名一个合适的标题。

移除变体

要删除变体，请选择标题，然后使用图标。在下面显示的右键上下文菜单中也包括删除此变体或所有变体的功能。删除发生之前会打开一个对话框进行确认。

使用群组

为了方便管理大量的设计变体，变体管理器还允许您从选定的原理图表、由选定的表符号引用的表、或选定的组件类中创建组件群组，以功能为基础的视图来查看组件变化。对于每个群组，您可以定义一个或多个“选项”，这些选项本质上反映了群组中一个或多个组件的某种变化。然后可以基于这些定义的群组和选项创建变体，支持创建变体的层次结构。当需要进行更改时，编辑群组选项中的值会立即反映在使用该群组选项的所有变体中。

使用群组的工作流程如下：

1. 使用 Variant Manager 顶部的控件切换到组标签。

2. 使用添加组按钮的下拉菜单，选择应该为其创建组的原理图文档、表符号或组件类。

   
   添加一个组以便于基于此组进行进一步的变体管理。

3. 新组将在 Variant Manager 的左侧窗格中列出，而选定组的组件将在右侧列出。

   默认情况下，所选原理图表、表符号或组件类的名称将被分配给新创建的组。使用组列表区域底部的重命名按钮根据需要重命名组。

   使用添加选项按钮为当前选定的组添加一个选项。一个带有默认标题的额外选项列将出现在网格区域。新列的所有单元格都将为空，空单元格表示该组件已安装且与基础设计未更改。

   
   为选定的组添加一个选项，如图所示。将光标悬停在图像上以查看默认选项列。

4. 通过更改默认名称为新创建的选项分配一个有意义的名称。点击选项的列标题以选择它，然后点击网格区域底部的重命名按钮或右键点击标题并选择重命名以访问对话框输入新名称。

   
   为一个选项设置一个有意义的名称。

5. 使用所需选项列中的组件单元格配置组件变体。该过程与为变体定义组件变体时的过程相同。

   
   为所选选项配置组件变体。

   变体组选项的单元格内容可以使用右键上下文菜单中的相应命令或使用适当的快捷键（分别为Ctrl+C、Ctrl+V、Ctrl+X）进行复制、粘贴或剪切。

6. 通过在网格区域中右键点击并选择添加选项，为选定的组添加更多选项。根据需要配置新选项。

   
   根据需要添加和配置更多选项。

7. 在 Variant Manager 的变体标签中，为其创建了组的组件将在网格区域的适当条目下显示。使用单元格的下拉菜单为组标签上创建的组选择一个选项。将应用为该组中的组件配置的变体。

   
   为选定的组添加一个选项，如图所示。将光标悬停在图像上以查看默认选项列。

注释

• 当您配置变体时，设置将保存在项目文件中。这包括未安装状态，对已安装组件的本地参数变化，以及替代部件的参数值。替代部件存储在文件<ProjectName>.PrjPcbVariants中。
• 变体列可以被固定显示在最前面，位于未固定列的左侧。要固定一个变体列，将光标悬停在其标题上并点击。
• 双击一个组件或右键然后选择交叉探测选项跳转到原理图上的那个组件。
• 点击变体管理器左下角的查看报告按钮，使用打开的变体报告对话框生成详细的变体报告HTML格式。
• 当原理图发生变化时，变体管理器顶部会显示适当的通知。点击通知旁边的刷新控件以更新变体管理器中的数据。