Ant ビルド・ファイルの編集

Ant ビルド・ファイルは単なるテキスト・ファイルであるため、どのようなテキスト・エディターでも編集できます。 ただし、Eclipse Ant エディターを使用すれば、構文の色分け、コンテンツ・アシスト、ナビゲーション、オカレンス・マーキング、 および「アウトライン」ビューなどいくつかの利点があります。 Eclipse Ant エディターに慣れるため、このエディターを使用して簡単な Ant ビルド・ファイルを作成してみましょう。

  1. HelloWorld.xml と呼ばれる Ant ビルド・ファイルを作成します。
  2. そのファイルのコンテキスト・メニューから「アプリケーションから開く」>「Ant エディターを選択して、 そのファイルで Ant エディターを開きます。
    注: .xml ファイルの内容がビルド・ファイルでない場合、そのデフォルト・エディターは単純なテキスト・エディターになります。 これは、 ファイルの関連付けの設定ページを開く「ウィンドウ」>「設定」>「一般」>「エディター」>「ファイルの関連付け」設定ページで変更できます。
  3. エディターで次の内容を入力します。
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="Hello World" default="Hello" basedir="."> 
      <property name="HelloText" value="Hello"/>
      <target name="Hello">
        <echo>${HelloText}</echo>
    	</target>
    </project>
    

    HelloWorld.xml ファイル・コンテンツ

  4. プロパティー値の構文の色分けに注意してください。
  5. 2 番目のターゲットの入力を <tar にして、さらにコンテンツ・アシストをアクティブにするために Ctrl-Space を押してください。有効な完了のリストが表示されます。<target> の完了を選択し、エディターが開始タグと終了タグの両方を挿入すること、このタグの属性を入力する位置にカーソルが置かれていることを確認してください。
  6. このターゲットに World と名前を付けます。
  7. Hello ターゲットと同様、テキストを ${WorldText} に変更し、このターゲットに対して echo タスクを入力してください。
  8. Hello ターゲットから World ターゲットの依存関係を追加します。 カーソルを name 属性の定義の後に移動し、Ctrl + スペースを押して、depends 属性の補完を選択します。 Ctrl+Space を再び押して、ビルド・ファイルの他のターゲット World を完了してください。
  9. ビルド・ファイルのコンテンツを保存します。
  10. コンテンツ全体は、以下のようになります。
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="Hello World" default="Hello" basedir="."> 
      <property name="HelloText" value="Hello"/>
      <property name="WorldText" value="World"/>
      <target name="Hello">
        <echo>${HelloText}</echo>
    	</target>
    
      <target name="World">
        <echo>${WorldText}</echo>
    	</target>
    </project>
    
  11. HelloWorld.xml に加えた変更を保存します。
  12. 「アウトライン」ビューを見えるようにしておいて、プロパティーおよびターゲットごとにエントリーがあることに注意してください。 さらに、ターゲットの下のそれぞれのタスクにもエントリーがあります。

    Ant ビルド・ファイルの「アウトライン」ビュー

  13. 「アウトライン」ビューのエントリーをクリックすると、エディターがそのエントリーにスクロールします。 さらに、「アウトライン」ビューにフォーカスがある場合、 文字を入力するとビュー内の選択が入力した文字で始まる次の可視のエントリーに移動します。
  14. カーソルを <target> タグのいずれかのすぐ後ろに置き、<tar と入力してください。 その後、コンテンツ・アシストをアクティブにするために Ctrl-Space を押してください。ここで、有効な完了は </target> および tar タグだけとなります。これは、Ant エディターがネストされたターゲットが許可されないことを認識しているためです。

    Ant エディターにおけるコード・アシスト
  15. エディターを閉じ、変更を保存しません。

関連タスク
Ant ビルド・ファイルの作成
Ant ビルド・ファイルの実行
Ant オプションの保存および再利用
Ant ビルド・ファイルの実行
プロジェクト・ビルダー Ant ビルド・ファイルの作成
プロジェクト・ビルダーとしての Ant ビルド・ファイル
プロジェクト・ビルダーの実行
外部ツール
非 Ant プロジェクト・ビルダー
スタンドアロン外部ツール