Altium DXP 開発者
このテキストには翻訳する内容が含まれていません。
ソフトウェアの拡張機能を使用することで、Altium Designerの拡張可能なアーキテクチャは柔軟なインストール方法を提供し、将来の開発に向けた開かれた、モジュラーな道を提供します。Altium Designerの拡張機能は、Altium Designerの機能をカスタマイズし、拡張するために、特定のソフトウェアパッケージの適用によってインストールされます。これらは、Altium DesignerのExtensions & Updatesインターフェースを通じてインストールされます。
Altium拡張機能のインストールと管理についての詳細情報は、Altium Designerの拡張をご覧ください。
Altium DXP Developer拡張機能は、このアプローチをさらに進め、Altium Designer用の独自のカスタム拡張機能を開発、インストール、配布するために必要なソフトウェアフレームワークとリソースを提供します。
Altium DXP Developer自体もAltium Designerのための拡張機能として配布されています。実際には、拡張機能を作成するための拡張機能です。インストールされると、Altium DXP Developer拡張機能はいくつかの部分で構成されています：
- DXPデベロッパーインターフェース – カスタム拡張機能の管理、編集、インストール、および公開（配布）のための機能的なユーザーインターフェース。
- Altium ソフトウェア開発キット（SDK） – Altium Designer 拡張機能を開発するための、複数のプログラミング言語でのアプリケーションプログラミングインターフェース（API）ソースファイル。
- ソフトウェアテンプレート – 新しい拡張機能を作成するための基本的なソフトウェア構造
- 拡張プロジェクトの例 – Altium Designer 拡張機能の開発構造と能力を示すために作成された多数のソフトウェア拡張プロジェクト。
Altium DXP Developer 拡張機能のインストール
Altium DXP Developer 拡張機能は、Altium Designer の拡張機能管理インターフェースを通じてインストールされます。これは、Altium Designer ホームページのAdminビューからアクセスするか、DXPメニューから拡張機能と更新オプションを選択することでアクセスできます (
)。
Purchasedタブを選択し、ギャラリーのソフトウェア拡張セクションでAltium Developerエントリを見つけ、その
アイコンをクリックしてインストールします。
PurchasedタブからAltium Developer拡張機能をExtensions & Updatesインターフェースでインストールしてください。
成功裏にインストール後、Altium DXP Developer拡張機能はExtensions & Updatesページの「インストール済み」タブの下に表示されるはずです。
Extensions & UpdatesページのInstalledタブで、拡張機能のインストールが成功したかを確認します。
新しいExtensionプロジェクトの作成
DXP Developer 拡張機能は、Altium DesignerでExtension Publishing Documentと呼ばれる新しいファイルタイプを実装しており、*.EPDファイルとして保存されます。これは、製品名、バージョン、長い説明と短い説明、アイコンのサムネイル、ライセンス情報など、拡張機能の公開設定の詳細と製品関連情報を指定する、直感的なXMLタイプのファイルです。
新しいソフトウェア拡張プロジェクトを開始するには、Altium DesignerでFile » New » Otherを選択し、Extensionオプションを選択して新しいEPDファイルを開きます。これにより、新規拡張機能ダイアログが開き、拡張機能の名前、プロジェクトフォルダ、およびプログラミング設定が指定されます。
新しい拡張機能プロジェクトのID/パスと開発言語のタイプ/バージョンを指定して、拡張機能の構造を実装します。
Altium SDKには、Embarcadero Delphi®、Microsoft C#（Cシャープ）、およびC++（Cpp）開発言語のAPIソースファイルと例示プロジェクトが含まれていることに注意してください。
新しい拡張機能ダイアログの情報を入力して閉じると、DXP 開発者インターフェースが開き、新しい拡張機能の設定（左側のペイン）と公開データの入力フィールド（右側のペイン）が表示されます。
Altium Designerのカスタム拡張機能のためのEPDファイルエディタ、設定ファイルエディタ、ソフトウェア拡張インストーラ、および安全なファイル配布機能を提供するDXP Developerインターフェース。
Altium DXP Developerインターフェースは、拡張プロジェクトを作成し、より広範囲に配布する準備をするための中心的なポイントです。EPDドキュメントエディタとして機能するだけでなく、以下のコマンド機能も提供します：
- プロジェクトを開く - 現在の拡張プロジェクトに設定された開発環境（IDE）を起動します。通常はEmbarcadero DelphiまたはMicrosoft Visual Studioです。
- 拡張機能のインストール/更新 - Altium Designerに拡張機能をインストールするか、既存の拡張機能のインストールを更新します。
- ソースコードの更新 - EPDドキュメントが保存されたときに、INSエディターとRCSエディターパネルのコードをプロジェクトソースロケーションのインストールフォルダ内のそれぞれの設定ファイル（*.ins および *.rcs）に保存します。
- 拡張機能の公開 - 拡張機能とその関連ファイルをターゲットのVaultリポジトリにアップロードします。
コーディング
新しい拡張機能公開ドキュメント（EPD）がAltium DXP Developerで開かれると、選択された言語とIDEバージョンに適したプログラミングプロジェクト構造とIDEプロジェクトファイルが自動的に作成されます。事前に設定された開発者テンプレートから抽出されたファイルとフォルダは、拡張機能プロジェクトのソースフォルダ（例：C:\Users\Public\Documents\Altium\AD14\Extensions\MyExtension）に存在し、新しい拡張機能のコーディングに便利で構造化されたフレームワークを提供します。
新しい拡張機能の機能をコーディングを始めるには、Open Projectコマンドリンクで関連するIDEを起動します。
Open Projectコマンドリンクで関連するプログラミング言語のIDEを起動します。
DXP Developerインターフェースとそのプログラミングテンプレートと共に、DXP Developer拡張機能のインストールは、各プログラミング言語のSDKソースコードファイルと例示プロジェクトも追加します。これらのSDKリソースは、C:\ProgramData\Altium\Altium Designer {*GUID*}\Extensions\Altium Developer\SDKフォルダにあります。各言語バリアントのExamplesフォルダには、独自のAltium Designer拡張機能を開発するためのプログラミング参照とガイドを提供するための多数の拡張プロジェクトが含まれています。
言語ソースファイルの場合、これらはIDEプロジェクト内で正しく参照されている必要があります。確認するには、プロジェクトのビルドオプションを開きます（Delphiでは：Project » Options » Delphi Compiler）し、検索パスに適切なSDKソースフォルダが含まれていることを確認します。
また、拡張機能のコンパイルされたDLL出力のターゲットフォルダにも注意してください。Delphiの場合、これはオプションダイアログのOutput Directoryパスエントリです。ターゲットパスは、Altium Designerのメイン拡張フォルダ内の対応するプロジェクトフォルダを指すべきです。例えば、C:\ProgramData\Altium\Altium Designer {*GUID*}\Extensions\MyExtensionのように、上記で述べたように、このフォルダは新しいEPDドキュメントが開発者インターフェースで開かれたときに作成されます。
拡張機能のプロジェクトコードがコンパイルされると、IDEは結果として得られるDLL（例：MyExtension.dll）を対応するフォルダ（\Extensions\MyExtension）に配置します。その結果、Altium Designerは起動時に新しい拡張機能フォルダとその内容を検出して対応します。
Delphiでは、出力DLLの参照を右クリックするか、Projectメニューを使用してコンパイルコマンドとオプション設定ダイアログにアクセスします。
コードをコンパイルしてから、Altium Designerを再起動して新しい拡張機能プロジェクトとその機能を読み込みます。
拡張機能のインストールと更新
DXP Developerインターフェースの拡張機能インストール機能は、基本的に、システムの拡張機能レジストリ - C:\ProgramData\Altium\Altium Designer {*GUID*}\Extensions\ExtensionsRegistry.xml に一致するエントリを挿入することで、拡張プロジェクトをAltium Designerに登録します。
このプロセスは、新しいEPDファイルをDXP Developerインターフェースで開いて新しい拡張プロジェクトを定義する際に、プロジェクト構造の作成と共に自動的に開始されます。その結果、開発者のインストールコマンドはUpdate Local Installationに設定され、Install Extensionとは対照的になります。
拡張機能の開発プロセス中には、Update Local Installationコマンドを使用して、Altium Designer内の拡張機能の設定とファイルを更新できます。拡張機能コードの機能を完全にテストするには、コードプロジェクトを再コンパイルして、対応するAltium Designerの拡張フォルダ内のDLLを更新する必要があります。
Altium Designerでローカルインストールを更新コマンドリンクを使用して、拡張機能のインストールを更新します。
既存の拡張機能プロジェクトをインストールまたは編集するには、Altium Designerのメインメニューから関連するEPDファイルを開きます - File » Open。ファイルタイプのドロップダウンメニューからExtension Publisherファイル (*.EPD)を選択し、プロジェクトのEPDドキュメントを参照して選択します。これにより、拡張エディタとしてDXP Developerインターフェースで開きます。拡張機能がまだインストールされていない場合は、Install ExtensionコマンドをクリックしてAltium Designerに登録し、そのIDEでプロジェクトを再コンパイルできます - IDEを開始するにはOpen Projectをクリックし、その後コードをコンパイルします。
既存の拡張機能プロジェクトは、そのEPDドキュメントを読み込んで、DXP DeveloperインターフェースのInstall ExtensionコマンドをクリックすることでAltium Designerにインストールできます。
Altium Designerで拡張プロジェクトがインストールされているかを確認するには、Extensions & Updatesページに移動し、Installedタブを選択します。拡張プロジェクトはインストールされていることが視覚的に示され、その名前をクリックすることで選択できるはずです。
Altium DesignerでExtensions & Updates（拡張機能と更新）ページを通じて、インストール済みのDXP Developer拡張プロジェクトを管理できます。
Altium Designerの他の拡張機能と同様に、カスタム拡張機能は、関連するアンインストールアイコン（
）をクリックするか、選択されている場合はRemoveボタンをクリックすることで削除できます。Altium Designerを再起動するまでプロセスは完了しないことに再度注意してください。
関連するアイコンを使用してアンインストールするか、その詳細が開かれている場合（拡張機能名をクリックすると）、削除ボタンをクリックします。
エクステンションのソースファイルを更新する
DXP Developer インターフェースでまとめられたAltium Designerエクステンションプロジェクトの構成要素は、異なる状況で異なるプロセスによって編集および保存されます。より具体的には：
- プログラミングコードベース – 対応するIDEで編集、保存、再コンパイルされます。
- エクステンション公開ドキュメント (EPD) – DXP Developerのエクステンションエディターインターフェースで作成、編集、保存されます。
- エクステンションのインストールおよびリソースファイル (*.ins および *.rcs) – 任意のテキストエディターで作成および編集できます、または以下に詳述されています。
拡張機能の設定（インストール/リソース）ファイルを扱う作業を効率化するために、Altium DXP Developer インターフェースは、インストールファイル(*.ins)とリソースファイル(*.rcs)の両方に対するプログラミングウィンドウを提供します。これらのファイルは、プログラミングコードと同様に、EPDファイル自体とは独立しているため、独自の編集/保存プロセスが必要です。
DXP Developer インターフェースは、外部エディタに移動する必要なく、この作業を処理します。Update Source Codコマンドをクリックすると、エディタウィンドウの内容がプロジェクトソースフォルダ内の対応するINSおよびRCS設定ファイルに保存され、その過程で現在のEPDドキュメントの保存を促されます。
プロジェクトフォルダーから取得した拡張機能の設定ファイルがDXP Developerインターフェースエディターパネルに読み込まれ、編集や保存が可能です。
保存されると、設定ファイルの変更はプロジェクトソースフォルダーに更新されますが、Update local Installationコマンドで拡張機能のインストールが更新されるまでAltium Designerには実装されません。これにより、適切なファイルと設定がAltium Designerの拡張機能の場所 - C:\ProgramData\Altium\Altium Designer {*GUID*}\Extensionsに更新されます。
拡張機能を公開する
拡張プロジェクトは、Publish Extensionコマンドリンクを使用して、Altium Globalリポジトリに公開することができます。
拡張機能は、対象ユーザーベースにライセンス配布するために、Altium Global拡張機能リポジトリに公開（アップロード）することができます。
この操作は、拡張機能をパッケージとしてクラウドベースのボールトリポジトリにアップロードし、https://apps.live.altium.com でアクセスできる AltiumLiveのPartner Dashboardを通じて利用できます。ダッシュボードは、会社のグループ内の他の登録ユーザーなど、新しい拡張機能を公開し、必要に応じて拡張機能の配布とライセンス付与を管理します。
パートナーダッシュボードにリストされている拡張機能をクリックすると、その詳細情報が表示され、ライセンスと配布のオプションが公開されます。
パートナーダッシュボードのLicensesとDistributionモードは、拡張ライセンスの作成と適用、登録ユーザーへの拡張の配布を管理する機能を提供します。最終的に、開発者の拡張機能をライセンス付き、文書化されたバージョンとして選択した対象者に配布でき、要求に応じてインストールおよび更新が可能になります。
特定の拡張機能を選択すると、ライセンスタイプ（オンデマンド、スタンドアロンなど）を割り当て、ライセンスを作成できます（それぞれLicensing OptionsとLicensesタブの下で）。拡張機能の特定の配布設定を作成するには、Distributionsタブを選択します。
特定の拡張機能に対してライセンス（左）と配布（右）オプションを設定して適用します。
公開済み拡張機能の更新
拡張機能が公開されると、ローカルのDXP Developerインターフェースでいくつかの更新機能が有効になります。
基本と説明の更新コマンド
- 基本情報の更新 - ベース設定の変更を実装するため、例えばPublicからUse Licenseにライセンスモードオプションを変更し、パートナーダッシュボードで作成した対応するライセンスを割り当てる。
- 拡張機能の更新 - 公開された拡張製品の説明情報を更新する。
バージョン更新コマンド
- バージョンを提出する – 拡張機能のライフサイクル状態を開発中から提出に更新し、その後レビュー状態、そして公開状態へと移行する前の手続き。
- 新しいバージョンを公開する – 公開された拡張機能の新しく作成されたバージョンを、バージョン番号の増分によって定義されるようにアップロードする。
公開された拡張機能への更新結果は、パートナーダッシュボードのサマリーで確認できます。
ダッシュボードに表示される公開された拡張機能のバージョン、ライセンス設定、およびライフサイクル状態の更新.