libGDX: Введение

Начиная с libGDX работать, уже тогда подумал над написанием туторила по этой библиотеке. Когда начал освещать процесс написания игры, то вопросы посыпались на мыло и в твиттер по некоторым аспектам разработки. Так что, начнём. Список всех статей (да и какие-нибудь другие материалы) буду размещать на странице о libGDX. В новом уроке будет использоваться исходник предыдущего и что-то дописываться.

Сама страница проекта code.google.com/p/libgdx/. Так же можно посмотреться список игр разработанных на libgdx.

Для связи и для поиска материалов:

Forum: http://badlogicgames.com/forum

IRC: irc.freenode.net, #libgdx

Подготовка к разработке

Предполагается, что окружение у вас уже настроено. Если нет, почитайте о настройке связки Eclipse+ADT+JDK+Android SDK. Качаем с отсюда libgdx-nightly-latest.zip, распаковываем куда-нибудь. Создаём новый проект.

  1. Eclipse: File -> New -> Project -> Android Application Project. Имя проекта Libgdxtutorial. Package Name suvitruf.libgdxtutorial. SDK лучше выбирать поменьше. Я лично выбираю Android 2.1 с API 7.
  2. Дальше можно оставить всё по умолчанию. Тогда у вас главным Activity будет MainActivity.
  3. Если ещё нету в проекте папки libs, создайте её (правой кнопкой мыши по проекту -> New -> Folder.
  4. Открывайте папку, куда вы распаковали архив libgdx-nightly-latest.zip. Скопируйте файлы gdx.jar, gdx-backend-android.jar и папки armeabi-v7a, armeabi в нашу папку libs. Можно просто перетащить их в дерево проекта, Eclipse предложить их скопировать, жмите ОК.
  5. Дерево проекта обновится, если нет, то нажмите правую кнопку мыши -> Refresh. Затем жмите по проекту ПКМ и выбирайте Properties -> Java Build Path -> Libraries -> Add JARs, выбирайте gdx-backend-android.jar и gdx.jar.
  6. Java Build Path - Libraries - Add JARs

  7. В Properties -> Java Build Path -> Order and Export выберите эти два файла.
  8. Java Build Path - Libraries - Order and Export

  9. Добавьте новый класс, назовите MyGame. Замените содержание файла на:
  10. package suvitruf.libgdxtutorial;
    import com.badlogic.gdx.Game;
    public class MyGame extends   Game  {
    	
      @Override
      public void create() {
    
      }
    }
    
  11. Откройте MainActivity. Заменяем весь код в файле на:
  12. package suvitruf.libgdxtutorial;
    import com.badlogic.gdx.backends.android.AndroidApplication;
    import android.os.Bundle;
    
    public class MainActivity extends AndroidApplication {
    	
        /** Called when the activity is first created. */
        @Override
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            AndroidApplicationConfiguration config = new AndroidApplicationConfiguration();
            config.useAccelerometer = false;
    	config.useCompass = false;
    	config.useWakelock = true;
    	config.useGL20 = true;
    	
    	initialize(new MyGame(), config);	
        }
        	 
    }
    
  13. Откройте файл манифеста и добавьте разрешение:
  14.  <uses-permission android:name="android.permission.WAKE_LOCK"/>
    

    Если не добавите, то получите ошибку java.lang.RuntimeException: Unable to resume activity. Это разрешение даёт доступ к PowerManager и ошибки не будет.

  15. Запускайте как Android Application. На экране будет просто чёрный экран.

Собственно всё. Для введения хватит. Можете скачать исходники урока Libgdxtutorial-introduction.rar. В следующей статье расскажу о жизненном цикле игры.

  Категории: java, libgdx, Коддинг
  • Pingback: libGDX: Часть 1. Жизненный цикл игры | Suvitruf's Blog()

  • Pingback: libGDX: Часть 2. Архитектура игры | Suvitruf's Blog()

  • Ali

    Создание игр будет для андроид, или для ПК(в смысле под винду линукс и т.п)

    • http://suvitruf.ru Suvitruf

      Java кроссплатформенная -.-

      • Anon

        Но его вопрос корректен. Ведь игры на andEngine не получится запустить на ПК, например. Ява кроссплатформенна, но на каждой платформе могут быть какие-нибудь платформозависимые библиотеки.

        • http://suvitruf.ru Suvitruf

          Все стандартные библиотеки есть в jre же.

  • Serge

    Добавьте, что libgdx можно отлаживать на x86 образе, правда с некоторыми костылями

  • Serg

    Как подключить source и javadoc для либы?

    • http://suvitruf.ru Suvitruf

      Project/Generate Javadoc

      Javadoc command это путь к файлу javadoc.exe.
      ..\Java\jdk1.5.0\bin\javadoc.exe.

      Всё.

  • http://dedfox.com Yuriy

    Видео создание нового проекта Libgdx в Intellij Idea( или Андроид Студии)
    http://www.youtube.com/watch?v=HxRoyk4ypJM

  • http://4ko.ru Тимофей

    Видео отличное. Спасибо. Но не могу установить новую версию Libgdx в Intellij Idea.

    • http://suvitruf.ru Suvitruf

      Они от версии к версии всегда что-нибудь ломают =/

      • Тимофей

        я сам ошибся, если делать все как в видео то все отлично работает в Intellij Idea.

  • avex

    Привет! Спасибо за уроки. У меня появились ошибки, хотя делаю все точно по уроку.
    Подчеркивает в MyGame – suvitruf.libgdxtutorial, пишет – The declared package “suvitruf.libgdxtutorial” does not match the expected package “”
    А MainActivity ругает AndroidApplicationConfiguration – пишет AndroidApplicationConfiguration cannot be resolved to a type. Здесь же в 17 строке подчеркивает MyGame – MyGame cannot be resolved to a type.
    Помогите разобраться. Не очень приятно – все ведь по уроку, а тут бьют по рукам.

    • http://suvitruf.ru Suvitruf

      Вы качали исходники мои или сами делали?

      • avex

        Если о libgdx – то с их сайта. А код весь из этой статьи.

        • http://suvitruf.ru Suvitruf

          Мой код работает на старой версии либы. А они в каждом новом билде что-нибудь всегда меняют.

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

          • avex

            Сложности подстерегают на каждом ходу) А как мои решить?

    • http://suvitruf.ru Suvitruf

      Вообще, вроде можно и без AndroidApplicationConfiguration запустить:
      initialize(new MyGame(), false);

      А другая ошибка…У вас имя пакета и Application ID в манифесте какие?

      • avex

        Проверил – те же ошибки, плюс в следующих строках все в подчеркиваниях.
        Наверное, тут важно принципы понять.
        Есть еще вариант – если это возможно), поставьте последнюю версию и добавьте изменения. Так и начинающим будет полезно. Ведь старые версии они вряд ли будут использовать, если предлагаются новые.

      • avex

        Имена – везде как Вы и предлагали – suvitruf.libgdxtutorial

  • avex

    Дружище, очень жду ответа, потому что и по их вики есть ошибки – https://code.google.com/p/libgdx/wiki/SimpleApp – видимо они писали урок к более ранним версиям библиотеки.

  • Сергей

    С текущей версией libgdx всё нормально собирается по инструкции, но на телефоне в момент запуска крешится.
    На сайте libgdx есть видео по созданию проектов. Следуйте ему и всё получится. Вот ссылка:
    http://libgdx.badlogicgames.com/documentation.html

    Большое спасибо за руководство! На днях буду изучать.

    • Сергей

      И ещё такой момент. Когда создал проекты, как показано на видео, во время импорта их в Eclipse у меня были ошибки что-то вроде “… android-19″.
      Для решения нужно в свойствах андроид-проекта (ПКМ->Properties) выбрать скаченную ранее версию Android SDK (выберите Android и там поставьте галочку возле имеющегося SDK).

  • Ash

    Интересно вариант генерации проекта самим libgdx не рассмотрен из-за того что тогда его еще не было? если да, то будет ли актуальным дальнейшие статьи из этого цикла?

    • http://suvitruf.ru Suvitruf

      В ближайшее время нет, так как нынешнюю игру пишем на Unity3D )

  • Алекс

    Помогите плз, решить пробему –

    AndroidApplicationConfiguration config = new AndroidApplicationConfiguration();
    AndroidApplicationConfiguration cannot be resolved to a type

    все делал по инструкции.
    Хелп, плз.

    • http://suvitruf.ru Suvitruf

      Если последнюю версию используете либы, то возможно там что-то поменяли.

  • Жека

    Все сделал как вы описали! Eclips ругается на config.useGL20 = true; говорит что useGL20 вообще не существует(

    • http://suvitruf.ru Suvitruf

      А версия либы какая? Я уже писал, что в новых версиях они могли много чего поменять =/

      • Жека

        да, они видимо полностью автоматизировали выбор GL без config.useGL20 = true; работает) но только на реальном устройстве, на эмуляторе завершает работу приложения, версия android 2.3.3

        • http://suvitruf.ru Suvitruf

          А с какой ошибкой? На 2.3 устройствах многие экстеншены из OpenGL 2.0 не работают. Из-за этого может падать.
          Многие старые устройства 2.0 вообще не поддерживают)

          • Жека

            Куча всего, вот Caused by: java.lang.RuntimeException: Libgdx requires OpenGL ES 2.0 одна из всех, все я думаю не стоит в комментарии вставлять!

          • Жека

            у вас есть более ранние версия Libgdx, с которыми у вас не возникали такие проблемы, если да оставите пожалуйста ссылку)

  • https://play.google.com/store/apps/details?id=com.nikitin.turtle.jump Игорь Игорь Никитин

    хочу поддержать Ваш проект,только не знаю как это сделать.

    • http://suvitruf.ru/ Андрей

      Лучшая поддержка – это то, что статьи кому-то полезны)