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

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

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

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

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

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


Центр Обновлений Вкладов jMonkeyEngine SDK

Если вы хотите, чтобы ваш плагин появлялся в «Центр Обновлений Вкладов 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»), должны быть собраны из файла сборки модуля. Для этого просто добавьте следующие ant цели в файл сборки модуля (приспосабливайтесь к файлам проекта и именам папок):

<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. Все права сохранены.