Итак, мы настроили окружение и готовы создавать первое приложение с LibGdx. Для этого вначале скачаем сам фреймворк. Сделать это можно здесь – http://libgdx.badlogicgames.com/download.html. И нам на выбор предлагают два варианта:
- Качать Release – стабильную версию, которая не содержит багов и точно “готова к употреблению”
- Качать Nightly build – последняя сборка, которая еще не прошла стадию тестирования. Разработчики не гарантируют 100% работоспособности всех фичей, но эта сборка кандидат на release.
В принципе, особой разницы скорее всего не окажется, но рекомендую качать стабильный Release. И обновлять потом его. Благо, разработчики позаботились о хорошем интерфейсе для обновлений.
Итак, скачали мы zip файл. Посмотрим, что там внутри. Среди обилия .jar файлов и лицензий находим gdx-setup-ui.jar. Это приложение позволяет создаватьобновлять проекты для LibGdx:
Я думаю, что на этом экране все ясно. Так как мы хотим создать новый проект, то жмем Create и переходим в настройки будущего проекта. Тут подробнее:
1. Configuration
Здесь мы зададим названия нашего приложения и папку, в которой проект будет храниться:
- Name – название игры. Может быть любым.
- Package – любое приложение в Play Market характеризуется названием корневого пакета. Это может быть, например, com.eney.HelloWorld. Или любое другое, соответствующее формату название.
- Game Class – название класса, который будет отвечать за запуск игры.
- Desctination – папка, в которой будет находиться проект. Указываем любую (желательно, пустую) папку.
- Далее чекбоксами можно отметить, под какие платформы мы хотим портировать приложение в будущем. Core project будет содержать логику приложения. Android project будет содержать корневую Activity Android приложения. Эти два проекта являются обязательными для создания. Аналогично работают остальные галочки – создают файлы-заготовки для других платформ. Я пока оставил Android и Desctop. Далее увидим, для чего.
2. Library Selection
Здесь задаются библиотеки, который мы будем включать в свой проект. По умолчанию и обязательно мы включаем туда сборку LibGdx (так же сбоку от библиотеки есть кнопки, который позволяют посмотреть информацию о библиотеке, посмотреть файлы библиотеки, обновить билд). При сетапе первого проекта нужно скачать сборку LibGdx и других, включаемых в проект библиотек.
Так же можно включать в проект java-библиотеки третьих лиц. Подробнее о том, какие библиотеки можно и нужно использовать в проекте, я рассмотрю в следующей статье. Пока в двух словах.
- Physics Body Editor loader – библиотека, которая позволяет работать с физическими моделями (LibGdx реализует физическую модель Box2D).
- Universal Tween Engine – очень хорошая библиотечка, которая позволит делать анимацию объектов. У нее есть отличная демка на Play Market – https://play.google.com/store/apps/details?id=aurelienribon.tweenengine.demo, а так же демка для Windows – http://code.google.com/p/java-universal-tween-engine/downloads/detail?name=tween-engine-demo-6.3.0.zip
В общем, для Hello World они нам не пригодятся. Можно не включать их в проект.
3. Overview
Показывает просто те файлы, которые будут для нас созданы.
Идем далее -> Open generation screen -> Launch! -> Далее “магические” алгоритмы сделают нам проекты, а наша задача зайти в Eclipse и импортировать их в IDE для работы.
Для этого в Eclipse для начала меняем наш Workspace (так удобнее работать с проектом).
Заходим в File -> Switch Worckspace -> Other… И выбираем папку, в которую мы сгенерировали проекты. Eclipse перезагрузится и, возможно, скажет, что Android SDK не был указан для этого Workspace’а.
Исправляем это легко. Заходим в Window -> Preferences -> Android. И в SDK Location указываем папку, в которой у нас находится Android SDK.
Теперь в IDE нужно импортировать непосредственно проекты. Для этого идем сюда: File -> Import -> General -> Existing projects into Workspace -> Next. Выбираем папку нашего workspace’а. И снова Next. Должно появиться окно, в котором есть перечень проектов, который для нас сгенерировал gdx-ui. Примерно такой:
Убеждаемся, что галки стоят напротив всех проектов и нажимаем Finish.
У нас появились слева в навигаторе три проекта:
- MyHelloWorld – содержит полностью весь код, который используется в проектах -android, -desctop
- MyHelloWorld-android – проект, который можно собрать для девайса, работающего под Android.
- MyHelloWorld-desktop – проект, который быстро можно собрать для Windows.
При этом все ресурсы (текстуры, картинки, шрифты, аудио и пр.) находятся в папке assets проекта -android. Проект -desktop иcпользует их же.
Попробуем собрать приложение для Windows. Для этого нажмем правой кнопкой мыши по “MyHelloWorld-desktop”, выберем Rub As -> Java Application -> Выбираем класс Main и жмем OK. В итоге получим первое полноценное java-приложение для Windows:
Чтобы собрать приложение под Android. Жмем правой кнопкой мыши на проекте “MyHelloWorld-android”, выбираем Run As -> Android Application. После компиляции нужно выбрать на какой девайс (или симулятор) отправлять исполняемый .apk и в итоге на девайсе мы получим такое же приложение.