Імпорт завдань використовується для імпорту файлу збірки в поточний проект. Імпортовані файли аналізуються за допомогою ProjectHelper. ProjectHelper насправді відповідає за аналіз імпортованих файлів.
Завдання імпорту є завданням верхнього рівня, тому його не можна використовувати в цільовому елементі. З цим завданням пов’язані два функціональні аспекти.
Цільове перевизначення
Якщо ціль у поточному файлі також доступна в імпортованому файлі, ціль поточного файлу матиме пріоритет.
Особливі властивості
Імпортовані файли є локальними для поточного основного проекту. Щоб розрізняти імпортовані та локальні файли, Ant додає властивість, яка містить шлях до імпортованого файлу збірки.
Примітка. Якщо імпортований файл не містить атрибута імені, його властивість не буде встановлено.
Атрибути завдання імпорту Apache Ant
Атрибут | опис | вимагається |
---|---|---|
файл | Файл для імпорту. | Так |
необов'язковий | Якщо істина, не зупиняйте збірку, якщо файл не існує. | Немає |
як | Визначає префікс, який додається до цільових імен. | Немає |
prefixSeparator | Розділювач, який буде використано між префіксом і цільовою назвою. | Немає |
Приклад завдання імпорту Apache Ant
Наведений нижче код імпортує цілі з файлу common-targets.xml, розташованого в батьківському каталозі.
Він імпортує проект
Він імпортує ціль із файлу targets.xml, який знаходиться всередині загального каталогу.