Создание компоновщика проекта - файла компоновки Ant

Для того чтобы познакомиться с работой компоновщиков проектов, создадим простой проект с одним исходным файлом и файл компоновки Ant, который будет создавать архив jar файла класса. Хотя в этом примере используется Java, компоновщики проектов доступны для всех проектов, как Java, так и других.

  1. Создайте проект Java с именем HW.
  2. Создайте исходный файл Java с именем HelloWorld с главным методом.
  3. Поместите в главный метод вызов System.out.println() и задайте строку вывода приветствия.
  4. Сохраните изменения.
  5. Создайте файл с именем projectBuilder.xml, откройте его в редакторе Ant, введите следующий текст и сохраните файл.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Создание файла jar для проекта HW">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
      </target>
    </project>
    
  6. Выберите в панели навигации проект HW и в ее контекстном меню выберите Свойства.
  7. В окне свойств проекта выберите Компоновщики и нажмите Создать....
  8. В окне Выбрать тип конфигурации выберите Компоновка Ant и нажмите OK.
  9. Откроется окно Внешние инструменты. Введите имя Makejar. На вкладке Главные выберите Файл компоновки Обзор рабочей области... и укажите, что Расположение соответствует файлу компоновки projectBuilder.xml, созданному выше. Затем выберите Базовый каталог Обзор рабочей области... и задайте Базовый каталог как каталог проекта HW.

    Вкладка Главная окна Внешние инструменты

  10. На вкладке Обновить зададим, чтобы при создании файла HelloWorld.jar он отображался в Eclipse. По умолчанию обновление при завершении работы компоновщика проекта не выполняется. Выберите Обновить ресурс по завершении, затем выберите Проект, содержащий выбранный ресурс в списке переменных области действия. Обновление - это ресурсоемкая операция, поэтому вообще следует обновлять минимальную совокупность ресурсов, которые участвуют в компоновке.

    Вкладка Обновить окна Внешние инструменты

  11. Укажите на вкладке Целевые объекты, когда следует запускать этот компоновщик проекта и с какими целевыми объектами. По умолчанию целевой объект default выполняет После "Чисто" и Компоновку вручную. Можно указать другие целевые объекты и другие триггеры. Запускать компоновщик проекта при автоматической компоновке возможно, но не рекомендуется по соображениям быстродействия. Дополнительная информация о видах компоновки приведена здесь.

    Вкладка Цели окна Внешние инструменты

  12. Примените изменения и нажмите OK.
  13. В окне свойств проекта будет показан компоновщик проекта с именем Makejar, который будет запускаться после компоновщика Java по умолчанию. Для того чтобы сохранить компоновщик проекта и закрыть окно, нажмите OK.
    Примечание: Порядок запуска можно изменить, чтобы файл компоновки Ant запускался перед компоновщиком Java, хотя в этом примере это и не имеет смысла.

    Окно свойств проекта

Компоновщик Java вызывает встроенный компилятор Java Eclipse, который в свою очередь отвечает за индексацию исходного кода, благодаря чему становятся доступны поиск, категоризация и прочие функции. Встроенный компилятор Java Eclipse невозможно заменить с помощью компоновщика проекта. Компоновщик Java можно выключить, а также можно задать, как он будет запускаться по отношению к заданным вами компоновщикам проектов.

Связанные задачи
Создание файлов компоновки Ant
Цели Ant компоновщика проекта
Правка файлов компоновки Ant
Сохранение и повторное использование опций Ant
Выполнение файлов компоновки Ant
Файлы компоновки Ant как компоновщики проектов
Запуск компоновщиков проектов
Внешние инструменты
Компоновщики отличных от Ant проектов
Автономные внешние инструменты