統合ライブラリ

統合ライブラリは、Altium Designerの第二世代コンポーネント管理方法論、すなわち統合コンポーネントモデルを反映しています。このモデルでは、上位レベルのコンポーネントがスキーマティックライブラリファイル内のスキーマティックシンボル内でモデル化されます。他のモデルはシンボルからリンクされ、コンポーネントパラメータはシンボルに追加されます。すべてのソースライブラリ - シンボルとリンクされたモデル - は、統合ライブラリパッケージプロジェクト内で定義され、その後、単一のファイル、すなわち統合ライブラリまたはIntLibにコンパイルされます。

この文書では、統合ライブラリの作成方法、およびそのようなライブラリからの配置と変更について様々な観点から見ていきます。

統合ライブラリのメリット

統合ライブラリにコンパイルする主な利点は以下の通りです:

• すべてのコンポーネント情報は1つのポータブルファイルで利用可能 - 統合ライブラリにすべてのモデルがパッケージされているため、プロジェクトに必要なのは1つのファイルだけであり、プロジェクトが移動される際にもそのファイルを移動させるだけで済みます。このポータビリティは、作業を異なるワークステーションで分割する場合や、設計を他人と共有したい場合には非常に貴重です。
• 統合ライブラリから設計図にコンポーネントが配置される場合、Altium Designerはその統合ライブラリが見つかれば正しいモデルを見つけることが保証されます - ライブラリとモデルファイルを別々に扱う際の、モデルリンクが非常に「壊れやすく」、ハードドライブ上のフォルダ名を変更するなどの日常的な管理作業によって簡単に破損する問題がありません。
• セキュリティの観点から、統合ライブラリは堅牢です - 一度生成されると、変更することはありません。実際に統合ライブラリを更新するということは、それを完全に置き換えることを意味します - 元のライブラリパッケージを意図的に引き上げ、ソースドキュメントを更新し、再コンパイルする必要があります。
• これらのライブラリはコンパイル時に整合性がチェックされます。つまり、利用可能性だけでなく、正しいピンマッピングもチェックされます。離散的なライブラリファイルを使用し続けたい場合でも、ソースコンポーネントがターゲットモデルに正しくマッピングされることを保証するために、スキーマティックライブラリを統合ライブラリパッケージでコンパイルすることが推奨されます。満足したら、作成した統合ライブラリを無視し、スキーマティックライブラリから直接配置を続けることができます。

ライブラリパッケージを使用したIntLibの作成

統合ライブラリパッケージ（*.LibPkg）は、統合ライブラリを生成するために必要な設計ドキュメントのセットをまとめるために使用されるAltium Designerプロジェクトの一種です。回路図シンボルは、回路図ライブラリエディタで描画され、それぞれに対してモデル参照/リンクが定義され、任意のパラメトリック情報と共に保存されます。これらは、1つ以上の回路図ライブラリファイルにわたって保存されます。参照されるモデルには、PCB 2D/3Dコンポーネントモデル、回路シミュレーションモデル、および信号整合性モデルが含まれることがあります。

統合ライブラリパッケージに追加する必要があるドキュメントは、回路図ライブラリ（またはライブラリ）のみです。PCB 2D/3Dコンポーネントモデルおよびシミュレーションモデル/サブサーキットを含むファイルは、プロジェクト内、インストールされたライブラリリスト内のファイル、またはパッケージに指定された検索パス内の任意の有効な検索場所に配置できます。

その後、ライブラリパッケージは単一の統合ライブラリファイル（*.IntLib）にコンパイルされます。

要約すると、統合ライブラリを作成するには、基本的に以下の四つのステップがあります：

1. ソースライブラリパッケージを作成する。
2. 必要なソース回路図ライブラリファイルを作成して追加する。
3. 必要なドメインモデルファイルを作成して追加する（または指定する）。
4. ライブラリパッケージをコンパイルして、統合ライブラリファイルを生成する。

ソースライブラリパッケージの作成

メインメニューからFile » New » Projectコマンドを選択して、新しい統合ライブラリパッケージを作成します。表示されるNew Projectダイアログで、Project TypeをIntegrated Libraryに設定し、プロジェクトの名前と場所を指定します。また、Regular、VCS（バージョン管理）、またはManaged（Altium Vaultインストールの一部として）など、そのタイプに関連するオプションも適用可能な限り指定します。

OKをクリックすると、新しいシェルライブラリパッケージプロジェクトがProjectsパネルに追加されますが、初期状態ではドキュメントは含まれていません。

新しい統合ライブラリパッケージ（*.LibPkg）をNew Projectダイアログを通じて作成する。

ソース回路図ライブラリの作成と追加

必要なコンポーネントを含むソース回路図ライブラリ（*.SchLib）を作成します。各コンポーネントに必要なモデルリンクとパラメトリック情報を追加します。ソース回路図ライブラリを作成する方法は2つあります：

• 最初から、File » New » Library » Schematic Libraryコマンドを使用します。スキーマティックライブラリエディタを使用して新しいコンポーネントを作成するか、他の開いているスキーマティックライブラリからコンポーネントをコピーします。
• プロジェクト内のスキーマティックドキュメントに既に配置されているコンポーネントから、Design » Make Schematic Libraryコマンドを使用します。

ソーススキーマティックライブラリ（またはライブラリ）を準備したら、次の方法のいずれかを使用してライブラリパッケージに追加します：

• Project » Add Existing to Project コマンドを使用します。
• Projectsパネルでライブラリパッケージのエントリを右クリックし、コンテキストメニューからAdd Existing to Projectコマンドを選択します。

ライブラリパッケージに追加されたソースSchLib。

ドメインモデルファイルの作成と追加

スキーマティックコンポーネントによって参照されるモデルを、それぞれのファイル内で作成します。したがって、PCB 2D/3DコンポーネントモデルはPCBライブラリ(*.PcbLib)内、シミュレーションモデルとサブサーキットはそれぞれモデル(*.Mdl)ファイルとサブサーキット(*.Ckt)ファイル内にあります。もちろん、最も重要なモデルはPCB 2D/3Dコンポーネントモデルであり、そのスキーマティックライブラリの対応物と同様に、二つの方法で作成できます：

• 最初から、File » New » Library » PCB Libraryコマンドを使用してください。PCBライブラリエディタを使用して新しい2Dフットプリントを作成し（3Dボディ情報を追加する）、または他の開いているPCBライブラリからコンポーネントをコピーします。
• PCBドキュメントに既に配置されているPCBの2D/3Dコンポーネントモデルから、Design » Make PCB Library コマンドを使用します。

モデルの検索場所を指定する

モデルファイルが定義されたら、必要に応じて簡単に見つけられるようにライブラリパッケージで利用できるようにする必要があります。モデルは（またはリンクされて）回路図のコンポーネントによって参照されることを忘れないでください。Altium Designerには、統合ライブラリパッケージを構築している場合でも、回路図の設計に取り組んでいる場合でも、モデルを利用可能にするための標準システムがあります。モデルを利用可能にする方法は3つあります：

• プロジェクトにライブラリ/モデルを追加する。
• ライブラリ/モデルをインストール済みライブラリリストにインストールする。ここでは、すべての設計プロジェクトで利用可能になります。
• ライブラリ/モデルへの検索パスを定義する。

それぞれに利点があるので、作業方法に最も適した方法を選択してください。異なるモデルは異なるアプローチでより適して動作する場合があります。たとえば、ライブラリパッケージを開いたときに多数のシミュレーションモデルがProjectsパネルにリストされるのを見たくないかもしれませんが、PCB 2D/3Dコンポーネントモデルライブラリを見たい場合があります。この場合、シミュレーションモデルが保存されているフォルダーへの検索パスを定義し、ライブラリパッケージにPCBライブラリを追加します。

これら3つのモデル利用方法は、プロジェクトで利用可能な利用可能なライブラリを形成し、すべてAvailable Librariesダイアログ内から定義できます。これは、Librariesパネルの左上にあるLibrariesボタンをクリックすることでアクセスできます。

Available Librariesダイアログを通じてモデルの利用可能性を定義します。

PCBライブラリ（および必要に応じて他のモデルファイル）は、Add Existing to Projecコマンドを使用して、直接ライブラリパッケージに追加することもできます。このコマンドは、メインのProjectメニュー、またはProjectsパネル内のライブラリパッケージのエントリに関連付けられた右クリックメニューから利用可能です。

ライブラリパッケージに追加されたソースPcbLib。

モデルファイルへの検索パスの定義 - Search PathタブからAvailable Librariesライブラリにアクセスすると、統合ライブラリのオプションダイアログのSearch Pathsタブ（Project » Project Options）が表示されます。必要に応じて一つ以上のパスを追加し、モデルはこれらのパスに沿って上から下へ順に検索されることを覚えておいてください。必要なモデルファイルが実際に見つかっていることを確認するために、Refresh Listボタンをクリックし、必要に応じてパスを調整してください。

必要なPcbLibモデルファイルを見つけるための定義された検索パスの例。

ライブラリパッケージのコンパイル

ソースライブラリがライブラリパッケージに追加され、必要に応じてモデルファイルへのパスが定義された後、パッケージは最終的に統合ライブラリを生成するためにコンパイルされます。他のプロジェクトと同様に、統合ライブラリパッケージのコンパイラは、見つからなかったモデルに関する警告やエラーメッセージのリストを生成します。さらに、実際のフットプリントにはパッドAとKが含まれているのに、パッド1と2へのマッピング命令が間違っているなど、ピンマッピングエラーもチェックできます。

コンパイルを実行する前に、Error ReportingタブのOptions for Integrated Libraryダイアログで、適切にエラー報告条件を確認し設定することが賢明です。

ライブラリパッケージをコンパイルする前に、必要に応じてエラー報告オプションと重大度レベルを設定することが良いアイデアです。

コンパイルを進めるには、 Compile Integrated Libraryコマンドを使用します - メインのProjectメニューから、またはライブラリパッケージのエントリに関連付けられた右クリックメニューから選択します。Projectsパネル。ソースライブラリとモデルファイルは、ソースライブラリパッケージの名前を付けられた統合ライブラリ(<LibraryPackageName>.IntLib)にコンパイルされます。コンパイラは違反をチェックし、見つかったエラーや警告はMessagesパネルにリストされます。ソースライブラリの問題を修正してから、再コンパイルしてください。

統合ライブラリパッケージのコンパイル時にコンパイラによって指摘された例外エラーです。画像にマウスを合わせると、警告やエラーが解決された後の成功したコンパイルの結果を見ることができます。

統合ライブラリは、Optionsタブの統合ライブラリのオプションダイアログで指定された出力フォルダに保存されます（デフォルトではプロジェクトの場所のサブフォルダ：\Project Outputs for <ProjectName>）。これは自動的にインストール済みライブラリリスト（すべてのプロジェクトで利用可能）に追加され、結果としてLibrariesパネルから利用可能になります。 コンパイルされた統合ライブラリはインストール済みライブラリのリストに追加され、Librariesパネルを通じて利用可能になります。

Librariesパネルは、統合ライブラリファイルを直接見ることができる唯一の方法です。統合ライブラリを念頭に置いて特別に作られたこのパネルは、コンポーネント、フットプリント、または3Dモデルで統合ライブラリを閲覧することができます。現在のライブラリフィールドの右にあるボタンをクリックすると、コントロールが表示されます。コンポーネントで閲覧する場合、コンポーネントとモデルの関係が提示されます。

プロジェクトドキュメントからIntLibを作成する

統合ライブラリは、構成するプロジェクトドキュメント（ソースの回路図とPCBドキュメント）から直接作成することもできます。Make Integrated Libraryコマンドを使用してください。このコマンドは、スキーマティックエディタまたはPCBエディタのメインDesignメニューから利用可能です。

このプロセスには主に以下の作業が含まれます：

1. 全てのソース回路図ドキュメントを開き、回路図ライブラリを作成する。
2. PCBドキュメントからPCBライブラリを作成する。
3. これらのライブラリをコンパイルして、プロジェクト名を冠した統合ライブラリ（<ProjectName>.IntLib）にする。

IntLibはプロジェクトに追加され（Libraries\Compiled Librariesの下に）、インストール済みライブラリに追加され、Librariesパネルを通じて利用可能になります。

アクティブな設計プロジェクトの回路図とPCBドキュメントから、統合ライブラリの作成を効率化。

データベースライブラリからIntLibを作成する

関連ページ： データベースライブラリの使用

Altium Designerのデータベースライブラリは、Altium Designerのコンポーネントを会社のデータベースと密接に連携させたい場合に理想的な選択です。設計が会社のサイトを離れる必要がある場合や、デザイナーにセキュアな統合ライブラリから作業してもらいたい場合でも、これを容易に実現できます。Altium Designerは、データベースライブラリ（標準のデータベースライブラリ（DbLib）またはバージョン管理されたSVNデータベースライブラリ（SVNDbLib））から直接統合ライブラリをコンパイルする機能を提供します。この方法により、CADライブラリアンはデータベースライブラリを引き続き使用できる一方で、デザイナーは定期的に再生成される統合ライブラリを使用し、いわば「オフライン」で作業することができます。

変換はOffline Integrated Library Makerウィザードを使用して実行されます。このプロセスは、データベース内の各テーブルごとに行われ、どのテーブルを考慮するかについて完全な制御が可能です。含まれる各テーブルに対して別々の統合ライブラリが生成されます。

データベースライブラリ（DbLibsまたはSVNDbLibs）を「オフライン」統合ライブラリに変換するには、Offline Integrated Library Makerウィザードを使用します。

プロセスには以下のステップが含まれます：

1. 変換したいデータベースライブラリファイル（*.DbLib）またはSVNデータベースライブラリファイル（*.SVNDbLib）をアクティブドキュメントとして開き、メインメニューからTools » Offline Integrated Library Makerコマンドを選択して、Offline Integrated Library Makerウィザードにアクセスします。
2. Library to Convertページを使用して、処理するDbLibまたはSVNDbLibを指定します。ウィザードにアクセスした際のアクティブライブラリがデフォルトで変換するライブラリとして指定されます。必要に応じて、異なるデータベースライブラリを自由に探索し、選択することができます。
3. Optionsページを使用して、リンクされたデータベースのどのテーブルを変換に含めるかを指定します。デフォルトでは、すべてのデータベーステーブルが変換に含まれます。テーブルを除外するには、単にその関連するConvertオプションが無効になっていることを確認します。このウィザードのページでは、生成された統合ライブラリが保存される出力ディレクトリも指定できます。このベースディレクトリへのパスを直接入力するか、またはフィールドの右側にあるアイコンをクリックして、フォルダーを参照ダイアログにアクセスし、必要なディレクトリを探索して選択できます。各含まれるデータベーステーブルの生成された出力（統合ライブラリ）は、指定された出力ディレクトリ内の、テーブルの名前を使用して命名された独自のサブフォルダーに保存されます。
4. データベースライブラリを選択し、必要に応じて関連する変換オプションを設定した後、Nextをクリックして変換を進めます。進行状況バーが表示され、現在変換されているデータベーステーブルの情報が表示されます。変換プロセスは、変換すると指名した各データベーステーブルに対して実行されることを覚えておいてください。以下は、このプロセスの基本的な分解です：
   1. 統合ライブラリパッケージ（*.LibPkg）が作成され、Projectsパネルで開かれます。パッケージはテーブルの名前を使用して命名されます。例えば、テーブル名がCapacitor - Ceramicの場合、Capacitor - Ceramic.LibPkgとなります。
   2. スキーマティックライブラリドキュメントが作成され、LibPkgに追加されます。スキーマティックも再びテーブルの名前を使用して命名されます（例：Capacitor - Ceramic.SchLib）。
   3. テーブルの各レコードが考慮され、適切なAltium Designerコンポーネントが構築されます。これを行うために、参照されたスキーマティックシンボルが適切なソースライブラリから取得され、新しいスキーマティックライブラリドキュメントにコンポーネントとして追加されます。レコードで定義されたパラメータとモデルリンク情報がそのコンポーネントに追加されます。
   4. レコードの参照されたフットプリントモデルが取得され、PCBライブラリドキュメントに追加されます。このドキュメントも再びテーブルの名前を使用して命名されます（例：Capacitor - Ceramic.PcbLib）。その後、PCBライブラリドキュメントがLibPkgに追加されます。
   5. ソースライブラリがDbLibであり、データベースレコードにPCB3Dおよび/またはシミュレーションモデルリンクが定義されている場合、参照されたPCB3DライブラリとシミュレーションモデルファイルもLibPkgに追加されます。そのようなモデルの場所は変更されません。モデルの完全なパスは、対応するモデルリンクの一部として指定されます。
   6. LibPkgはコンパイルされ、統合ライブラリ（例：Capacitor - Ceramic.IntLib）が生成され、その後Altium Designerのインストール済みライブラリに追加されます。

変換プロセスの結果 - 構成要素のシンボルとフットプリントモデルドキュメントを含むライブラリパッケージプロジェクト、およびコンパイルされたIntLibs。これらはインストール済みライブラリとしても追加され、Altium Designer内の全てのPCBデザインプロジェクトで利用可能になります。

Vaultコンポーネント取得を通じたIntLibの作成

関連ページ： コンテンツカートの使用

ローカルのAltium Vaultからコンポーネントを取得し、統合ライブラリ(Integrated Library)に追加することもできます。このような統合ライブラリからコンポーネントを配置すると、実際のリンクはVault内のコンポーネントアイテムに戻ります。これにより、会社のVaultコンポーネントをオフラインで効果的に使用しながら、設計がソースVault内のそれらのコンポーネントと真の接続を維持することを保証します。また、これらのコンポーネントに定義されたサプライチェーン情報が、パート選択リストの使用を通じて引き続き使用されることも保証します。

Content Cartダイアログから、IntLibに取り込むプロセスは以下の通りです：

1. Select target Vaultリンクをクリックし、メニューからIntLibファイルを選択します。

コンテンツカートの対象をIntLibファイルに設定します。

2. 生成されるIntLibファイルの名前と場所を指定します。デフォルトでは、ファイルはIntegrated_Library - <Date> - <Time>.IntLibの形式で命名され、\Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLibの場所に生成されます。必要に応じて、名前を付けて保存ダイアログを開くことでこれを変更できます。このダイアログは、Changeリンクをクリックすることでアクセスできます。

デフォルトのターゲットフォルダを受け入れるか、必要に応じて変更してください。

3. 同じIntLibに追加のコンポーネントを取り込む必要がある場合は、Add More Itemsリンクをクリックし、次に表示されるChoose Itemダイアログを使用して、それらのコンポーネントを選択します。
4. 準備ができたら、Deliver Cartボタンをクリックして、IntLibの生成を進めます。一時的な統合ライブラリパッケージ(*.LibPkg)が作成され、ソースSchLib（シンボル、パラメータ、モデルリンク付き）およびPcbLib（フットプリントモデル付き）ファイルが生成され追加されます。これがコンパイルされてIntLibファイルが生成され、指定されたフォルダに生成されます。情報ダイアログがファイルの生成が成功したことを確認します。

必要な統合ライブラリファイルを含むターゲットフォルダにカートを配送します。

生成後、IntLibはインストール済みライブラリリストに追加されます。これはソフトウェアで利用可能なライブラリの一部であり、Librariesパネルから使用できるようになります。

会社のボールトから取得したコンポーネントを提供する生成されたIntLib。

統合ライブラリからのコンポーネントの配置

統合ライブラリからのコンポーネントの配置は、Librariesパネルから行われます。配置は、統合ライブラリをComponentsビューで閲覧しているときにアクティブな回路図シート上、またはComponentsまたはFootprintsビューで閲覧しているときにアクティブなPCBドキュメント上で行うことができます。配置は以下の方法で実行できます：

• コンポーネントエントリを選択し、Placeボタンをクリックしてから、ワークスペース内で位置を決めてクリックして配置します。
• 必要なコンポーネントをクリックしてドラッグし、ワークスペースにドラッグします。

統合ライブラリからコンポーネントを配置するには、Librariesパネルを使用します。ドラッグアンドドロップは即時に行われますが、単一のコンポーネントインスタンスのみを配置します。配置ボタンを使用すると
配置モードのままになります。

統合ライブラリの修正

統合ライブラリはコンポーネントを配置するために使用され、直接編集することはできません。統合ライブラリを変更するには、まずソースライブラリで変更を行い、その後ライブラリパッケージを再コンパイルして、それらの変更を含む新しい統合ライブラリを生成します。

統合ライブラリを修正するには：

1. 必要な統合ライブラリのソースライブラリパッケージプロジェクトを開きます。
2. 変更を加えるソースの回路図またはモデルライブラリを開きます。
3. 必要に応じて変更を加え、修正されたライブラリを保存して閉じます。
4. ライブラリパッケージを再コンパイルします。新しく生成された統合ライブラリが、古い既存のバージョンと置き換わります。

統合ライブラリの逆コンパイル

統合ライブラリ内のソースライブラリに変更を加える必要があるが、何らかの理由で元のソースライブラリパッケージプロジェクトにアクセスできない場合があります。ここで、単一のポータブルな統合ライブラリファイルの別の側面が役立ちます。統合ライブラリは直接編集することはできませんが、それらを構成するソースシンボルおよびモデルライブラリに逆コンパイルすることができます。

そのためには：

1. 修正が必要なソースライブラリを含む統合ライブラリを開きます。次のいずれかの方法で:
   1. File » Open コマンドを選択し、開くドキュメントを選択 ダイアログで統合ライブラリを探し、Openをクリックします。
   2. WindowsファイルエクスプローラーからIntLibファイルをAltium Designerウィンドウにドラッグアンドドロップします。
2. 表示されるソースの抽出またはインストールダイアログで、Extract Sourcesボタンをクリックします。

ソースの回路図とモデルライブラリは抽出され、元の統合ライブラリが存在するフォルダ内に、統合ライブラリのファイル名にちなんで名付けられた新しいフォルダに保存されます。
ライブラリパッケージ(<IntegratedLibraryFileName>.LibPkg)が作成され、ソースの回路図とPCBライブラリがプロジェクトに追加され、Projectsパネルで表示されます。シミュレーションモデルとサブサーキットファイルは自動的にプロジェクトに追加されません。

統合ライブラリからソースライブラリを抽出し、ライブラリパッケージプロジェクトを生成するための逆コンパイル。