使用集成库

集成库反映了Altium Designer的集成元件模型。在此模型中，更高级别的元件在原理图库文件（*.SchLib）中的原理图符号内建模。其他模型从符号链接，并且将元件参数添加到符号中。所有源库 - 符号和链接的模型 - 都在集成库包项目中定义，随后编译成单个文件 - 一个集成库，或IntLib。

本文档将探讨创建集成库的各种方式，以及如何从该库中放置和修改。

集成库的好处

编译成集成库的主要好处是：

• 所有组件信息都可在一个单一的、便携式文件中获得。由于所有模型都打包到集成库中，因此只需要一个文件就可以提供给项目或在项目迁移时使用。如果你在不同的工作站之间分配工作，或者想要与他人分享你的设计，这种便携性是无价的。
• 如果一个组件从集成库放置到设计原理图上，只要能找到它所来源的集成库，Altium Designer就保证能找到正确的模型（即不需要处理分离的库文件和模型文件，其中模型链接可能非常“脆弱”并且容易被日常管理任务破坏，比如重命名硬盘上的文件夹）。
• 从安全角度来看，集成库是稳固的。一旦它们被生成，就不能被更改。实际上，更新一个集成库真正意味着完全替换它。你必须有意识地打开原始库包，更新源文件，然后重新编译。
• 这些库在编译时也会进行完整性检查。这意味着它们不仅会检查可用性，还会检查正确的引脚映射。即使你想要继续使用独立的库文件，也建议在集成库包中编译你的原理图库，以确保源组件能正确映射到目标模型。一旦满意，你可以忽略你创建的集成库，继续直接从你的原理图库中放置。

使用库包创建IntLib

集成库包（*.LibPkg）是Altium Designer项目的一种，用于收集生成集成库所需的设计文档集。在原理图库编辑器中绘制原理图符号，并为每个符号定义模型引用/链接以及任何参数信息。这些信息存储在一个或多个原理图库文件中。引用的模型可以包括PCB封装、电路仿真模型和信号完整性模型。

必须添加到集成库包中的唯一文档是原理图库（或库）。包含PCB 2D/3D组件模型和仿真模型/子电路的文件可以位于项目内的任何有效搜索位置、已安装库列表中的文件，或为包指定的搜索路径中。

然后，库包被编译成单个集成库文件（*.IntLib）。

总结来说，创建一个集成库主要有四个步骤：

1. 创建一个源库包。
2. 创建并添加所需的源原理图库文件。
3. 创建并添加（或指向）所需的领域模型文件。
4. 编译库包以产生集成库文件。

创建源库包

通过从主菜单选择文件 » 新建 » 库命令，然后在打开的新建库对话框的文件区域选择集成库选项，来创建一个新的集成库包。点击创建后，新的库包项目将被添加到项目面板中，并且最初不会包含任何文档。

创建并添加源原理图库

创建包含所需组件的源原理图库（*.SchLib）。对于每个组件，添加所需的模型链接和参数信息。有两种创建源原理图库的方法：

• 从头开始，通过使用主菜单中的文件 » 新建 » 库命令并从文件区域选择原理图库选项来新建库。使用原理图符号编辑器创建新组件，或者从其他已打开的原理图库中复制组件。
• 在项目面板中右击库包的条目，然后从上下文菜单中选择添加新项目到项目 » 原理图库命令。
• 使用设计 » 生成原理图库命令，从项目中已经放置在原理图文档上的组件。

准备好源原理图库（或多个库）后，使用以下方法之一将其添加到库包中：

• 使用项目 » 添加现有项目到项目命令。
• 在项目面板中右击库包条目，然后从上下文菜单中选择添加现有项目到项目命令。

来源 SchLib 已添加到库包中。

创建和添加领域模型文件

在相应的文件中创建由原理图组件引用的模型：在PCB库（*.PcbLib）中创建PCB 2D/3D组件模型， 在模型（*.Mdl）和子电路（*.Ckt）文件中创建仿真模型和子电路。当然，最重要的模型将是PCB 2D/3D组件模型，就像其原理图库对应物一样，可以通过两种方式创建：

• 通过主菜单中的文件 » 新建 » 库命令，并从新建库对话框的文件区域选择PCB库选项。使用PCB封装编辑器创建新的2D封装（并添加任何3D实体信息），或者从其他已打开的PCB库中复制组件。
• 在项目面板中的库包条目上右击，然后从上下文菜单中选择添加新项目到项目 » PCB库命令。
• 使用设计 » 制作PCB库命令，从已经放置在PCB文档上的PCB 2D/3D组件模型中。

指定在哪里找到模型

定义了模型文件后，现在需要使它们可供库包使用，以便在需要时可以轻松定位——记住，模型是通过（或链接到）原理图组件引用的。Altium Designer有一个标准系统，无论您是在构建一个集成库包，还是在进行原理图设计，都可以使模型可用。有三种方法可以使模型可用：

• 将库/模型添加到项目中。
• 在已安装库列表中安装库/模型。在这里，它将可供所有设计项目使用。
• 定义一个到库/模型的搜索路径。

每种方法都有其优势，因此选择最适合您的工作习惯的方法。不同的模型也更适合不同的方法。例如，当打开库包时，您可能不希望在项目面板中看到大量的仿真模型列表，但您可能希望看到PCB 2D/3D组件模型库。在这种情况下，定义一个搜索路径到存储仿真模型的文件夹，并将PCB库添加到库包中。 这三种模型可用性方法共同构成了可用的基于文件的库（对一个项目可用），并且都可以在可用的基于文件的库对话框中定义，该对话框可以通过点击组件面板右上角的然后选择基于文件的库偏好设置命令来访问。 要从Altium NEXUS访问此命令，您需要启用旧版组件管理方法的使用。在Altium NEXUS中，默认情况下此功能是禁用的，因为不推荐使用。您可以通过启用`Legacy.UnManagedLibraries`选项来恢复此功能，该选项位于高级设置对话框中——通过点击系统 - 通用页面上的高级按钮，进入首选项对话框来访问。您需要重启Altium NEXUS，对此设置所做的更改才会生效。

PCB 库（以及其他所需的模型文件）也可以直接使用添加现有项目到项目命令添加到库包中，该命令可从主项目菜单或与库包条目相关的右键菜单中的项目面板访问。

来源 PcbLib 被添加到库包中。

从搜索路径标签页定义模型文件的搜索路径，通过可用的基于文件的库对话框访问搜索路径标签页，进入集成库选项对话框（项目 » 项目选项）。根据需要添加一个或多个路径，记住模型文件的搜索是按照这些路径从上到下的顺序进行的。点击刷新列表按钮，以验证所需的模型文件是否确实被找到，并在必要时调整路径。

要访问集成库选项对话框中的搜索路径标签页，必须在高级设置对话框中启用UI.ProjectOptions.SearchPaths选项 - 通过点击首选项对话框的系统 - 通用页面上的高级按钮来访问。您需要重启Altium Designer，此设置的更改才会生效。

编译和验证库包

在将源库添加到库包中并根据需要定义了模型文件的路径之后，现在可以编译该包以最终生成集成库。与其他任何项目一样，集成库包的编译器将生成警告和/或错误消息列表，例如，警告任何未找到的模型。此外，还可以检查引脚映射错误，例如将指令映射到1和2垫时，实际的封装包含A和K垫。 即使您想继续使用离散的库文件（*.SchLib、*.PcbLib），如果只是为了确保源组件能正确映射到目标模型，也建议您在集成库包中编译您的原理图库。 在运行编译之前，审查并适当设置错误报告条件是明智的，可以在“集成库选项”对话框的错误报告标签页上进行设置。

在编译库包之前，设置错误报告选项和严重性级别是一个好主意。

要继续进行编译，请使用编译集成库命令，该命令可以从主项目菜单或与库包条目相关的右键菜单中选择，在项目面板中可以找到。源库和模型文件将被编译成一个以源库包命名的集成库（<LibraryPackageName>.IntLib）。编译器将检查违规情况，任何发现的错误或警告都将列在消息面板中。修复源库中的任何问题，然后重新编译。

编译集成库包时，编译器标记的示例错误。

集成库保存在“集成库选项”对话框的选项标签上指定的输出文件夹中（默认为项目位置的子文件夹：\Project Outputs for <ProjectName>）。它会自动添加到可用的基于文件的库对话框的已安装标签和偏好设置对话框的数据管理 - 基于文件的库页面中。

从项目文档创建IntLib

集成库也可以直接从组成的项目文档（源原理图和PCB文档）中创建。如果你想创建并重用一个工作库或归档你完成的设计，这非常有用。使用创建集成库命令，该命令在原理图或PCB编辑器的主设计菜单中可用。

这个过程主要包括：

1. 打开所有源原理图文档并创建一个原理图库。
2. 从PCB文档创建一个PCB库。
3. 将这些库编译成一个集成库，以项目命名（<项目名称>.IntLib）。

IntLib 被添加到项目中（位于项目面板下的Libraries\Compiled Libraries），添加到已安装的库中（作为可用于任何项目的可用基于文件的库的一部分），并通过组件面板提供。

直接从活动设计项目的原理图和PCB文件中，流畅地创建集成库。

从数据库库创建IntLib

相关页面： 数据库库

如果您希望您的Altium Designer组件与公司数据库紧密结合，Altium Designer的数据库库是理想选择。如果设计需要离开公司场所，或者如果您更愿意让设计师使用安全的集成库工作，这都可以轻松实现。Altium Designer提供了直接从数据库库编译集成库的功能：标准数据库库（DbLib）或版本控制的SVN数据库库（SVNDbLib）。通过这种方式，您的CAD图书管理员仍然可以使用数据库库，而您的设计师使用定期重新生成的集成库以“离线”方式工作。

转换是使用离线集成库制作向导执行的。该过程是基于每个数据库表进行的，可以完全控制哪些表在数据库中被考虑。每个包含的表都将生成一个单独的集成库。

使用离线集成库制作器将您的数据库库（DbLibs或SVNDbLibs）转换为“离线”集成库。

该过程包括以下步骤：

1. 当您想要转换的数据库库文件（*.DbLib）或 SVN 数据库库文件（*.SVNDbLib）作为活动文档打开时，从主菜单中选择工具 » 离线集成库制作器命令以访问离线集成库制作器。
2. 使用要转换的库页面来指定要处理的 DbLib 或 SVNDbLib。默认情况下，从中访问离线集成库制作器的活动库将被指定为要转换的库。如果需要，您可以自由浏览并选择不同的数据库库。
3. 使用选项页面来指定链接数据库中的哪些表格将包含在转换中。默认情况下，所有数据库表格都包含在转换中。要排除一个表格，请确保其关联的转换选项被禁用。此离线集成库制作器的页面还允许您指定一个输出目录，生成的集成库将被存储在该目录中。直接输入此基本目录的路径，或点击字段右侧的图标访问对话框，在其中浏览并选择所需的目录。每个包含的数据库表格生成的输出（集成库）将存储在指定输出目录内的自己的子文件夹中，使用表格的名称命名。
4. 选择数据库库并根据需要设置相关转换选项后，点击下一步继续进行转换。将显示一个进度条，以及当前正在转换的数据库表格的信息。请记住，转换过程是为您选择转换的每个数据库表格执行的。以下基本上是此过程的分解：
   1. 创建并打开一个集成库包（*.LibPkg）在项目面板中。包使用表格的名称命名。例如，对于一个名为电容器 - 陶瓷的表格，这将给出电容器 - 陶瓷.LibPkg。
   2. 创建一个原理图库文档并添加到LibPkg中。原理图再次使用表格的名称命名（例如，电容器 - 陶瓷.SchLib）。
   3. 然后考虑表格中的每条记录，并构建相应的Altium Designer组件。为此，从适当的源库中检索引用的原理图符号并将其作为组件添加到新的原理图库文档中。然后将记录中定义的参数和模型链接信息添加到该组件中。
   4. 为记录检索并添加引用的封装模型到一个PCB库文档中。此文档再次以表格命名（例如，电容器 - 陶瓷.PcbLib）。然后将PCB库文档添加到LibPkg中。
   5. 如果源库是DbLib，并且在数据库记录中定义了PCB3D和/或仿真模型链接，则还将引用的PCB3D库和仿真模型文件添加到LibPkg中。这些模型的位置保持不变。模型的完整路径作为其相应模型链接的一部分指定。
   6. 然后编译LibPkg以生成集成库（例如，电容器 - 陶瓷.IntLib），随后将其添加到Altium Designer的已安装库中。

当前安装的库可以通过首选项对话框的数据管理 - 基于文件的库页面以及通过点击组件面板右上角的后选择基于文件的库偏好设置，进入的可用基于文件的库对话框中的已安装标签页查看。

通过组件获取创建IntLib

相关页面： 使用内容车获取工作区数据

您还可以从工作区获取组件，导入到集成库（*.IntLib）中。并且，从这样的集成库放置组件时，实际的链接会回到工作区中的组件。这使您能够有效地以离线方式使用公司的工作区组件，同时确保设计仍然与源工作区中的那些组件保持真实的连接。

从内容购物车对话框开始，获取IntLib的过程如下：

1. 点击选择目标服务器链接并从菜单中选择IntLib文件。

   
   将内容购物车的目标设置为IntLib文件。

2. 指定生成的IntLib文件的名称和位置。默认情况下，文件将以Integrated_Library - <日期> - <时间>.IntLib的格式命名，并在\Users\Public\Documents\Altium\AD<版本>\Library\ExportCmpLib位置生成。通过点击更改链接访问的另存为对话框，根据需要修改此设置。

   
   接受默认的目标文件夹和文件名，或根据需要进行更改。

3. 如果您需要将额外的组件获取到同一个IntLib中，请点击添加更多项目链接，并选择选择项以访问选择项目对话框（资源管理器面板的“精简版”）。从这里，您可以浏览源工作区以查找更多项目。或者，选择手动添加项以访问添加新项目对话框。该对话框允许您粘贴您需要的外部项目列表（每行一个项目），然后可以使用选定的搜索条件（GUID、项目ID、名称或MPN）在源工作区内搜索这些项目。

4. 准备就绪后，点击按钮，继续生成IntLib。将创建一个临时的集成库包（*.LibPkg），生成并添加源SchLib（带有符号、参数和模型链接）和PcbLib（带有封装模型）文件。然后编译这些文件以产生IntLib文件，该文件将在指定的文件夹中生成。一个信息对话框将确认文件已成功生成。

   
   将购物车交付到目标文件夹，该文件夹将包含所需的集成库文件。

1. 点击选择目标服务器链接并从菜单中选择IntLib文件。

   
   将内容车的目标设置为IntLib文件。

2. 指定生成的IntLib文件的名称和位置。默认情况下，文件将以Integrated_Library - <日期> - <时间>.IntLib的格式命名，并在\Users\Public\Documents\Altium\NEXUS<版本>\Library\ExportCmpLib位置生成。通过点击更改链接访问的另存为对话框，根据需要修改此设置。

   
   接受默认的目标文件夹和文件名，或根据需要进行更改。

3. 如果您需要将额外的组件获取到同一个IntLib中，请点击添加更多项目链接，并选择选择项以访问选择项目对话框（资源管理器面板的“精简版”）。从这里，您可以浏览源工作区以查找更多项目。或者，选择手动添加项以访问添加新项目对话框。该对话框允许您粘贴您需要的外部项目列表（每行一个项目），然后可以使用选定的搜索条件（GUID、项目ID、名称或MPN）在源工作区内搜索这些项目。

4. 准备就绪后，点击按钮，继续生成IntLib。将创建一个临时的集成库包(*.LibPkg)，生成并添加源SchLib（带有符号、参数和模型链接）和PcbLib（带有封装模型）文件。然后编译这些文件以产生IntLib文件，该文件将在指定的文件夹中生成。一个信息对话框将确认文件已成功生成。

   
   将车送至目标文件夹，该文件夹将包含所需的集成库文件。

在生成后，IntLib 被添加到已安装库列表中 - 这是软件的可用基于文件的库的一部分。

从集成库放置组件

从集成库放置组件是通过组件面板执行的。放置可以从活动的原理图文档或活动的PCB文档中进行。放置可以通过以下方式执行：

• 从组件面板下拉菜单中选择所需的*.IntLib文件，然后右键点击要放置的组件并选择上下文菜单中的放置<组件名称>。将组件定位在原理图文档上，然后点击放置。
• 点击并拖放所需的组件到设计空间上。

通过使用放置按钮方法，可以放置多个组件实例，因为这种方法会保持在放置模式，直到右键点击或按Esc键。拖放方法感觉更直接，但本质上是“单次操作”。 要在组件面板中访问集成库，您需要启用传统组件管理方法。在Altium NEXUS中，默认情况下此功能是禁用的，因为不推荐使用。您可以通过启用高级设置对话框中的Legacy.UnManagedLibraries选项来恢复此功能 - 通过点击系统 - 通用页面上的高级按钮，进入首选项对话框来访问。您需要重启Altium NEXUS以使此设置的更改生效。

虽然原理图库和集成库可能包含相同的组件（具有所有相同的模型链接），但从这些库中放置的组件在检索其模型信息时的行为将不同。从集成库中放置的组件将查找原始集成库以获取其模型，而从原理图库中放置的组件将无法访问存储在集成库中的模型。

修改集成库

集成库用于放置组件，不能直接编辑。要更改集成库，请先在源库中进行修改，然后重新编译库包以生成包含这些更改的新集成库。

修改集成库的步骤：

1. 打开所需的集成库的源库包项目。
2. 打开要修改的源原理图或模型库。
3. 根据需要进行更改，保存修改后的库然后关闭它们。
4. 重新编译库包。新生成的集成库将替换旧的、现有的版本。

反编译集成库

有时可能需要访问集成库中的源库进行修改，但无论出于何种原因，都无法访问原始的源库包项目。这就是单个、可移植的集成库文件的另一个方面发挥作用的地方。尽管无法直接编辑集成库；它们可以被反编译回到它们的构成源符号和模型库。

要做到这一点：

1. 打开包含需要修改的源库的集成库。可以通过以下任一方式：
   1. 选择文件 » 打开命令，在选择要打开的文档对话框中浏览到集成库，然后点击打开。
   2. 从Windows文件资源管理器中拖放IntLib文件到Altium Designer窗口上。

2. 在出现的打开集成库对话框中，点击提取按钮。

源原理图和模型库被提取并保存在一个以集成库文件名命名的新文件夹中，该文件夹位于原始集成库所在的文件夹中。然后创建一个库包（<IntegratedLibraryFileName>.LibPkg），源原理图和PCB库被添加到项目中，并在项目面板中显示。仿真模型和子电路文件不会自动添加到项目中。

从集成库中提取源库文件 - 反编译以产生一个库包项目。

库包不会自动保存。确定项目的保存位置和名称 - 默认情况下，文件将保存在提取的源文件相同的文件夹中。