アドインクリエーター
アドインクリエータを使うと、RoboDK アドインパッケージを簡単に作成したり変更したりすることができます。アドインクリエータはアドインマネージャの一部です。
Add-in Creatorは、Tools-Add-in Managerを選択し、Add-in Managerの下部にあるCreate Add-inボタンをクリックすることで開くことができます。
Add-in Creatorウィザードを開くと、以下のオプションを選択できます：
●新規アドインをゼロから作成: 新しい RoboDK パッケージ (RDKP ファイル) が作成されます。
●フォルダまたはレガシーアプリケーションから新規アドインを作成: この場合、アドインのファイルがあるフォルダへのパスを指定します。パッケージを作成しないオプションを使うと、RoboDK パッケージ(RDKP ファイル)を作成せずに、アドインがあるフォルダで直接アドインを編集することができます。
●既存のアドインを修正する: 既存の RoboDK パッケージを開いて修正し、新しいアドインを作成します。
アドインの作成と編集
タイプ、名前、作者情報などの基本情報を入力することで、簡単に新しいAdd-inを作成できます。
Add-on Creator ウィンドウでは、必須フィールドが太字で表示されます。全部で5つあります：
1.タイプアプリ、ロボットドライバ、言語など、Add-inのタイプです。
2.名前：アドインの名前。
3.固有の識別子: この特定のアドインに属する固有の識別子です。このフィールドの隣にあるチェックボックスをオンにすると、編集モードが有効になり、任意の識別子を設定することができます。
注：domain.company.type.nameの形式で記述された一意の識別子を使用することをお勧めします。別の形式の識別子を使用することも可能ですが、推奨される形式に従うことをお勧めします。
4.バージョン：バージョンはセマンティックバージョン形式(major.minor.patch)で記述します。
5.リビジョン：アドインの変更回数で、1以上の数値をとります。
残りのフィールドはオプションですが、アドインをより正確に説明することができます：
6.著者：著者の姓名、または会社名やチーム名（複数の著者がいる場合）。
7.会社名会社名
8.言語：アドインで使用される言語。IETF BCP 47標準のすべての言語がリストされています。
9.コンテンツのステータス：最終、内部テスト、ベータなど、アドインのステータス。
10.説明アドインの簡単な説明。
11.修正者：このフィールドは、誰かが他の作者のアドインを修正し、その修正の作者として言及されたい場合に使用できます。
12.作成日：アドインの最初のバージョンの作成日（自動的に入力されます）。
13.変更日：アドインの変更日（自動的に入力されます）。
14.電子メール販売、サポート、フィードバックのための電子メールアドレス。
15.ウェブサイト貴社（Add-inの開発者）のウェブサイト。
16.ドキュメントリンク：Add-inのドキュメントへのリンクです。
17.リポジトリリンク：オープンソースのAdd-inの場合、GitHubリポジトリやその他の公開リポジトリへのリンク。
18.キーワード：アドインマーケットプレイスでアドインを検索しやすくするためのキーワード（タグ）のリストです。
アドインにアセットを追加する
アドインには、1つ以上のアセットが含まれている必要があります。アセットとは、アドインのアクションを定義するスクリプトやアイコンのことです。
Add-in Assets] ページは、3 つの機能エリアに分かれています：
1.パッケージアイコン選択エリア。
2.ファイルツリー領域。
3.ファイル内容のプレビューエリア
このページのボタンとチェックボックスの目的：
●TargetPath：TargetPath: ターゲットパス] ボタンをクリックすると、現在のアイコンファイルのプロパティウィンドウが開き、ターゲットプロパティを設定できます（パッケージ内部の対応するセクションを参照してください）。
●アイコンの変更...ボタンで、現在のパッケージアイコンを新しいものに置き換えることができます。
●アイコンの削除]ボタンは、パッケージの現在のアイコンを削除し、作成されるパッケージのタイプに対応するデフォルトのアイコンを設定します。
●新規フォルダ］ボタンは、ファイルツリーの選択したブランチに新しいサブフォルダを作成します。
●Add Asset...ボタンは、ファイルツリーの選択したブランチに新しいファイルを追加します。
●削除] ボタンは、ロックされている項目を除き、選択した項目をファイルツリーから削除します。
●Make Python Packageチェックボックスは、Pythonインタプリタがプロジェクトのファイルを外部ロード可能なモジュールとして使用できるように、__init__.pyファイルをプロジェクトに追加します。
注: このオプションは、Appタイプのアドインを作成する場合にのみ表示されます。
Python スクリプトは、後で .pyc 拡張子を持つファイルにコンパイルするためにマークアップすることができます。コンパイルのプロセスはウィザードの次のページに表示されます。
Target Pathフィールドでは、各ファイルのターゲットプロパティを設定することができます。これは、必要なパスと変数名を入力して手動で行うか、ターゲット・パスの歯車ボタンをクリックしてプロパティ・ウィンドウを起動することで行うことができます：
ファイルプロパティダイアログボックスでは、ターゲット プロパティの値を設定し、使用可能な変数の便利なリストを提供します。また、ファイルがデプロイされるターゲットプラットフォームのパラメータ（OSタイプとバージョン、CPUモデル）を定義することもできます。
Python スクリプトのコンパイル
Add-in アセットの追加時に Python スクリプトが 1 つでも選択されていれば、Python Compilation ページが開きます。
コンパイルは、利用可能なすべての Python インタプリタによって実行されます。利用可能で使用されるインタプリタのリストは Add-in Manager Settings ウィンドウで編集できます。コンパイルプロセス自体はユーザーの介入を必要とせず、ページには潜在的な問題を発見するための詳細なコンパイルログが表示されます。
重要: スクリプトをコンパイルすることで、アプリケーションのソースコードを簡単に難読化することができます。しかし、知的財産を適切に保護することを心配するのであれば、 Python スクリプトから pyd や実行可能ファイルを作成する Cython のような他のコンパイル方法を使うことを検討すべきです。カスタム実行ファイルをアクションとして使うこともできます。
アプリの設定
アプリの設定ページでは、作成したアクションやスクリプトを RoboDK ユーザーインターフェース (メニューやツールバー) からどのようにリンクさせるかをカスタマイズすることができます。App 設定ウィンドウは App タイプの Add-in を作成する場合に表示されます。
このページのパラメータは、AppConfig.iniファイルの内容を定義します。設定可能なキーと値はこのページに記載されています。RoboDKではアプリごとにメニューとツールバーがあります。メニュー項目やツールバーのボタンはアプリ用語でアクションと呼ばれます。アクションを表示するための条件や、メニュー内での順番、ホットキーの割り当てなどを定義することができます。
パラメータの基本セットは以下の通り：
●メニュー名：RoboDKのメインメニューの項目名です。
●表示します：このチェックボックスをオフにすると、RoboDKのメインメニューにメニューが表示されなくなります。
●親メニュー：アプリの子メニューを作成するメインメニュー項目を選択するか、新しいメインメニュー項目を作成する場合はMainを選択します。
●優先順位：他のAppのメニューに対して、このAppのメニューの表示順を決める優先順位を設定します（低い方が先に表示されます）。
●ツールバーエリアアプリのツールバーを配置する RoboDK メインウィンドウ上の位置（側面）。
●ツールバーのスケールRoboDK ツールバーアイコンの現在のサイズに対する比率です。
●コマンドアドインが有効化されたときに実行される RoboDK API コマンドです。
AppConfig.ini ファイルと同じフォルダにある Python スクリプトごとにアクションが作成されます。スクリプトが補助的な性質のものである場合、Visible プロパティを使用してそのようなアクションを抑制できます。
アクションプロパティは以下のリストで表されます：
●名前：メニューやツールバーに表示されるアクションの名前。
●説明: メニューアイテムやツールバーボタンの上にマウスポインタを置いた時のツールチップのテキスト。
●優先順位：このAppの他のアクションとの関係でアクションが表示される順序（低い方が先に表示されます）。
●ショートカット
●可視
●開発者専用: このアクションはRoboDKを開発者モード(Ctrl+Alt+Shift+G)に切り替えた場合にのみ表示されます。
●メニューに表示
●ツールバーに表示
●チェック可能：チェック可能なアクションを作成します。チェック可能なアクションは数字でグループ化することもできます。
●コンテキストメニューフィルター: RoboDKツリーの要素の種類を定義します。
●ダブルクリックフィルタ: ダブルクリック時にこのアクションを呼び出す RoboDK ツリーの要素の種類を定義します。
アドインパッケージの作成
RDKパッケージをRDKPファイルとしてビルドすることで、アドインの作成は完了します。これがアドイン作成の最終ステップです。
パッケージを作成する直前の最終段階で、以下のオプションが利用できます：
●パッケージの暗号化：ファイルを暗号化することで、脅威検出システムを回避して簡単に電子メールで送信できるようにします（Googleメールサービスは、添付ファイル内の実行可能ファイルやPythonスクリプトの転送を直接禁止しています）。
●ビルド後にインストール: Add-in Managerに新しく作成したパッケージをインストールさせます。
●包含フォルダを開く：パッケージが作成されたフォルダを開きます。
