Докуметация Cтарт Статьи Форум Лента Вход
Не официальное русскоязычное сообщество
Главная
    Документация jMonkeyEngine
        jMonkeyEngine Уроки и Документация
            Сборка JME3 из исходников в Netbeans 8.x

Сборка JME3 из исходников в Netbeans 8.x

Опубликованно: 27.11.2017, 15:46
Последняя редакция, Andry: 02.01.2018 22:43

Вы можете попробовать самый новый jME3 и внести исправления и функции! В этом документе показано, как загрузить, настроить, создать и запустить последнюю разрабатываемую версию из исходников. Эти инструкции работают в среде IDE NetBeans 8.x или выше.

Предпосылки

  1. У вас есть аккаунт GitHub.
  2. Вы являетесь участником проекта jMonkeyEngine.

Если вы не являетесь участником, вы fork репозиторий в своей учетной записи GitHub и pull requests оттуда.

Чтобы fork репозиторий jMonkeyEngine в своей учетной записи GitHub:

  1. Перейдите на страницу https://github.com/jMonkeyEngine/jmonkeyengine.
  2. В меню в верхней части страницы выберите кнопку «Fork».
В дальнейшем всегда заменяйте ~ путём к вашему домашнему каталогу.

Загрузка исходников

Клонирование исходников из репозитория.

  1. В NetBeans перейдите в Группа ▸ Git ▸ Клонировать.
    1. URL-адрес репозитория:
      https://github.com/jMonkeyEngine/jmonkeyengine
      Используйте URL-адрес для своего fork репозитория и клонируйте свой fork, если вы не являетесь участником, и вы хотите внести свой вклад.
    2. Вы можете оставить Пользователь/Пароль пустыми для анонимного доступа, если только вы не собираетесь push и commit.
    3. Укажите папку назначения.
    4. Локальная папка: ~/NetBeansProjects]/jmonkeyengine
    5. Нажмите [Далее].
  2. Выберите:

      master*

    1. Нажмите [Далее].
  3. Проверьте правильность информации автозаполнения в диалоговом окне «Целевой каталог».
    1. Необязательно:
        Сканирование проектов NetBeans после клонирования
    2. Нажмите [Готово] и подождите.

Через некоторое время загрузка закончится.

Информация о Pull/Pushing Commits

Теперь у вас есть локальная копия репозитория jmonkeyengine. Чтобы внести свой вклад, вам нужно следовать нескольким правилам.

Участники и нет Pull/Push

Обновите локальную копию и нажмите фиксации с помощью NetBeans команды Git ▸ Удалённый ▸ Вытягивание из выше стоящего сервера или Git ▸ Удалённый ▸ Втолкнуть на выше стоящий сервер.

Тем кто не являются участниками

Чтобы обновить ваш fork на GitHub:

  1. Перейдите к своей версии репозитория на GitHub.
  2. Нажмите кнопку вверху [New Pull Request].
  3. Обратите внимание, что репозиторий jMonkeyEngine будет слева, а ваш репозиторий будет справа.
  4. Нажмите кнопку [Base Fork], а в раскрывающемся меню выберите forked репозиторий.
  5. Выберите ссылку «compare across forks».
  6. Нажмите кнопку [Head Fork] и в раскрывающемся списке выберите «jMonkeyEngine/jmonkeyengine».
  7. Нажмите зеленую кнопку [Create pull request].
  8. Дайте краткое и информативное название, в поле комментария дайте краткое описание изменений и нажмите зеленую кнопку «Создать запрос на растяжение» еще раз.
  9. Выберите кнопку фиксации и слияния.
  10. Нажмите кнопку Commit And Merge еще раз, чтобы подтвердить свой выбор.

Чтобы отправить изменения в репозиторий jMonkeyEngine после нажатия на свою вилку:

  1. Перейдите к своей версии репозитория на GitHub.
  2. Нажмите кнопку «Новый запрос на подачу» вверху.
  3. Обратите внимание, что репозиторий jMonkeyEngine будет слева, а ваш репозиторий будет справа.

  4. Нажмите зеленую кнопку «Создать запрос на растяжение». Дайте краткое и информативное название, в поле комментария дайте краткое описание изменений и нажмите зеленую кнопку «Создать запрос на растяжение» еще раз.
Все
См. Раздел Как внести вклад в jMonkeyEngine перед отправкой P / R.

Проверка клонированных подпроектов

Посмотрите на узел Subprojects и убедитесь, что клонированные подпроекты:

  • jme3-android
  • jme3-android-native
  • jme3-blender
  • jme3-bullet
  • jme3-bullet-native
  • jme3-bullet-native-android
  • jme3-core
  • jme3-desktop
  • jme3-effects
  • jme3-examples
  • jme3-ios
  • jme3-jbullet
  • jme3-jogg
  • jme3-jogl
  • jme3-lwjgl
  • jme3-lwjgl3
  • jme3-networking
  • jme3-niftygui
  • jme3-plugins
  • jme3-terrain
  • jme3-testdata
  • jme3-vr

Подробное описание отдельных файлов jar см. В этом списке.

Создайте проект и запустите пример приложения

Когда вы создаете движок из корневого узла, часть процесса сборки включает в себя создание файлов заголовков для подпроекта jme3-bullet. Это обновляет временную метку в файлах заголовков, даже если вы их не редактировали. Затем они будут отмечены как измененные, что добавит их к следующему фиксации.

Чтобы предотвратить их совершение, прежде чем делать что-либо еще:

  1. В окне «Проекты» откройте узел подпроекта jme3-bullet.
  2. Перейдите в папку «Исходные пакеты / <пакет по умолчанию».
  3. Выберите все файлы заголовка .h, чтобы выделить их.
  4. RMB выберите выделенные файлы, затем выберите Git ▸ Ignore ▸ Exclude From Commit
  1. RMB выберите корневой узел проекта jmonkeyengine и очистите и создайте проект.
  2. В окне «Проекты» выберите RMB и откройте узел jme-examples, который содержит примеры приложений. Вы делаете это для любого подпроекта, который вы хотите внести.
  3. Каждый файл в папке «Исходные пакеты» с основным классом (например, jme3test.model / TestHoverTank.java или jme3test.games/CubeField.java) является приложением.
  4. Щелкните правой кнопкой мыши пример приложения и выберите «Запустить файл» (Shift-F6).
  5. Как правило, в примерах приложений:
    1. перемещение мыши и клавиши WASD
    2. клавиша Esc выходит из приложения
Вы можете RMB выбрать узел jme-examples и выбрать Run, чтобы запустить приложение Test Chooser независимо от того, открываете ли вы узел проекта.

Дополнительно: всплывающие окна Javadoc и исходная навигационная система в NetBeans

Если вы работаете с источниками jmonkeyengine:

  1. Подтвердите в окне «Файлы», что javadoc был создан в ~ / NetBeansProjects / jmonkeyengine / dist / javadoc
  2. В редакторе поместите курсор в класс jme и нажмите ctrl-space, чтобы просмотреть javadoc.

Если вы работаете над проектом игры, который зависит от jmonkeyengine:

  1. В источнике jmonkeyengine:
    1. RMB, выбрав узел подпроекта и выбрав «Задачи ▸», установит встроенные банки для этого подпроекта в вашу локальную папку репозиториев org.jmonkeyengine, которые на linux равны ~ / .m2, а в Windows могут быть в AppData или в вашем домашнем каталоге ,
    2. RMB, выбирая корневой узел и выбрав «Задачи» ▸ dist, создает распределение примеров jME3 со всеми двоичными файлами jme3, javadoc и внешними библиотеками в ~ / NetBeansProjects / jmonkeyengine / dist.
    3. RMB, выбирая корневой узел и выбрав «Задачи» ▸ libDist строит и копирует двоичные файлы и источники движка в ~ / NetBeansProjects / jmonkeyengine / build / libDist.
    4. RMB, выбирая корневой узел и выбрав «Задачи» ▸ copyLib копирует зависимости ядра с ~ / NetBeansProjects / jmonkeyengine / build / libDist / lib-ext.
  2. В своем игровом проекте добавьте jme3 jar RMB, выбрав узел Libraries и выбрав Add Jar / Folder.
  3. Перейдите в выбранную папку и выберите интересующую вас библиотеку. Проверьте «как относительный путь» и нажмите «Открыть».
  4. RMB выберите недавно добавленную банку и выберите «Изменить».
  5. В диалоговом окне Edit Jar Reference, JavaDoc: выберите в папку javadoc /. Проверьте «как относительный путь» и нажмите «Открыть».
  6. В диалоговом окне «Редактировать привязку» выберите «Источники: выберите папку, которая содержит ваши источники». Проверьте «как относительный путь» и нажмите «Открыть».
  7. В редакторе поместите курсор в класс jme и нажмите ctrl-space, чтобы просмотреть javadoc. Ctrl-click любой метод jme3, чтобы перейти к его определению в источниках.

Этот совет работает для любой сторонней библиотеки JAR, которую вы используете. (Возможно, вам придется загружать javadoc / sources со своей домашней страницы отдельно).

Используемые источники: https://github.com/jMonkeyEngine/jmonkeyengine


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

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

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