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

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

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

Вы можете попробовать самый новый 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. Дайте краткое и информативное заглавие, и в поле комментария дайте краткое описание изменений, и нажмите зеленую кнопку [Create pull request] еще раз.
  9. Выберите кнопку [Commit And Merge].
  10. Нажмите кнопку [Commit And Merge] еще раз, чтобы подтвердить свой выбор.

Чтобы отправить изменения в репозиторий jMonkeyEngine после pushing на свой fork:

  1. Перейдите к своей версии репозитория на GitHub.
  2. Нажмите вверху кнопку [New Pull Request].
  3. Обратите внимание, что репозиторий jMonkeyEngine будет слева, а ваш репозиторий будет справа.
  4. Нажмите зеленую кнопку [Create pull request]. Дайте краткое и информативное заглавие, и в поле комментария дайте краткое описание изменений и нажмите зеленую кнопку [Create pull request] еще раз.
Всем
Смотрите раздел Как внести вклад в jMonkeyEngine перед отправкой P/R.

Проверка Клонированных Подпроектов(Verify Cloned Subprojects)

Посмотрите на узел 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-native. Это обновляет временную метку в заголовочных файлах, даже если вы их не редактировали. Затем они будут отмечены как измененные, что добавит их в следующую фиксации(commit).

Чтобы избежать их фиксации(commit) сделайте то что описано ниже прежде чем делать что-либо еще:

  1. В окне Проекты откройте узел подпроекта jme3-bullet-native.
  2. Перейдите в папку Пакеты исходные кодов / ‹пакет по умолчанию›.
  3. Выберите все заголовочные файлы .h, выделив их.
  4. [КП Мыши] выберите выделенные файлы, затем выберите Git ▸ Игнорировать ▸ Исключить из фиксации
  1. [КП Мыши] кликните по корневому узлу проекта jmonkeyengine и выберите Очистить и собрать проект.
  2. В окне Проекты выберите [КП Мыши] и откройте узел jme-examples, который содержит примеры приложений. Вы делаете это для любого подпроекта, в который вы хотите внести изменения.
  3. Каждый файл в папке Пакеты исходные кодов с Гланым классом (например, jme3test.model/TestHoverTank.java или jme3test.games/CubeField.java) является приложением.
  4. Щелкните [КП Мыши] пример приложения и выберите Выполнить файл (Shift+F6).
  5. Как правило, в примерах приложений:
    1. перемещение осуществляется мышью и клавишами WASD
    2. клавиша Esc выход из приложения
Вы можете кликнуть [КП Мыши] по узлу jme-examples и выбрать Выполнение, чтобы запустить приложение Test Chooser независимо от того, открыли ли вы узел проекта или нет.

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

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

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

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

  1. В исходниках jmonkeyengine:
    1. Щелкните [КП Мыши], по узлу подпроекта и выберите Tasks ▸ install будет установленная сборка jar-ов для этого подпроекта в вашу локальную папку maven репозитория org.jmonkeyengine, который на linux в ~/.m2, а в Windows может быть в AppData или в вашем домашнем каталоге ,
    2. Щелкните [КП Мыши], по корневому узлу и выберите Tasks ▸ dist, создает jME3 примеры распространяемые со всеми jme3 бинарниками, javadoc и внешними библиотеками в ~/NetBeansProjects/jmonkeyengine/dist.
    3. Щелкните [КП Мыши], по корневому узлу и выберите Tasks ▸ libDist соберём и копируем двоичные файлы и исходники движка в ~/NetBeansProjects/jmonkeyengine/build/libDist.
    4. Щелкните [КП Мыши], по корневому узлу и выберите Tasks ▸ copyLib копирует зависимости движка в ~/NetBeansProjects/jmonkeyengine/build/libDist/lib-ext.
  2. В своем игровом проекте добавьте jme3 jar кликнув [КП Мыши], по узлу Библиотеки и выбрав Добавить файл JAR /папку.
  3. Перейдите в нужную папку и выберите интересующую вас jar библиотеку. Проверьте «правильность путь» и нажмите [Open].
  4. Кликнув [КП Мыши] выберите недавно добавленный jar и выберите Изменение.
  5. В диалоговом окне Изменить ссылку на JAR, в пункте Документация JavaDoc: кликните [Обзор] и выберите в папку javadoc/. Проверьте «правильность пути» и нажмите [Open].
  6. В диалоговом окне Изменить ссылку на JAR в пункте Исходные файлы: выберите папку, которая содержит ваши источники».
    кликните [Обзор] Проверьте «правильность пути» и нажмите [Open].
  7. В редакторе кода наведите курсор на jme класс и нажмите ctrl+space, чтобы просмотреть javadoc. Ctrl+Клик по любому методу jme3, позволит перейти к его переопределяющим методам в исходниках.

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


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


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

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

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