IDE へのプロジェクトのインポート

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。

プロジェクトの JAR ファイルまたはフォルダーを IDE のワークスペースにインポートします。 プロジェクトディレクトリには、インテグレーションまたは実装用の Mule アプリケーションが含まれます。

インポートの問題が発生する場合は、「Anypoint Code Builder リリースノート」の​「Known Issues (既知の問題)」​またはトラブルシューティングで回避策を確認してください。

アプリケーションからのリソースでプロジェクトをパッケージ化している JAR ファイルを​エクスポート​するには、Mule プロジェクトのエクスポートを参照してください。

始める前に

  • Web またはデスクトップ IDE をセットアップしてアクセスします​。

  • IDE で開いているプロジェクトをすべて閉じます。

    手順を表示
    • デスクトップ IDE で、​[File (ファイル)]​ > ​[Close Folder (フォルダーを閉じる)]​ を選択する。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[File (ファイル)]​ > ​[Close Folder (フォルダーを閉じる)]​ を選択する。

    別のプロジェクトフォルダー内でプロジェクトフォルダーを開いたり、展開したりしないでください。

デスクトップ IDE にプロジェクトをインポートして開く

デスクトップ IDE を使用してプロジェクトディレクトリまたは共有可能な JAR ファイルをプロジェクトワークスペースにアップロードします。

共有可能なプロジェクト JAR ファイルをデスクトップ IDE にインポートする

Mule プロジェクトのスナップショットの共有可能な JAR ファイルをデスクトップ IDE にインポートします。

共有可能な JAR ファイルを作成するには、​「共有可能な JAR ファイルにエクスポートする」​を参照してください。 コンテンツに連動関係は含まれないため、コンテンツは軽量です。 IDE では、プロジェクトの ​pom.xml​ で設定された連動関係が生成されます。

共有可能な JAR ファイルをデスクトップ IDE にインポートする手順は、次のとおりです。

  1. IDE で開いているプロジェクトがないことを確認します。

  2. コマンドパレットを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • [View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  3. 次のコマンドを選択します。

    MuleSoft: Import a Mule Project
  4. インポートする共有可能な JAR ファイルに移動し、​[Select jar file to import (インポートする JAR ファイルを選択)]​ をクリックします。

  5. JAR ファイルを解凍するフォルダー (ホームディレクトリや、Mule プロジェクトフォルダー​外部​のフォルダーなど) に移動します。

  6. [Select project folder (プロジェクトフォルダーを選択)]​ をクリックします。

    IDE により、プロジェクトの共有可能な JAR ファイルが選択したフォルダーに解凍されます。

  7. Mule プロジェクトフォルダーが閉じている場合、プロジェクトの​ルート​ディレクトリでプロジェクトの​ワークスペースを開きます​。

    グラフィカルキャンバス UI の読み込みに加えて、IDE はプロジェクトの ​pom.xml​ で定義された連動関係も読み込みます。

    ライブラリは、プロジェクトフォルダー内の ​target/repositories​ ディレクトリに読み込まれます。

  8. プロジェクトをテストします。

    1. 開いているプロジェクトでエラーをチェックし、設定 XML とキャンバス UI が正しく読み込まれていることを確認します。これは、コンポーネントの連動関係が解決されたことを示します。

    2. 設定 XML 内のポートやファイルパスなど、変更する設定を確認します。

    3. プロジェクトを実行してデバッグします。

      案内については、​「デバッグモードでのアプリケーションの実行」​を参照してください。

プロジェクトフォルダーをデスクトップ IDE にインポートする

一般的には、共有可能な JAR ファイルをインポートするか、ファイルディレクトリからプロジェクトワークスペースを開きますが、Mule プロジェクトフォルダーを [Explorer] ビューにドラッグしてプロジェクトを VS Code ワークスペースで開くこともできます。

デスクトップに保存されている Anypoint Studio (Studio) からのプロジェクトを含め、有効なプロジェクトフォルダーを開きます。または、​デスクトップ IDE またはクラウド IDE からプロジェクトフォルダーを開く​の手順を使用して、フォルダーを IDE にドラッグアンドドロップするのではなくプロジェクトをファイルディレクトリから開きます。

プロジェクトフォルダーをデスクトップ IDE にインポートする手順は、次のとおりです。

  1. IDE で開いているプロジェクトがないことを確認します。

  2. プロジェクトフォルダーの場所に移動します。

    1. コマンドパレットを開きます。

      手順を表示
      • キーボードショートカットを使用する。

        • Mac: Cmd+Shift+p

        • Windows: Ctrl+Shift+p

      • [View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

    2. 次のコマンドを選択します。

      File: Open Folder
    3. インポートしたプロジェクトのフォルダー (ホームディレクトリや、Mule プロジェクトフォルダー​外部​のフォルダーなど) に移動して選択し、​[Open (開く)]​ をクリックします。

  3. プロジェクトディレクトリをコンピューターから VS Code のエクスプローラービューにドラッグします。次に例を示します。

    プロジェクトフォルダーをエクスプローラービューにドラッグ
  4. [Copy Folder (フォルダーをコピー)]​ を選択します。

    代わりに ​[Add Folder to Workspace (ワークスペースにフォルダーを追加)]​ を選択した場合は、エクスプローラーでプロジェクトを選択し、右クリックして ​[Remove Folder from Workspace (ワークスペースからフォルダーを削除)]​ を選択することで、最初からやり直すことができます。 削除したら、プロジェクトフォルダーをワークスペースには追加せずに、IDE にドラッグしてコピーします。

  5. Mule プロジェクトフォルダーが閉じている場合、プロジェクトの​ルート​ディレクトリでプロジェクトの​ワークスペースを開きます​。

    グラフィカルキャンバス UI の読み込みに加えて、IDE はプロジェクトの ​pom.xml​ で定義された連動関係も読み込みます。

    ライブラリは、プロジェクトフォルダー内の ​target/repositories​ ディレクトリに読み込まれます。

  6. プロジェクトをテストします。

    1. 開いているプロジェクトでエラーをチェックし、設定 XML とキャンバス UI が正しく読み込まれていることを確認します。これは、コンポーネントの連動関係が解決されたことを示します。

    2. 設定 XML 内のポートやファイルパスなど、変更する設定を確認します。

    3. プロジェクトを実行してデバッグします。

      案内については、​「デバッグモードでのアプリケーションの実行」​を参照してください。

クラウド IDE にプロジェクトをインポートして開く

クラウド IDE を使用すると、プロジェクトディレクトリまたは JAR ファイルをワークスペースにアップロードできます。

共有可能なプロジェクト JAR ファイルをクラウド IDE にインポートする

Mule プロジェクトの JAR ファイルをインポートし、展開したプロジェクトを IDE のワークスペースに読み込みます。

  1. クラウド IDE で開いているプロジェクトがないことを確認します。

  2. コマンドパレットを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • ​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  3. 次のコマンドを選択します。

     File: Open Folder...
  4. Anypoint Code Builder のホームディレクトリ、または Mule プロジェクトフォルダー​外部​のディレクトリを選択し、​[OK]​ をクリックします。

    プロンプトが表示されたら、ディレクトリ内のファイルの作成者を信頼します。

    Anypoint Code Builder にディレクトリが読み込まれます。

  5. 共有可能な JAR ファイルをコンピューターからクラウド IDE の [Explorer] ビューにドラッグします。次に例を示します。

    JAR ファイルをクラウド IDE の [Explorer] ビューにドラッグ

    プロンプトが表示されたら、ファイルまたはディレクトリの作成者を信頼します。

    IDE の警告​「This file is not displayed in the text editor because it is either binary or uses an unsupported encoding. (このファイルはバイナリであるか、サポートされていない文字コードを使用しているため、テキストエディターに表示されません。)」​への応答として ​[Open Anyway (このまま開く)]​ をクリックしないでください。

    インポートするフォルダーが大きい場合、Anypoint Code Builder にアップロードの進行状況バーが表示されます。ユーザーはこれをクリックして展開することができます。

  6. コマンドパレットを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • ​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  7. 次のコマンドを選択します。

    MuleSoft: Import a Mule Project
  8. インポートする共有可能な JAR ファイルに移動して選択します。

  9. JAR ファイルの展開先のフォルダー (ホームディレクトリや、Mule プロジェクトフォルダー​​の任意のフォルダーなど) に移動して、​[OK]​ をクリックします。

    IDE により、プロジェクトの共有可能な JAR ファイルが選択したフォルダーに解凍されます。

  10. Mule プロジェクトフォルダーが閉じている場合、プロジェクトの​ルート​ディレクトリでプロジェクトの​ワークスペースを開きます​。

    グラフィカルキャンバス UI の読み込みに加えて、IDE はプロジェクトの ​pom.xml​ で定義された連動関係も読み込みます。

    ライブラリは、プロジェクトフォルダー内の ​target/repositories​ ディレクトリに読み込まれます。

  11. プロジェクトをテストします。

    1. 開いているプロジェクトでエラーをチェックし、設定 XML とキャンバス UI が正しく読み込まれていることを確認します。これは、コンポーネントの連動関係が解決されたことを示します。

    2. 設定 XML 内のポートやファイルパスなど、変更する設定を確認します。

    3. プロジェクトを実行してデバッグします。

      案内については、​「デバッグモードでのアプリケーションの実行」​を参照してください。

プロジェクトフォルダーをクラウド IDE にインポートする

  1. クラウド IDE で開いているプロジェクトがないことを確認します。

  2. コマンドパレットを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • ​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  3. 次のコマンドを選択します。

     File: Open Folder...
  4. Anypoint Code Builder のホームディレクトリ、または Mule プロジェクトフォルダー​外部​のディレクトリを選択し、​[OK]​ をクリックします。

    プロンプトが表示されたら、ディレクトリ内のファイルの作成者を信頼します。

    Anypoint Code Builder にディレクトリが読み込まれます。

  5. プロジェクトフォルダーをコンピューターからクラウド IDE の [Explorer] ビューにドラッグします。次に例を示します。

    プロジェクトフォルダーをクラウド IDE の [Explorer] ビューにドラッグ

    プロンプトが表示されたら、ファイルまたはディレクトリの作成者を信頼します。

    インポートするフォルダーが大きい場合、Anypoint Code Builder にアップロードの進行状況バーが表示されます。ユーザーはこれをクリックして展開することができます。

  6. Mule プロジェクトフォルダーが閉じている場合、プロジェクトの​ルート​ディレクトリでプロジェクトの​ワークスペースを開きます​。

    グラフィカルキャンバス UI の読み込みに加えて、IDE はプロジェクトの ​pom.xml​ で定義された連動関係も読み込みます。

    ライブラリは、プロジェクトフォルダー内の ​target/repositories​ ディレクトリに読み込まれます。

  7. プロジェクトをテストします。

    1. 開いているプロジェクトでエラーをチェックし、設定 XML とキャンバス UI が正しく読み込まれていることを確認します。これは、コンポーネントの連動関係が解決されたことを示します。

    2. 設定 XML 内のポートやファイルパスなど、変更する設定を確認します。

    3. プロジェクトを実行してデバッグします。

      案内については、​「デバッグモードでのアプリケーションの実行」​を参照してください。

デスクトップ IDE またはクラウド IDE からプロジェクトフォルダーを開く

アプリケーションのプロジェクトワークスペースフォルダーを開くか、再度開きます。この手順は、Anypoint Code Builder で構築されたプロジェクトと、デスクトップに保存されている、Anypoint Studio (Studio) で構築されたプロジェクトで機能します。

プロジェクトフォルダーを Studio からクラウド IDE にインポートするには、​プロジェクトフォルダーをクラウド IDE にインポートする​の手順を使用します。

  1. Mule プロジェクトフォルダーが閉じている場合は、プロジェクトの​ルート​ディレクトリでプロジェクトのワークスペースを開きます。

    1. コマンドパレットを開きます。

      手順を表示
      • キーボードショートカットを使用する。

        • Mac: Cmd+Shift+p

        • Windows: Ctrl+Shift+p

      • デスクトップ IDE で、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

      • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

    2. 次のコマンドを選択します。

      File: Open Folder...
    3. プロジェクトの​ルート​フォルダーに移動して選択します。

      VS Code はルートをワークスペースとして扱うため、IDE でキャンバス UI を適切に読み込めます。

      ルートは、プロジェクトの作成時に Anypoint Code Builder によって生成される最上位のフォルダーです。プロジェクトの親または上位ディレクトリに移動したり、いずれかの子または下位ディレクトリに移動したりしないでください。

      プロジェクトがルートで開きます。次に例を示します。

      プロジェクトのルートフォルダー
  2. プロジェクトの設定 XML ファイルが自動的に開かない場合は、そのファイルをクリックします。

  3. キャンバス UI が自動的に開かない場合は、アクティビティバーの​​ (​Show Mule graphical mode (Mule グラフィカルモードを表示)​) アイコンをクリックしてキャンバス UI を開きます。

  4. プロジェクトの読み込み時の進行状況を監視するには、[Output (出力)] パネルを開きます。

    手順を表示
    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+u

      • Windows: Ctrl+Shift+u

    • デスクトップ IDE で、​[View (表示)]​ > ​[Output (出力)]​ を選択する。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Output (出力)]​ を選択する。

  5. ドロップダウンメニューから ​[Mule DX Server (Mule DX サーバー)]​ を選択します。

  6. プロジェクトをテストします。

    1. 開いているプロジェクトでエラーをチェックし、設定 XML とキャンバス UI が正しく読み込まれていることを確認します。これは、コンポーネントの連動関係が解決されたことを示します。

    2. 設定 XML 内のポートやファイルパスなど、変更する設定を確認します。

    3. プロジェクトを実行してデバッグします。

      案内については、​「デバッグモードでのアプリケーションの実行」​を参照してください。

インポートしたプロジェクトでの DataWeave の使用

インポートしたプロジェクトで DataWeave を使用するには、プロジェクトの ​pom.xml​ ファイルで ​mule-service-weave-ee​ 連動関係を設定する必要があります。次に例を示します。

<dependency>
  <groupId>com.mulesoft.services</groupId>
  <artifactId>mule-service-weave-ee</artifactId>
  <version>2.4.0-20220824</version>
  <scope>runtime</scope>
</dependency>