О структуре базового проекта

Структура шаблона проекта cocos2d. Часть 1

В прошлом уроке мы создали наш первый проект и запустили его.

Теперь давайте поговорим о том, какова структура проекта, основанного на cocos2d.

Вот список файлов нашего проекта, доступный в левой панели XCode:

Все, что нас интересует, лежит в группе "HelloWorld" - заметьте, "папки" в XCode называются группами, т.к. физически почти все файлы лежат в одной и той же папке, а вот логически они организуются в группы. Эта организация видна только в XCode.

Начнем с конца :) В группе Supporting Files находятся main.m - "стартовая точка" программы, которую вам наврядли придется модифицировать - и Prefix.pch - файл, содержащий список хэдеров для прекомпиляции. По сути, это необходимо для ускорения компиляции программы.

В этот файл обычно добавляют хэдеры фреймворков, код которых редко меняется в течение разработки программы, поэтому мы можем открыть Prefix.pch и после строчки

#import <Foundation/Foundation.h>

добавить:

#import "cocos2d.h" 

Идем далее.

В группе libs находится сама библиотека cocos2d и ряд вспомогательных библиотек. Исходный код этих библиотек вам доступен и вы всегда можете обратиться к нему. Правда, будьте аккуратны и ничего в нем не меняйте - или меняйте, но только если уверены и обладаете достаточным опытом.

В группе "Resources" хранятся файлы-ресурсы - то есть изображения, музыка и т.д.

В нашем случае, Default.png - экран, отображаемый при запуске приложения, Icon-* - файлы иконок, Info.plist - файл конфигурации (о нем в других постах) и т.д.

Наконец, все остальные файлы в папке HelloWorld (AppDelegate, RootViewController, HelloWorldLayer, GameConfig) - классы самого приложения.

AppDelegate - это класс, который присутствует в каждом iOS-приложении. Он отвечает за реакцию на различные глобальные события, которые операционная система посылает нашему приложению - например, о входящем звонке, о малом количестве памяти, о том, что пользователь собирается свернуть приложение и т.д.

Самое первое сообщение, которое посылается нашему приложению - applicationDidFinishLaunching - и именно здесь инициализируется библиотека cocos2d и вообще все, необходимое для работы программы. Больше о событиях, посылаемых приложению, можно узнать из документации Apple.

Большинство кода в этом классе вам никогда не придется менять.

Но есть несколько строк, которые вы, возможно, захотите поменять:

#if GAME_AUTOROTATION == kGameAutorotationUIViewController

[director setDeviceOrientation:kCCDeviceOrientationPortrait];

#else

[director setDeviceOrientation:kCCDeviceOrientationLandscapeLeft];

#endif

[director setAnimationInterval:1.0/60];

[director setDisplayFPS:YES];

Сначала мы вызываем метод setDeviceOrientation для установки ориентации устройства.

Вы можете менять ориентацию на нужную вам, передавая одно из следующих значений:

• kCCDeviceOrientationPortrait - вертикальная ориентация, кнопка "Home" внизу
• kCCDeviceOrientationPortraitUpsideDown - вертикальная ориентация, кнопка "Home" вверху
• kCCDeviceOrientationLandscapeLeft - горизонтальная ориентаци, кнопка "Home" справа
• kCCDeviceOrientationLandscapeRight - горизонтальная ориентаци, кнопка "Home" слева

Ради интереса, предлагаю вам попробовать изменить код и перезапустить проект.

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

Далее, метод setAnimationInterval устанавливает, как часто будет обновляться экран - то есть, фактически, здесь мы задаем, какой ФПС (fps = frames per second, кадры в секунду) мы хотим.

По умолчанию, это значение равно 60, то есть экран будет перерисовываться каждую 0.0167 секунды.

В сложных играх, вычисления могут занимать больше времени, поэтому есть шанс, что реальное значение ФПС будет меньше - но это ваша задача, как разработчика, чтобы частота показа кадров была высокой. Иногда, лучше выставить здесь 1.0/30, то есть 30 кадров в секунду, чтобы добиться плавной анимации.

Важно отметить, что на iOS-устройствах невозможно выставить более 60 кадров в секунду - на более высоких значениях, в лучшем случае, вы не увидите изменений, а в худшем случае будут заметны торможения.

Наконец, метод setDisplayFPS задает, отображать ли текущую частоту показов кадра на экране.

Разумеется, имеет смысл выставлять YES при отладке приложения и NO при выпуске "в мир".

Опытные разработчики советуют ставить 60 кадров в секунду для экшн-игр, тогда как 30 кадров в секунду будет достаточно для казуальных игр типа паззла или пасьянса.

Для изменения частоты отображения FPS на экране устройства нужно поменять константу 

CC_DIRECTOR_FPS_INTERVAL, которая находится в файле ccConfig.h в группе cocos2d - по умолчанию, значение фпс изменяется 10 раз в секунду (значение CC_DIRECTOR_FPS_INTERVAL = 0.1) - чем меньше значение, тем чаще обновляется информация о фпс.

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

Иллюстрации и примеры кода взяты из книги Learn cocos2d Game Development with iOS 5.

Посетите также блог автора книги ("Learn Cocos2d", Steffen Itterheim)