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

Создание плагина для jMonkeyEngine SDK

Опубликованно: 06.10.2017, 20:52
Последняя редакция, Andry: 17.10.2017 11:44

Обратите внимание, что создание Модульного Пакета необходимо только в том случае, если вы хотите загрузить плагин в центр обновления вкладов.

Использование jMonkeyEngine SDK для разработки

  1. Установите Разработки подключаемых модулей NetBeans и NetBeans API Documentation с помощью Сервис ▸ Подключаемые модули
  2. Создадим новый проект Модуль (можете любое название, это будет ваша локальная коллекция создаваемых вами плагинов)
  3. Если ни одна платформа не указана, добавьте ее, выбрав папку приложения SDK
    • Пользователям Mac необходимо щелкнуть [ПК мыши] jmonkeyplatform application и выбрать «show contents», а затем выбрать папку jmonkeyplatform в разделе Contents/Resources/
  4. Откройте пакет, щелкните [ПК мыши] папку «Modules» и выберите «Добавить новое».
  5. Для «Название проекта» введите все строчные имена без пробелов, таких как моя библиотека
  6. Убедитесь, что «Местоположение проекта находится внутри папки пакета модулей и нажмите« Далее ».
  7. Введите базовый пакет java для вашего плагина в «Base Code Base», например com.mycompany.plugins.mylibrary
  8. Введите «Дисплейное имя модуля» для вашего плагина, например «Моя библиотека»
  9. Нажмите Готово
  10. Чтобы использовать основные функции SDK или jME3, добавьте «SDK Core и» SDK Engine через «Свойства модуля → Библиотека → Добавить зависимость

jMonkeyEngine SDK Contributions Update Center

Если вы хотите, чтобы ваш плагин появлялся в «Центре обновления вкладок jMonkeyEngine SDK», чтобы пользователи могли легко загружать, устанавливать и обновлять его через диспетчер плагинов, вы можете разместить свой плагин в хранилище svn-хранилища обновлений. Центр обновлений вкладов основан на проекте googlecode для предоставленных плагинов, который будет автоматически скомпилирован, помечен в соответствии с версией и добавлен в центр обновлений вкладов, такой как базовые модули jMonkeyEngine SDK.

Фактически его один большой модуль с несколькими модулями, каждый из которых представляет один плагин, библиотеку расширений.

Добавление вашего плагина в репозиторий

Чтобы добавить плагин в репозиторий, выполните следующие действия:

  • Убедитесь, что плагин является частью «Модульного пакета» и его расположено в папке пакета (это избавляет вас от проблем с svn и локальной версией, которые не настроены одинаково)
  • В «Свойства модуля → Источники
    • Установите «Source Level» равным 1.5, если это возможно (jMonkeyEngine SDK совместим с Java 1.5)
  • В «Свойства модуля» → «Версии API»
    • Установите версию спецификации для вашего плагина (например, 0.8.1)
    • Установите «версия реализации» на «0» и выберите «автоматически добавить версии реализации
  • В «Свойства модуля → Дисплей
    • Введите целевое описание вашего плагина и одну из следующих категорий:
      • Для библиотечного плагина: «jME3 — Библиотека
      • Для плагина SDK: «jME3 — плагин SDK
      • Для плагина модельного загрузчика: «jME3 — загрузчик
  • В «Свойства модуля → Сборка → Упаковка»
    • Добавьте свое имя
    • Добавить ссылку на ваш форум / домашнюю страницу, связанную с плагином
    • Добавьте лицензию, вы можете использовать ../license-jme.txt, чтобы вставить стандартную лицензию jME BSD или использовать текстовый файл, который вы храните в папке проекта
  • Попросите менеджеров или разработчиков получить доступ к проекту gc
  • Перенесите только проект модуля в магистраль:
    • Щелкните правой кнопкой мыши Project Module и выберите «Versioning → Import in Subversion Repository
    • Введите https://jmonkeyplatform-contributions.googlecode.com/svn/trunk в поле URL
    • Введите имя пользователя и пароль фиксации googlecode (иначе, чем пароль для входа, вы можете найти здесь свой пароль!) И нажмите «Далее».
    • Убедитесь, что папка «Репозиторий» — это соединительная линия / mypluginfolder и введите сообщение об импорте
    • Нажмите «Готово»

И вот, с этого момента каждый раз, когда вы вносите изменения в свой модуль, он будет автоматически создан и добавлен в центр вкладов, а номер версии будет расширен номером версии svn (например, 0.8.1.1234)

Создание обернутых файлов библиотеки jar на сервере

Вы можете просто локально создать свою библиотеку и обновить и перенести файл jar и javadoc / sources zip в папку release / libs вашего плагина в репозитории Contrib. Плагины пользователей будут автоматически обновляться с новыми файлами jar. Однако вы также можете создать проект библиотеки на сервере.

Как обычно на сервере строится только проект модуля, любые проекты, которые создают фактические файлы jar для плагинов библиотеки («обычные проекты из SDK / NetBeans»), должны быть построены из файла сборки модуля. Для этого просто добавьте следующие файлы муравьев в файл сборки модуля (приспосабливайтесь к файлам проекта и именам папок):

<target name="init" depends="basic-init,files-init,build-init,-javac-init,-build-subproject"/>
<target name="-build-subproject">
    <ant dir="./AI" inheritall="false" inheritrefs="false" target="clean"/>
    <ant dir="./AI" inheritall="false" inheritrefs="false" target="jar"/>
    <ant dir="./AI" inheritall="false" inheritrefs="false" target="javadoc"/>
    <zip basedir="./AI/dist/javadoc" file="release/libs/jME3-ai-javadoc.zip"/>
    <zip basedir="./AI/src" file="release/libs/jME3-ai-sources.zip"/>
    <copy file="./AI/dist/jME3-ai.jar" todir="release/libs"/>
</target>

Обратите внимание, что для того, чтобы номер версии модуля автоматически увеличивался при фиксации проекта библиотеки, проект библиотеки должен быть подпапкой основного проекта модуля.


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

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

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