Zadania importu służą do importowania pliku kompilacji do bieżącego projektu. Zaimportowane pliki są analizowane przy użyciu programu ProjectHelper. ProjectHelper jest w rzeczywistości odpowiedzialny za analizowanie zaimportowanych plików.
Zadanie importu jest zadaniem najwyższego poziomu, więc nie można go użyć wewnątrz elementu docelowego. Z tym zadaniem wiążą się dwa aspekty funkcjonalne.
Przesłanianie celu
Jeżeli cel w bieżącym pliku jest także dostępny w importowanym pliku, pierwszeństwo będzie miał cel z bieżącego pliku.
Właściwości specjalne
Zaimportowane pliki są lokalne dla bieżącego głównego projektu. Aby rozróżnić pliki importowane i lokalne, Ant dodaje właściwość zawierającą ścieżkę do zaimportowanego pliku kompilacji.
Uwaga: Jeśli zaimportowany plik nie zawiera atrybutu name, jego właściwość nie zostanie ustawiona.
Atrybuty zadania importu Apache Ant
Atrybut | Opis | Wymagany |
---|---|---|
plik | Plik do zaimportowania. | Tak |
opcjonalny | Jeśli ma wartość true, nie zatrzymuj kompilacji, jeśli plik nie istnieje. | NIE |
Jak | Określa przedrostek dołączany do nazw docelowych. | NIE |
przedrostekSeparator | Separator używany pomiędzy przedrostkiem a nazwą docelową. | NIE |
Przykład zadania importu Apache Ant
Poniższy kod importuje elementy docelowe z pliku common-targets.xml znajdującego się w katalogu nadrzędnym.
Importuje projekt
Importuje cel z pliku targets.xml, który znajduje się we wspólnym katalogu.