В этом учебном руководстве вы узнаете, как создать простую игру с помощью платформы Cocos2d-x 3.0 или более поздней версии в среде разработки Windows*, а также как скомпилировать игру для запуска под Windows и Android*.
Что такое Cocos2d-x?
Cocos2d-x — это межплатформенная платформа для игр (и других графических приложений, например интерактивных книг) на базе cocos2dдля iOS*, но с использованием C++, JavaScript* или Lua* вместо Objective-C*.
Одним из преимуществ этой платформы является создание игр, которые можно развертывать в различных операционных системах (Android, iOS, Win32, Windows* Phone, Mac*, Linux* и пр.), сохраняя одну и ту же базу кода, внося необходимые небольшие доработки для каждой ОС.
Консоль Cocos2d-x
Консоль cocos2d появилась в версии 3.0. Это программа командной строки, предоставляющая определенные функции управления проектами Cocos2d-x или Cocos2d-JS: можно создавать проекты, запускать их, собирать, отлаживать и т. д.
Создание вашей первой игры
1 - Загрузите последнюю версию платформы и распакуйте ее в среду разработки. В этом учебном руководстве использовалась версия 3.3rc0, платформа была распакована на рабочий стол (C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0).
Рисунок 1.Структура папок Cocos2d-x версии 3.3 RC0
2. Чтобы создать новый проект в cocos2d-x, используйте setup.py (сценарий на языке Python*), расположенный в папке платформы, для настройки всех переменных среды, необходимых для сборки приложений для Win32 и Android. Перед запуском setup.py нужно загрузить, установить и настроить перечисленные ниже компоненты.
Если еще не установлена среда выполнения Python, загрузите версию 2.7.6 здесь: http://www.python.org/download/
Figure 2.setup.py location
3. Откройте командную строку (cmd.exe) и выполните следующие команды.
- Перейдите в папку сценария (папку платформы).
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
- Запуститесценарийsetup.py.
python setup.py (илипросто setup.py)
Примечание. Для запуска команд Python в командной строке добавьте папку, в которой установлен Python, в переменную среды пути..
- Сценарий запросит пути установки Android SDK, Android NDK и ANT.
- Путь к папке Android NDK
Рисунок 3.Консоль Cocos2d запрашивает путь к папке NDK
- Путь к папке Android SDK
Рисунок 4.Консоль Cocos2d запрашивает путь к папке SDK
- Путь к папке bin пакета Apache ANT
Рисунок 5.Консоль Cocos2d запрашивает путь к папке bin пакета ANT
После указания запрошенных путей снова откройте командную строку (cmd.exe). Это действие необходимо для использования консольных команд cocos2d.
4. Введите cmd.exe, чтобы открыть командную строку (команды консоли cocos2d можно выполнять только там), и снова откройте папку платформы.
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
На следующем этапе мы создадим новый проект Cocos2d-x.
cocos new MyGame –p com.Project.MyGame –l cpp –d Project
Рисунок 6.Созданный проект Cocos2d-x
Вот краткое описание параметров.
- new: создание нового проекта; после этого параметра необходимо указать имя проекта (в данном случае — MyGame).
- -p: задает имя пакета.
- -l: выбор языка программирования. Допустимые значения: cpp или lua.
- -d: папка, в которой платформа создаст структуру проекта.
Если все сработало без ошибок, проект будет создан в папке Project внутри папки, в которую была распакована платформа.
Рисунок 7.Структура папок MyGame
Созданный проект содержит базу кода игры (Classes), ресурсы (изображения, звук и т. д.) и по одному проекту для каждой поддерживаемой платформы.
Сборка приложений для Android*
Требования.
- Нужно настроить все переменные среды для сборки игровых приложений для Android (Android SDK, Android NDK и ANT). Если это еще не сделано, см. раздел «Создание вашей первой игры» в этой статье.
- Установите Java Development Kit (JDK)
Примечание. Консоль Cocos2d использует команду javac для сборки для Android, поэтому нужно добавить переменную среды JAVA_HOME (путь к JDK).
1. Нужно скомпилировать игру для нескольких архитектур, поскольку платформа по умолчанию не компилирует для архитектур x86 и armeabi-v7a. Отредактируйте файл Application.mk, находящийся в папке.
C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0\Project\MyGame\proj.android\jni
Рисунок 8.Расположение файла Application.mk
2. Добавьте в этот файл следующую строку.
APP_ABI := armeabi armeabi-v7a x86
Рисунок 9.Файл Application.mk последобавлениястроки APP_ABI
Мы добавили архитектуры назначения, теперь пора перейти к компиляции игры.
3. С помощью командной строки перейдите в папку платформы.
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
4. Выполните приведенную ниже команду, чтобы скомпилировать и запустить игру для Android.
cocos run –s Project\MyGame –p android
Рисунок 10.Выполнение команды для компиляции и запуска игры для Android*
- run: компиляция и запуск проекта.
- -s: путь к папке проекта.
- -p: выбранная платформа.
Примечание. Чтобы только скомпилировать проект, не запуская его, введите команду
cocos compile –s Project\MyGame –p android
Если все сработает без ошибок, команда cocos2d-consoleбудет использовать adb (если настроены нужные переменные среды) для установки файла APK на подключенное устройство или в инициализированный эмулятор. Если они недоступны, команда будет ожидать доступности устройства или эмулятора, как показано на приведенном ниже рисунке.
Рисунок 11.Команда ожидает устройства или инициализированного имитатора
После инициализации эмулятора или подключения устройства появится следующее окно.
Рисунок 12.Экран игры на платформе Android*
Создание приложений для Win32 Apps (для Windows* 7 или классического режима Windows* 8)
Для сборки требуется Visual Studio* 2012или более поздней версии
1. В командной строке (cmd.exe) перейдите в папку, куда была распакована платформа:
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
2. Выполните следующую команду для компиляции и запуска игры для Windows:
cocos run –s Project\MyGame –p win32
Рисунок 13.Выполнение команды для компиляции и запуска игры для Windows*
Вот краткое описание параметров.
- run: компиляция и запуск выбранного проекта.
- -s: путь к папке проекта.
- -p: выбранная платформа.
Примечание. Чтобы только скомпилировать игру, но не запускать ее, используйте команду compile вместо команды run:
cocos compile –s Project\MyGame –p win32
После выполнения команды run, если все сработало без ошибок, появится следующее окно.
Рисунок 14.Экран игры на платформе Windows*
Также можно скомпилировать и запустить проект игры с помощью Visual Studio.
1. В папке Project откройте в Visual Studio файл MyGame.sln, находящийся в папке proj.win32.
Рисунок 15.Структура папок проекта Win32
2. Для компиляции проекта нажмите клавишу F6 (или выберите в меню «Сборка» -> «Собрать решение»), затем нажмите клавишу F5 для запуска (или выберите в меню «Отладка» -> «Начать отладку»). После сборки и запуска должно появиться такое же окно, как после использования консоли.
Рисунок 16.Проект Win32 в Visual Studio*
Итак, теперь вы знаете, как создать игру и скомпилировать ее для Android (x86 и ARM*), Windows 7 и классического режима Windows 8.
Справочные материалы
Исходный код платформы Cocos2d-x распространяется по лицензии МТИ, его можно получить здесь.
Cocos2d-x и документация: http://www.cocos2d-x.org/
cocos2d-console: http://www.cocos2d-x.org/wiki/Cocos2d-console
Примечание
На момент написания этой статьи в финальной версии Cocos2d-x 3.3 была ошибка на этапе создания проектов, не позволяющая пользователям создавать проекты (подробнее
см. здесь). Эта проблема была исправлена в последнем предварительном выпуске, но в финальной версии Cocos2d-x она пока осталась.