Вторник, 2024-03-19, 5:31 PM

Поиск
Меню
Категории раздела
Поддержи проект!
Рекомендуем


Ручная настройка проекта

Эта статья описывает настройку Eclipse для разработки и запуска libgdx приложения на компьютере и Android.

Замечание: в настоящий момент Java 1.7 вызывает проблемы на Android. Пожалуйста убедитесь, что ваш проект использует Java 1.6. Рекомендуется использовать setup-ui, если вы хотите развертывать приложение на iOS.

Настройка основного или главного проекта

  1. Создайте в Eclipse новый Java проект. File -> New -> Project -> Java Project. Дайте соответствующее название и нажмите Finish.
  2. Перейдите в директорию проекта в файловой системе и создайте поддиректорию с именем libs. Скачайте nightly архив и положите gdx.jar и gdx-sources.jar в libs директорию.
  3. Обновить проект в Eclipse нажатием правой кнопкой мыши на проекте и выберите Refresh (F5). Снова нажатием правой кнопкой мыши на проекте и выберите Properties, далее Java Build Path -> Libraries -> Add Jars, выберите gdx.jar и нажмите OK.
  4. Здесь же под gdx.jar файлом выполните двойное нажатие мыши на «Source attachment», далее нажмите Workspace, выберите gdx-sources.jar и нажмите OK.
  5. Выберите вкладку Order and Export, отметьте gdx.jar и нажмите OK.
Замечание: шаг 5 позволяют сделать gdx.jar прозрачно зависимым. Это означает, что проекты зависящие от главного также будут иметь gdx.jar в своем classpath. Однако, это не работает для Android проекта.

Настойка Desktop проекта

  1. Создайте в Eclipse новый Java проект. File -> New -> Project -> Java Project. Дайте соответствующее название (например gamename-desktop) и нажмите Finish.
  2. Перейдите в директорию проекта в файловой системе и создайте поддиректорию с именем libs. Из nightly архива положите gdx-natives.jar, gdx-backend-lwjgl.jar и gdx-backend-lwjgl-natives.jar в libs директорию.
  3. Обновить проект в Eclipse нажатием правой кнопкой мыши на проекте и выберите Refresh (F5). Снова нажатием правой кнопкой мыши на проекте и выберите Properties, далее Java Build Path -> Libraries -> Add Jars, выберите эти тир JAR файла и нажмите OK.
  4. Выберите кладку Project, нажмите Add и отметьте основной проект и нажмите OK.

Настройка Android проекта

Перед следующими шаги сначала должен быть установлен Android SDK.

  1. Создайте в Eclipse новый Android проект. File -> New -> Project -> Android Application Project. Дайте соответствующее название (например gamename-android). При выборе build target отметьте Android 1.5. Укажите имя пакета (например com.gamename). Далее при создании Activity введите AndroidGame. Нажмите Finish.
  2. Перейдите в директорию проекта в файловой системе и создайте поддиректорию с именем libs. Из nightly архива положите gdx-backend-android.jar и armeabi and armeabi-v7a в libs директорию.
  3. Обновить проект в Eclipse нажатием правой кнопкой мыши на проекте и выберите Refresh (F5). Снова нажатием правой кнопкой мыши на проекте и выберите Properties, далее Java Build Path -> Libraries -> Add Jars, выберите gdx-backend-android.jar и нажмите OK.
  4. Снова нажмите Add JARs, выберите gdx.jar под основным проекта и нажмите OK.
  5. Выберите вкладку Projects, нажмите Add, отметьте основной проект и нажмите OK дважды.
  6. Выберите вкладку Order and Export, отметьте основной проект.
Замечание: директория libs не должна иметь другого названия, это обусловлено соглашением для Android Eclipse плагина.

Настройка asset директории

Android проект имеет поддиректории с именем assets, которая создается автоматически. Файлы в этот директории доступны Android приложению. Это вызывает проблему, потому что эти же самые файлы должны быть доступны и Desktop приложению. Вместо того чтобы делать копию все файлов, нужно настроить Descktop проект, чтобы он нашел assets в Android проекте.

  1. Нажатием правой кнопкой мыши на проекте и выберите Properties, далее Java Build Path. Выберите вкладку Source и нажмите Link Source, далее нажмите Browse, выберите assets директорию Android проекта и нажмите OK.
  2. Укажите assets в качестве имени директории и нажмите Finish и затем OK.
Замечание: Если Desktop и Android проекты находятся в одно и той же директории, то вы может использовать «PARENT-1-PROJECT_LOC/gamename-android/assets» локацию для связанной assets директории, где «gamename-android» имя вашего Android проекта. Это лучше чем hard-coded путь если планируете иметь общих доступ или разделять проект для других проектов.

Создание игры

В вашем главном проекте создайте новый класс. Нажмите правой кнопкой мыши на проекте Project -> New -> Class. Назовите класс «Game» и укажите пакет (например com.gamename). Далее укажите интерфейс ApplicationListener и нажмите OK. Класс будет выглядеть примерно так:

import com.badlogic.gdx.ApplicationListener;

public class Game implements ApplicationListener {
       public void create () {
       }

       public void render () {
       }

       public void resize (int width, int height) {
       }

       public void pause () {
       }

       public void resume () {
       }

       public void dispose () {
       }
}
Такой метод позволяет настроить и визуализировать игру. Так как ничего нет, то игра покажет пустой экран. Для начала мы запустим игру, прежде чем переходит к чему-нибудь более интересному.

Запуск игры на Desktop

Нажмите правой кнопкой мыши на Desktop проекте Project -> New -> Class. Назовите класс DesktopGame и укажите пакет (например com.gamename). Созданный класс выглядит так:

import com.badlogic.gdx.backends.lwjgl.LwjglApplication;

public class DesktopGame {
       public static void main (String[] args) {
                new LwjglApplication(new Game(), "Game", 480, 320, false);
       }
}
Этот код создает LwjglApplication, давая экземпляр вашей игр, название и размер. Параметр false означает, что не используем OpenGL ES 2.0, а используем 1.0/1.1.

Чтобы запустить игры на Desktop, нажмите правой кнопкой мыши на проекте Project -> Debug As -> Java Application. Вы должны получить в результате черное окно с заголовком «Game».

Запуск игры на Android

Откройте в Android проекте AndroidGame класс, который был создан автоматически и выглядит так:

import com.badlogic.gdx.backends.android.AndroidApplication;

public class AndroidGame extends AndroidApplication {
       public void onCreate (android.os.Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                initialize(new Game(), false);
       }
}
Этот код представляет Android Activity, которая инициализируется передавая экземпляр вашей игры. Вновь параметр false означает, что не используем OpenGL ES 2.0

Чтобы запустить игры на Android, нажмите правой кнопкой мыши на проекте Project -> Debug As -> Android Application. Экран будет черным, так как в игре ничего не происходит. Если во время запуска приложения произойдут ошибки, то они будут показаны в Logcat просмотре, который можно просмотреть нажимая Window -> Show View -> Other -> Android -> Logcat.

Обновление libgdx

В некоторых случаях вы захотите обновить libgdx до последней версии. Чтобы сделать это скачайте nightly архив и обновите следующие файлы в ваших проектах.

ПроектФайлы
Основнойlibs/gdx.jar
libs/gdx-sources.jar
Androidlibs/gdx-backend-android.jar
libs/armeabi (directory)
libs/armeabi-v7a (directory)
Desktoplibs/gdx-natives.jar
libs/gdx-backend-lwjgl.jar
libs/gdx-backend-lwjgl-natives.jar