Tworzenie pliku budowy narzędzia Ant dla programu budującego projekt

Aby poznać sposób działania programów budujących projektu, utworzony zostanie prosty projekt z pojedynczym plikiem źródłowym i plikiem budowy narzędzia Ant, który tworzy plik jar z pojedynczym plikiem klasy. W tym przykładzie zostanie użyty język Java, ale należy wspomnieć, że programy budujące projektu są dostępne dla wszystkich projektów, zarówno w języku Java, jak i w innych językach.

  1. Utwórz projekt Java o nazwie "HW".
  2. Utwórz plik źródłowy Java o nazwie "HelloWorld" z metodą main.
  3. Umieść pojedynczą instrukcję "System.out.println()" w metodzie main, a następnie dodaj do niej powitanie, które zostanie wyświetlone.
  4. Zapisz zmiany.
  5. Utwórz plik o nazwie "projectBuilder.xml", otwórz edytor Ant dla tego pliku, wprowadź następującą treść i zapisz zmiany.
  6. <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">

    <target name ="makejar" description="Tworzenie pliku jar dla projektu HW">
    <jar jarfile="HelloWorld.jar" includes="*.class" basedir="."/>
    </target>
    </project>

  7. W jednym z widoków nawigacyjnych wybierz projekt HW i wybierz z jego menu kontekstowego opcję Właściwości.
  8. W oknie dialogowym właściwości projektu wybierz pozycję Programy budujące, a następnie kliknij przycisk Nowy.
  9. W oknie dialogowym Wybierz typ konfiguracji wybierz opcję Budowanie Ant i kliknij przycisk OK.
  10. Zostanie wyświetlone okno dialogowe Narzędzia zewnętrzne. Ustaw nazwę "Makejar". Na karcie Główne kliknij kolejno pole Plik budowy i przycisk Przeglądaj obszar roboczy, a następnie ustaw w polu Położenie plik budowy projectBuilder.xml, który został utworzony powyżej. Kliknij kolejno pole Katalog podstawowy i przycisk Przeglądaj obszar roboczy, a następnie ustaw katalog podstawowy na projekt HW.
    Karta Główne w oknie dialogowym Narzędzia zewnętrzne
  11. Na karcie Odświeżanie należy upewnić się, że kiedy zostanie utworzony plik HelloWorld.jar, będzie on widoczny w środowisku Eclipse. Odświeżanie nie jest domyślnie wykonywane po zakończeniu pracy przez program budujący projektu, a więc należy zaznaczyć pole wyboru Odśwież zasoby po zakończeniu i wybrać pozycję Projekt zawierający wybrany zasób z listy zmiennych zasięgu. Ponieważ odświeżanie może być kosztowną operacją, należy odświeżać tylko najmniejszy obiekt zawierający wszystkie zasoby, na które wpływa dany plik budowy.
    Karta Odświeżanie w oknie dialogowym Narzędzia zewnętrzne
  12. Na karcie Cele powinien być wybrany cel domyślny.
  13. Na karcie Opcje budowania można określić, kiedy ten program budujący projektu powinien być wykonywany. Domyślnie powinny być zaznaczone pola wyboru Po operacji czyszczenia i Podczas ręcznych operacji budowania. Wykonywanie programu budującego projektu w czasie automatycznego budowania jest możliwe, ale niezalecane ze względu na kwestie wydajności.
    Karta Opcje budowania w oknie dialogowym Narzędzia zewnętrzne
  14. Zastosuj zmiany i kliknij przycisk OK.
  15. Po powrocie do okna dialogowego właściwości projektu można zauważyć pojawienie się programu budującego projektu o nazwie "Makejar", który będzie wykonywany po domyślnym programie budującym Java. Kliknij przycisk OK, aby zapisać program budujący projektu i zamknąć okno dialogowe.
    Uwaga:
    istnieje możliwość zmiany porządku, dzięki czemu plik budujący narzędzia Ant byłby wykonywany przez program budujący Java, ale nie ma to sensu w tym przykładzie.
    Okno dialogowe właściwości projektu

Program budujący Java uruchamia wewnętrzny kompilator Eclipse Java, który jest odpowiedzialny za indeksowanie kodu źródłowego, dzięki czemu dostępne są takie funkcje, jak wyszukiwanie, refaktoryzacja i wiele innych. Z tego powodu nie jest możliwe zastąpienie wewnętrznego kompilatora Eclipse Java przy użyciu programu budującego projektu. Możliwe jest wyłączenie programu budującego Java, a także samodzielne decydowanie o tym, kiedy należy uruchamiać program budujący Java w odniesieniu do zdefiniowanych programów budujących projektu.