プラグイン パッケージを使用して庭園の歩道プログラムをロードする

プラグイン パッケージは、フォルダ構造と XML ファイルの組み合わせで、カスタム プログラムを AutoCAD の図面環境にロードする場合に使用することができます。

既定では、AutoCAD プログラムを起動すると、ApplicationPlugins と ApplicationAddins の両方のフォルダでプラグイン パッケージがチェックされます。検出されたプラグイン パッケージは、各パッケージの XML ファイル内のメタデータに基づいて自動的にロードされ、登録されます。

プラグイン パッケージのロード動作は、システム変数 APPAUTOLOAD でコントロールします。APPAUTOLOADを 0 (ゼロ)に設定しても、APPAUTOLOADER[アプリケーションの自動ロード]コマンドを使用しない限り、プラグイン パッケージはロードされません。

重要: AutoCAD 2014 ベースの製品から、システム変数 SECURELOAD を 1 または 2 に設定している場合は、カスタム アプリケーションはセキュア モードでのみ機能することになりました。セキュア モードで動作している場合、プログラムはコードを含むファイルを信頼する場所からロードおよび実行するように制限されます。信頼する場所は、システム変数 TRUSTEDPATHS で指定します。

庭園の歩道のプラグイン パッケージのフォルダ構造を定義する

プラグインパッケージのプライマリ定義は、Windows 上の Windows エクスプローラまたはファイル エクスプローラ、またはMac OS 上の Finder でフォルダを作成することによって処理します。プラグイン パッケージの親フォルダまたは最上位フォルダの名前の最後には、ファイル拡張子と同じように、.bundle という接尾辞を付ける必要があります。

ここでは、庭園の歩道プログラムのロードに使用することができるプラグイン パッケージの基本的なフォルダ構造を設定する方法を説明します。

Windows
  1. ワークステーションにインストールされている Windows のバージョンに基づいて、Windows エクスプローラを起動します。次のいずれかの操作を行います。
    • (Windows 7) [スタート]ボタンを右クリックして、[エクスプローラーを開く]を選択します。
    • (Windows 8) [スタート]画面で、file と入力し、[ファイル エクスプローラー]をクリックします。
  2. Windows エクスプローラまたはファイル エクスプローラで、[ドキュメント] (または[マイ ドキュメント])フォルダを参照し、GardenPath をダブルクリックします。
  3. 右側のペインで、空白領域を右クリックして、[新規作成] [フォルダー]の順に選択します。ファイルまたはフォルダを右クリックしないでください。新しいフォルダに GardenPath.bundle という名前を入力し、[Enter]を押します。GardenPath.bundle フォルダをダブルクリックして、現在のフォルダにします。
  4. 右側のペインで、右クリックして、[新規作成] [フォルダー]を選択します。新しいフォルダに LSP という名前を入力し、[Enter]を押します。
  5. Gardenpath フォルダに戻ります。
  6. [Ctrl]を押したまま、gpmain.lsp、gpdraw.lsp、gp-io.lsp、utils.lsp を選択します。選択したファイルのいずれかを右クリックして、[コピー]を選択します。
  7. GardenPath.bundle フォルダをダブルクリックし、次に LSP フォルダをダブルクリックします。
  8. 右側のペインで、空白部分を右クリックして、[貼り付け]を選択します。
Mac OS
  1. [Finder]で、Mac OS のメニュー バーから[移動]メニュー [書類]を選択します。
  2. [Finder]ウィンドウの一番上で、[設定] (歯車アイコン) [新規フォルダ]をクリックします。新しいフォルダに GardenPath.bundle という名前を入力し、[Enter]を押します。
  3. .bundle 拡張子を使用するよう求めるプロンプトが表示された場合は、[追加]をクリックします。
  4. GardenPath.bundle フォルダをセカンダリ クリックし、[パッケージの内容を表示]をクリックします。
  5. 再度、[設定] (歯車アイコン) [新規フォルダ]をクリックします。新しいフォルダに LSP という名前を入力し、[Enter]を押します。
  6. Gardenpath フォルダに戻ります。
  7. [Command]を押したまま、gpmain.lsp、gpdraw.lsp、gp-io.lsp、utils.lsp を選択します。選択したファイルの 1 つをセカンダリ クリックし、[コピー]を 4 回クリックします。
  8. GardenPath.bundle フォルダをセカンダリ クリックし、[パッケージの内容を表示]をクリックします。
  9. LSP フォルダをダブルクリックします。
  10. 右側のペインで、空白領域をセカンダリ クリックし、[4 つの項目をペースト]をクリックしす。

庭園の歩道のプラグイン パッケージの XML ファイルを作成する

プラグイン パッケージの編成には、親フォルダの名前と親フォルダより下位のファイル構造が重要ですが、一方で、プラグイン パッケージの packagecontents.xml ファイルは、プラグイン パッケージ内のファイルのロード方法とプラグイン パッケージ内のファイルの目的を AutoCAD プログラムに対して記述します。

ここでは、庭園の歩道プログラムのロードに使用することができる基本的な packagecontents.xml ファイルを定義する方法を説明します。

Windows
  1. 次のいずれかの操作を行います。
    • (Windows 7) [スタート]ボタン [すべてのプログラム] [アクセサリ] [メモ帳]をクリックします。
    • (Windows 8) [スタート]画面で、note と入力し、[メモ帳]をクリックします。
  2. メモ帳で、[ファイル]メニュー [名前を付けて保存]を選択します。
  3. [名前を付けて保存]ダイアログ ボックスで、[ドキュメント] (または[マイ ドキュメント])フォルダを参照します。GardenPath フォルダをダブルクリックし、次に GardenPath.bundle フォルダをダブルクリックして、現在のフォルダとなるようにします。
  4. [ファイル名]テキスト ボックスに、packagecontents.xml と入力します。
  5. [ファイルの種類]ドロップダウン リストをクリックし、[すべてのファイル(*.*)]を選択します。
  6. [文字コード]ドロップダウン リストをクリックし、[ANSI]を選択します。[保存]をクリックします。
  7. エディタ領域で、次のように入力します。 
    <?xml version="1.0" encoding="utf-8"?>
<ApplicationPackage
    SchemaVersion="1.0"
    AppVersion="1.0"
    Name="Garden Path"
    Description="AutoLISP Garden Path tutorial"
    Author="Autodesk, Inc"
    ProductCode="{3f81a8e2-2863-4caf-ba4a-3b25b2e008b6}"
>

  <CompanyDetails
     Name="Autodesk, Inc"
     Url="http://www.autodesk.com"
  />

  <RuntimeRequirements
     OS="Win32|Win64|Mac"
     SeriesMin="R19.0"
     Platform="AutoCAD*"
  />

  <Components Description="All supported operating systems">
    <RuntimeRequirements 
       OS="Win32|Win64|Mac"
       SeriesMin="R19.0"
       Platform="AutoCAD*"
    />
    <ComponentEntry Description="Garden Path (Main) LSP file."
       AppName="GardenPathMain"
       Version="1.0"
       ModuleName="./LSP/gpmain.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Garden Path (Draw) LSP file."
       AppName="GardenPathDraw"
       Version="1.0"
       ModuleName="./LSP/gpdraw.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Garden Path (Input) LSP file."
       AppName="GardenPathInput"
       Version="1.0"
       ModuleName="./LSP/gp-io.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Utility LSP file"
       AppName="UtilityFunctions"
       Version="1.0"
       ModuleName="./LSP/utils.lsp">
    </ComponentEntry>
  </Components>
</ApplicationPackage>
  8. [ファイル]メニュー [上書き保存]を選択します。
  9. メモ帳を閉じます。
Mac OS
  1. [Finder]で、Mac OS のメニュー バーから[移動]メニュー [アプリケーション]を選択します。
  2. [アプリケーション]ウィンドウで、[テキストエディット]をダブルクリックします。
  3. テキストエディットで、Mac OS のメニュー バーから[テキストエディット]メニュー [環境設定]を選択します。
  4. [環境設定]ダイアログ ボックスで、次の操作を行います。
    • [標準テキスト]をオンにします。
    • [スマート引用符]オプションをオフにします。
    • [スマート ダッシュ記号]オプションをオフにします。
    • [スマート リンク]オプションをオフにします。
    • [閉じる]ボタンをクリックします。
  5. Mac OS のメニュー バーから[ファイル]メニュー [保存]を選択します。
  6. [名称未設定]ダイアログ ボックスで、[書類]フォルダに移動し、GardenPath フォルダを選択して現在のフォルダにします。
  7. [別名で保存]テキスト ボックスに、packagecontents.xml と入力します。[保存]をクリックします。
  8. ファイル拡張子 .xml を使用するように求めるプロンプトが表示されたら、[.XML を使用]をクリックします。
  9. エディタ領域で、次のように入力します。 
    <?xml version="1.0" encoding="utf-8"?>
<ApplicationPackage
    SchemaVersion="1.0"
    AppVersion="1.0"
    Name="Garden Path"
    Description="AutoLISP Garden Path tutorial"
    Author="Autodesk, Inc"
    ProductCode="{3f81a8e2-2863-4caf-ba4a-3b25b2e008b6}"
>

  <CompanyDetails
     Name="Autodesk, Inc"
     Url="http://www.autodesk.com"
  />

  <Components Description="All supported operating systems">
    <RuntimeRequirements 
       OS="Win32|Win64|Mac"
       SeriesMin="R19.0"
       Platform="AutoCAD*"
    />
    <ComponentEntry Description="Garden Path (Main) LSP file."
       AppName="GardenPathMain"
       Version="1.0"
       ModuleName="./LSP/gpmain.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Garden Path (Draw) LSP file."
       AppName="GardenPathDraw"
       Version="1.0"
       ModuleName="./LSP/gpdraw.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Garden Path (Input) LSP file."
       AppName="GardenPathInput"
       Version="1.0"
       ModuleName="./LSP/gp-io.lsp">
    </ComponentEntry>
    <ComponentEntry Description="Utility LSP file"
       AppName="UtilityFunctions"
       Version="1.0"
       ModuleName="./LSP/utils.lsp">
    </ComponentEntry>
  </Components>
</ApplicationPackage>
  10. Mac OS のメニュー バーから[ファイル]メニュー [保存]を選択します。
  11. テキストエディットを閉じます。
  12. [Finder]で、Mac OS のメニュー バーから[移動]メニュー [書類]を選択します。
  13. Gardenpath フォルダを参照します。
  14. packagecontents.xml を選択します。選択したファイルにカーソルを合わせてセカンダリ クリックし、["packagecontents.xml" をコピー]をクリックします。
  15. GardenPath.bundle フォルダをセカンダリ クリックし、[パッケージの内容を表示]をクリックします。
  16. 右側のペインで、空白領域をセカンダリ クリックし、[項目をペースト]をクリックします。

庭園の歩道のプラグイン パッケージを配置する

プラグイン パッケージを定義したら、ローカル ワークステーションの ApplicationPlugins フォルダまたは ApplicationAddins フォルダにコピーする必要があります。このフォルダの場所は、ワークステーションにインストールされているオペレーティング システムによって変わります。フォルダの場所は、次の場所のいずれかになります。

すべてのユーザ プロファイル フォルダ
  • Windows 7 と Windows 8: %ALLUSERSPROFILE%¥Autodesk¥ApplicationPlugins
  • Mac OS: /Applications/Autodesk/ApplicationAddins
ユーザ プロファイル フォルダ
  • Windows 7 と Windows 8: %APPDATA%¥Autodesk¥ApplicationPlugins
  • Mac OS: ~/Autodesk/ApplicationAddins

ここでは、GardenPath.bundle プラグイン バンドルを配置し、これが AutoCAD の作図環境にロードされたことをテストする方法を説明します。

Windows
  1. ワークステーションにインストールされている Windows のバージョンに基づいて、Windows エクスプローラを起動します。次のいずれかの操作を行います。
    • (Windows 7) [スタート]ボタンを右クリックして、[エクスプローラーを開く]を選択します。
    • (Windows 8) [スタート]画面で、file と入力し、[ファイル エクスプローラー]をクリックします。
  2. Windows エクスプローラまたはファイル エクスプローラで、[ドキュメント] (または[マイ ドキュメント])フォルダを参照します。GardenPath フォルダをダブルクリックします。
  3. 右側のペインで、GardenPath.bundle フォルダを選択し、右クリックします。[コピー]を選択します。
  4. Windows エクスプローラまたはファイル エクスプローラの一番上の方にあるアドレス バーに、次のように入力して[Enter]を押します。

    %ALLUSERSPROFILE%¥Autodesk¥ApplicationPlugins

  5. 右側のペインで、空白部分を右クリックして、[貼り付け]を選択します。
  6. AutoCAD を起動します。
  7. コマンド プロンプトに対して、gardenpath と入力します。
    注: 関数が起動されない場合は、正しい名前を入力していることおよび GardenPath.bundle が正しいフォルダに配置されていることを確認します。問題が解決しない場合は、システム変数 APPAUTOLOAD の値をチェックします。0 (ゼロ)の値は、プラグイン バンドルのロードを無効にします。APPAUTOLOAD の既定値は 14 です。
  8. gardenpath 関数によって表示されたプロンプトを完了します。
Mac OS
  1. [Finder]で、Mac OS のメニュー バーから[移動]メニュー [書類]を選択します。
  2. GardenPath フォルダをダブルクリックします。
  3. 右側のペインで、GardenPath.bundle を選択し、セカンダリ クリックします。["GardenPath.bundle" をコピー]をクリックします。
  4. [Finder]で、Mac OS のメニュー バーから[移動]メニュー [フォルダへ移動]を選択します。
  5. [フォルダへ移動]ダイアログ ボックスに次のように入力し、[移動]をクリックします。

    /Applications/Autodesk/ApplicationAddins

  6. 右側のペインで、空白領域を右クリックして、[項目をペースト]を選択します。
  7. AutoCAD を起動します。
  8. コマンド プロンプトに対して、gardenpath と入力します。
    注: 関数が起動されない場合は、正しい名前を入力していることおよび GardenPath.bundle が正しいフォルダに配置されていることを確認します。問題が解決しない場合は、システム変数 APPAUTOLOAD の値をチェックします。0 (ゼロ)の値は、プラグイン バンドルのロードを無効にします。APPAUTOLOAD の既定値は 14 です。
  9. gardenpath 関数によって表示されたプロンプトを完了します。
親トピック: チュートリアル: 庭園の歩道プログラムを配置する(AutoLISP)
前のトピック: acaddoc.lsp ファイルを使用して LSP ファイルをロードする