Tworzenie pliku budowy narzędzia Ant dla programu budującego projekt
Aby poznać sposób działania programów budujących projekty, 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 projekty są dostępne dla
wszystkich projektów, zarówno w języku Java, jak i w innych językach.
- Utwórz projekt Java o nazwie "HW".
- Utwórz plik źródłowy Java o nazwie "HelloWorld" z metodą main.
- Umieść pojedynczą instrukcję "System.out.println()" w metodzie main, a następnie
dodaj do niej powitanie, które zostanie wyświetlone.
- Zapisz zmiany.
- Utwórz plik o nazwie "projectBuilder.xml", otwórz edytor Ant dla tego pliku,
wprowadź następującą treść i zapisz zmiany.
<?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>
- W jednym z widoków nawigacyjnych wybierz projekt HW i wybierz z jego menu kontekstowego opcję Właściwości.
- W oknie dialogowym właściwości projektu wybierz pozycję Programy budujące,
a następnie kliknij przycisk Nowy.
- W oknie dialogowym Wybierz typ konfiguracji wybierz opcję
Budowanie Ant i kliknij przycisk OK.
- 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.
- 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 projekt, a więc należy
zaznaczyć pole wyboru Odśwież zasoby po zakończeniu i wybrać opcję
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.
- Na karcie Cele powinien być wybrany cel domyślny.
- Na karcie Opcje budowania można określić, kiedy ten program budujący projekt
powinien być wykonywany. Domyślnie powinny być zaznaczone pola wyboru Po operacji
czyszczenia i Podczas ręcznych operacji budowania. Wykonywanie
programu budującego projekt w czasie automatycznego budowania jest możliwe, ale niezalecane
ze względu na kwestie wydajności.
- Zastosuj zmiany i kliknij przycisk OK.
- Po powrocie do okna dialogowego właściwości projektu można zauważyć pojawienie się
programu budującego projekt o nazwie "Makejar", który będzie wykonywany po domyślnym
programie budującym Java. Kliknij przycisk OK, aby zapisać program budujący
projekt 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.
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 projekt. 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 projekt.