Докуметация Cтарт Статьи Форум Лента Вход
Не официальное русскоязычное сообщество
Главная
    Документация jMonkeyEngine
        jMonkeyEngine SDK: Документация
            Сценарий сборки по умолчанию

Сценарий сборки по умолчанию

Опубликованно: 29.09.2017, 16:04
Последняя редакция, Andry: 03.10.2017 20:31

Если вы используете библиотеки jMonkeyEngine вместе с jMonkeyEngine SDK (рекомендуется), то вы можете воспользоваться предоставленным сценарием сборки. Каждый новый проект поставляется со сценарием Ant по умолчанию. Кнопки панели инструментов и действия очистка/сборка/запуск в jMonkeyEngine SDK уже настроены заранее.

Цели по умолчанию

Сценарий сборки включает цели для следующих задач:

  • clean — удаляет созданные классы и исполняемые файлы в папке dist.
  • jar — компилирует классы, связывает assets, создает исполняемый JAR в папке dist, копирует библиотеки.
  • run — создает и запускает исполняемый JAR (например, для разработчиков, чтобы проверить его).
  • javadoc — компилирует javadoc из ваших java-файлов в html-файлы.
  • debug — используется в jMonkeyEngine SDK плагином Debugger.
  • test — Используется в jMonkeyEngine SDK плагином JUnit Test.

Вы можете вызвать эти цели в командной строке, используя команды по умолчанию Ant:

ant clean
ant jar
ant run
Мы рекомендуем использовать удобные элементы меню, клавишу F или кнопки панели инструментов в jMonkeyEngine SDK для запуска действий по очистке, сборке и запуску.

Просмотр Сценария Сборки

  1. Чтобы увидеть сценарий сборки и предопределенные задачи
  2. Откройте проект в jMonkeyEngine SDK, если он еще не открыт (Файл ▸ Открыть проект…)
  3. Откройте окно Файлы (Окно ▸ Файлы)
  4. Откройте узел проекта. Вы увидите в списке build.xml.
    1. Дважды щелкните файл build.xml, чтобы узнать, как определены цели команды jme3. Обычно вам не нужно редактировать существующие, но вы можете.
    2. Нажмите треугольник рядом с build.xml, чтобы открыть его узел и увидеть все цели.
      1. Дважды щелкните цель в окне Файлы или Навигатор, чтобы узнать, как определена цель.
        Вы заметите, что открывается файл nbproject/build-impl.xml. Он содержит очень общие цели, которые вам обычно не нужно редактировать. Обратите внимание, что build.xml включён в build-impl.xml!

Добавление пользовательских целей

build-impl

Сценарий сборки является не-проприетарным скриптом Apache Ant. Он будет работать без настройки, но при необходимости вы можете расширить его и настроить.

Прочитайте комментарии в файле build.xml, они объяснят, как переопределить цели или расширить их, чтобы настроить процесс сборки, не нарушая существующую функциональность.

Кроме того, вы можете вручную переопределить цели в файлах *-impl.xml, которые создаются при изменении настроек развертывания:

  • linuxlauncher-impl.xml,
  • macapp-impl.xml,
  • mobile-impl.xml,
  • jnlp-impl.xml, etc.

Просто скопируйте и вставьте цель из этих файлов в основной файл build.xml, и это будет выполнено со всеми изменениями.

* Не изменяйте базовые файлы -impl.xml напрямую, если вы деактивируете и повторно активируете настройку развертывания, SDK сбрасывает эти файлы, поэтому вам нужно скопировать всю цель и ее зависимости, иначе скрипт сборки станет недействительным, когда вы отключите опцию развертывания.


Переведено для jmonkeyengine.ru, оригинал
Автор перевода: Andry

Добавить комментарий

jMonkeyEngine.ru © 2017. Все права сохранены.