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

jMonkeyEngine SDK: Развертывание приложений

Опубликованно: 13.08.2017, 18:42
Последняя редакция, Andry: 16.08.2017 18:09

После того, как вы написали и протестировали свою игру, вы хотите предоставить её как свой товар и распространять для своих покупателей. Если вы используете скрипт сборки игры, предоставляемый базовой jMonkeyEngine SDK, у вас есть следующие варианты развертывания:

  • Настольное Приложение (.JAR)
  • WebStart через URL (.JNLP + .JAR)
  • Applet в веб браузере (.JNLP + .JAR)
  • Android мобильного устройства (.APK)
  • iOS мобильного устройства (XCode проект)

Требования

Поскольку файлы JAR независимы от платформы, ваши клиенты могут запускать ваше приложение от jMonkeyEngine в Windows, Mac OS или Linux. Единственное требование состоит в том, что бы пользователь имел правильную версию бесплатного Java Runtime (или плагина браузера). Для получения дополнительной информации см. java.com.

Брендинг

jmonkey-branding

Сделайте игру уникальной и узнаваемой:

  1. Откройте ваш игровой проект в окне SDK Проекты.
  2. Щелкните [ПК мыши] ваш проект и выберите Свойства
  3. Открыв окно Свойства проекта выберите пункт Приложение. Здесь вы настраиваете свой брендинг:
    1. Заголовок: Введите название игры
    2. Поставщик: Введите свое имя (команды разработчиков)
    3. Описание: Напишите одну строку, о том почему ваша игра самая крутая из когда-либо созданных. 😉
    4. Домашняя страница: введите свой URL своего веб сайта чтобы ваши поклонники могли найти вас
    5. Заставка: Укажите крутой скриншот, который будет отображаться во время загрузки игры.
  4. Нажмите [ОК].
  5. Очистить и собрать проект.

Ваши исполняемые файлы теперь заклеймены.

TODO: где эта информация действительно появляется?

Создание распределяемого

deploy_android

Когда вы запускаете скрипт сборки, предоставляемый jMonkeyEngine SDK, он автоматически компилирует ваши классы, библиотеки и игровые ресурсы. Он создает папку dist в папке проекта, которая содержит исполняемый JAR и папку с библиотеками.

В простейшем случае вы архивируете папку dist и распространяете её в таком виде своим клиентам. Так же компании часто используют дополнительные инструменты для создания исполняемых файлов и инсталляторов.

Подробные сведения о вариантах развертывания:

Настольное приложение (JAR)

JAR файл является наиболее распространенным методом развертывания для настольных Java приложений. Пользователь загружает исполняемый JAR файл на свой компьютер и запускает его для запуска игры.

  1. Щелкните [ПК Мыши] свой проект и откройте Свойства проекта.
  2. В категории Приложение ▸ Web Start убедитесь, что флажок Включить Web Start не установлен. Нажмите [ОК].
  3. Щелкните [ПК Мыши] свой проект и выберите Очистить и собрать проект.
  4. Если сборка выполнена успешно, вы увидите строку, похожую на
    Building jar: /home/joe/jMonkeyPlatform/MySuperTestGame/dist/MySuperTestGame.jar

    Это означает, что исполняемый JAR успешно сгенерирован в папке вашего проекта.

  5. Заархивируйте папку dist и распространяйте её среди своих пользователей. Обязательно сохраните каталог lib находящийся в ней!

Большинство операционных систем выполнят JAR, если пользователи дважды щелкнет по нему, но вы также можете создать launcher.

Исполняемые файлы для рабочего стола (.EXE, .APP, .JAR)

JMonkeyEngine SDK позволяет создавать launcher для различных настольных платформ, таких как .exe файл для Windows систем, Приложение для MaxOSX и launcher для Linux систем.

  1. Щелкните [ПК Мыши] свой проект и откройте Свойства проекта.
  2. В категории Приложение ▸ Desktop установите флажки для платформ, для которых вы хотите распространять вашу игру.
  3. Нажмите [ОК].

Будет создана папка resources в папке проекта, содержащая шаблоны значков и файлы настроект для каждой выбранной платформы. Если вы измените один из них, отмена выбора развертывания на эту платформы больше не удалит этот файл ресурсов, и он не будет перезаписан при повторном включении развертывания на эту платформу.

Когда вы запускаете сборку своего проекта, в папке dist будут созданы zip-файлы для каждой выбранной платформы, содержащие все, что необходимо для запуска вашего приложения на каждой выбранной платформе.

Web Start (.JNLP)

Web Start позволяет пользователям запускать ваше приложение, просто щелкнув ссылку, которую вы предоставляете, например, кнопкой на вашей веб-странице. Браузер загружает JAR-файл, а затем автоматически запускает вашу игру в дополнительном окне. Единственное требование состоит в том, что в браузере пользователя должен быть установлен плагин Java. Это очень удобный способ для ваших клиентов играть в вашу игру без каких-либо дополнительных шагов по ее установке. При желании вы можете настроить его так, чтобы файл был сохранялся на компьютер и мог быть перезапущен позже, без необходимости выходить в сеть, чтобы поиграть.

  1. Щелкните [ПК Мыши] свой проект и откройте Свойства проекта.
    1. В категории Приложение ▸ Web Start установите флажок Включить Web Start.
    2. Установите флажок, чтобы задать приложению Подписать самостоятельно сгенерированным ключом. 😊
    3. При необходимости установите флажок, Разрешить выполнение в автономное режиме.
    4. Убедитесь, что дескриптор приложения активирован. Нажмите [ОК].
  2. Щелкните [ПК Мыши] свой проект и выберите Очистить и собрать проект. Создается каталог dist.
  3. Загрузите содержимое папки dist в общедоступный http-сервер
  4. Либо отредактируйте образец файла launch.html, либо просто добавьте стандартную ссылку (A HREF), указывающую на ваш .jnlp-файл на одной из ваших веб-страниц.
  5. Сообщите своим пользователям, что они могут запустить ваше приложение открыв страницу в веб-браузере, и нажав ссылку веб старта.

Посмотрите на образец launch.html, вы может сделать любой свой контент по ссылке. Сохраните копию своего файла запуска, потому что jMonkeyEngine SDK всегда будет восстанавливать свой файл launch.html по умолчанию. Также см. Это демонстрационное видео по созданию WebStarts.

Браузерный Applet

Браузерный Applet — это Java приложение, которое запускается в веб-браузере, когда пользователь посещает вашу веб-страницу. Единственное требование состоит в том, что в браузере пользователя должен быть установлен плагин Java. Не требуется шаг установки, пользователь может сразу играть в браузере. Пользователь не сможет сохранить игру на своем жестком диске, а также не может играть в офлайн-режиме.

В этих инструкциях предполагается, что вы уже создали игру, которую хотите превратиться в апплет. В отличие от других игр jME3, апплеты не могут захватить мышь для управления, поэтому камера переключится в режим dragToRotate. jMonkeyEngine SDK и встроенный скрипт сборки уже содержат то, что вам нужно.

Превратить проект в апплет

  1. Щелкните [ПК Мыши] свой проект и откройте Свойства проекта.
    1. В категории Приложение ▸ Applet установите флажок, Create Applet.
    2. Измените ширину и высоту апплета, на нужную вам.
    3. Нажмите [ОК].
  2. Щелкните [ПК Мыши] свой проект и выберите Очистить и собрать.

Папка dist/Applet теперь содержит все файлы, необходимые для запуска игры в качестве апплета. Чтобы протестировать игру на основе апплета, запустите проект в jMonkeyEngine SDK.

Развернуть игру как апплет

  1. Отредактируйте файл dist/Applet/run-applet.html. Просто сохраните код апплета.
  2. Загрузите содержимое каталога dist/Applet на общедоступный HTTP-сервер.
  3. Зайдите на run-applet.html через веб-браузера
  4. Нажмите на ссылку запуска вашего приложение.

Устранение проблем аплетов

  • Откройте консоль Java для сообщений об ошибках.
  • В зависимости от настроек ваш браузер кэширует апплет, html страницу и/или jnlp файл даже после того, как вы Очистили и собрали проект снова. Не забывайте очищать кеш браузера.

Мобильные Android устройства

Вы можете задать в jMonkeyEngine SDK создания исполняемого файла для мобильной платформы Android.

Подробнее о поддержке Android здесь.

iOS устройство

Вы можете задать в jMonkeyEngine SDK создания исполняемого файла для платформ iOS. Требуется Mac с установленным XCode.

Подробнее о поддержке iOS читайте здесь.

Совет: Переключение конфигураций сборки.

В jMonkeyEngine SDK есть меню Установить конфигурации проекта на панели инструментов. Используйте его для сохранения различных наборов конфигураций проекта и переключения между ними.

  1. Нажмите Установить конфигурации проекта на панели инструментов и выберите Настроить.
  2. Откроется раздел Выполнение. В разделе Конфигурация нажмите Создать.
  3. Назовите сохраненную конфигурацию, например, «my desktop app», или «development vs deployment». Нажмите ОК.
  4. Убедитесь, что новая конфигурация выбрана в окне Установить конфигурации проекта над редактором.
  5. Внесите изменения в свойства проекта, как описано выше.

Теперь вы можете использовать всплывающее меню Установить конфигурации проекта для переключения между вашими конфигурациями run/build.

Совет: Уменьшите размер файлов которые будете распространять.

Могут быть несколько библиотек jMonkeyEngine, которую вы даже не используете в своем приложении. Вы должны удалить соответствующие библиотеки из своего дистрибутива.

Чтобы удалить неиспользуемые библиотеки:

  1. Щелкните [ПК Мыши] свой проект и выберите Свойства
  2. Выберите Библиотеки
  3. Выберите все библиотеки и нажмите [Удалить].
  4. Нажмите кнопку [Добавить библиотеку]
  5. Выберите jme3-libraries-lwjgl — минимально необходимая библиотека
  6. Добавьте и другие библиотеки jME3 таким же образом, в зависимости от того, какие функции вы используете:
    Jme3-libraries-gui, jme3-libraries-physical, jme3-libraries-video и.т.д.
  7. Нажмите ОК.
  8. Очистите, Соберите и Запустите проект. И убедитесь что вы ничего не пропустили.

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

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

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