如何在WP8上搭建cocos2d-x的游戏开发环境-超级忍者龟-ChinaUnix博客

分类： Windows平台

2015-07-22 23:49:20

Overview

Cocos2d-x 可能是目前最流行的2D手机游戏引擎，它是开源的 Cocos2d-iphone项目的C++版本；支持多平台，包括iOS、Android、Windows Phone8、BlackBerry等，并还在不断更新和发展中；

WP8是微软公司最新一代的手机操作系统，由于采用和Win8相同的NT内核并拥有多项有别于iOS、Android的优点，使得它发展迅速。目前已拥有超过17万个应用，并且数量还在不断增加中。现在看来越来越多的开发者包括游戏开发者正向WP8平台迁移，想在这个平台上一显身手。

所以采用cocos2d-x引擎开发WP8手机游戏是一件顺理成章的事。鉴于这种趋势，笔者提供这个示例。希望通过本示例，能让各位学习到如何在WP8平台上搭建cocos2d-x的游戏开发环境，并预先告知搭建平台可能会遇到的一些问题及其解决办法。握起你手中的windows phone，我们开始吧！

使自己能够开发Windows phone

注册成为windows phone的开发者

访问以下MSDN的windows phone 开发用户注册页

(v=vs.105)

按步骤填写windows账号和注册Windows phone开发者账号

Windows 账号说明：就是Hotmail、SkyDrive、Xbox LIVE的用户

开发者账号的费用：$19一年；学生账号免费但不能发布收费应用

安装编译环境

安装visual studio 2003

安装windows phone SDK 8.0

http://dev.windowsphone.com/en-US/downloadsdk

http://dev.windowsphone.com/zh-cn/downloadsdk

cocos2d-x项目的创建

获取最新的cocos2d-x的代码（本文以2.2版本为例）

从官网下载最新代码：

把下载的zip包解压后就是cocos2d-x的整个工程：

整个工程的各个目录大致包含如下内容：

cocos2dx	核心代码
cocosDenshion	封装了声音引擎的代码（SimpleAudioEngine、OpenAL）
extensions	扩展库代码
external	包含了很多外部库代码（Box2D、chipmunk等）
sample	4个示例代码： 1个小游戏研究TestCpp代码是个学习cocos2d-x很好的方法
template	跨平台模板代码
tools	各种工具脚本

创建自己的cocos2d-x的HelloWorld：

下载并安装Python，注意不要安装3.0版本以上的【Tip1】

设置电脑的环境变量，加入Python的安装路径：

我的电脑→右键→属性→高级→环境变量→系统变量→path→加入你的python安装目录

进入cmd，在任意目录下，输入python，不会提示“不是外部或内部命令”就OK。

创建HelloWorld工程：

Python create_project.py project
#PROJECT_NAME –package #PACKAGE_NAME –language #PROGRAMING_LANGUAGE

进入cocos2d-x-2.2.0\tools\project-creator目录，在cmd下执行：

Note：上面的脚本中有三个变量需要根据自己的情况替换

#PROJECT_NAME ：工程的名称

#PACKAGE_NAME：包名称（格式：com.mycompany.mygame）
#PROGRAMING_LANGUAGE：编程语言（cpp, lua, javascript）

如果看到如下界面，表示工程创建成功，恭喜！

把HelloWorld从cocos2d-x的大工程中独立出来：

刚才的HelloWorld在cocos2d-x-2.2.0\projects\目录下，可以根据自己的情况新建一个目录，把HelloWorld代码和cocos2d-x必要的文件拷贝过去，做一个干净的工程，注意目录结构不能破坏。做好的工程大致如下所示：

进一步简化工程创建的步骤

笔者建议开发者可以自己写一个bat文件，把创建和工程独立合二为一，做到一步完成。这里给出一个bat的例子供大家参考【TIP2】：

@echo off
set /p directoryName=Please Input Directory Name:
if "%directoryName%"=="" goto inputError
set /p projectName=Please Input Project Name:
if "%projectName%"=="" goto inputError
set /p packageName=Please Input Package Name:
if "%packageName%"=="" goto inputError
create_project.py -project %projectName% -package %packageName% -language cpp
xcopy ..\..\projects\%projectName% d:\%directoryName%\projects\%projectName% /s/e/i/y
xcopy ..\..\cocos2dx d:\%directoryName%\cocos2dx /s/e/i/y
xcopy ..\..\cocosDenshion d:\%directoryName%\cocosDenshion /s/e/i/y
xcopy ..\..\extensions d:\%directoryName%\extensions /s/e/i/y
xcopy ..\..\external d:\%directoryName%\external /s/e/i/y
@echo Create Project OK!
pause
goto finish
:inputError
@echo Need Directory & Project & Package Name!
pause
:finish

按上述方法，创建工程(MyDemo)，观察一下工程的目录结构

硬盘上的目录结构见下左图

点击proj.wp8目录下的.sln文件，打开WP8的工程

目录结构见下右图

通过观察，我们可以得出几点结论：

以Proj.开头的目录存放的是和各个平台相关的代码和工程文件还有资源(比如Splash)

Class目录存放的是和平台无关的代码即用cocos2d-x写的游戏代码部分(AppDelegate, HelloWorldScene.cpp)。大家开发游戏的时候也应该把代码放在此目录下。

IFrameworkView^ Direct3DApplicationSource::CreateView()
{
	return ref new MyDemo();
}
[Platform::MTAThread]
int main(Platform::Array^)
{
	auto direct3DApplicationSource = ref new Direct3DApplicationSource();
	CoreApplication::Run(direct3DApplicationSource);
	return 0;
}
ref class MyDemo sealed : public Windows::ApplicationModel::Core::IFrameworkView
{
public:
	MyDemo();
       ….
private:
	// The AppDelegate for the Cocos2D app
	AppDelegate app;
};

通过如下代码可以了解引擎是如何把AppDelegate加到WP项目中去的

跨平台特性的体现：

AppDelegate.cpp, HelloWorldScene.cpp等代码在任何平台的工程里都是一样的

Resources目录存放的是游戏资源，各个平台都是统一的一份

扩充HelloWorld工程

查看工程目录可以看到，引擎只给我们导入了基本的库(libcocos2d)，而比如声音库CocosDenshion，物理库Box2D等并没有导入，所以我们需要手动将这些库导入。笔者以导入CocosDenshion为例，介绍如何加入这些库。具体步骤如下：

添加库项目到工程里：选中解决方案右键，选择 “现有项目”

选择 cocos2d-x-2.2\CocosDenshion\proj.wp8目录下的 .vcxproj文件，加入工程

增加项目依赖：选中解决方案右键，选择“项目依赖项”

勾选我们刚才添加的库，记得esUtil_phone也勾选

添加引用：选中项目名(MyDemo)右键，选择“属性”，在“框架和引用”里面点击 “添加新引用”，勾选新添加的库

为了更方便使用添加的库，最好增加新库的包含路径【Tip3】：

选中项目名(MyDemo)右键，选择“属性”，在“C/C++通用”里面，选择“附加包含目录”，增添新路径( $(ProjectDir)..\..\..\CocosDenshion\include )

至此HelloWorld工程正式建立起来了。

按下图所示设置VS的调试选项，编译并运行。

哇，出现了模拟器画面，恭喜啊，成功了！

ASSETS详解

认识XAP文件和Assets

看一下上述工程编译成功后的输出（中间省略了一些输出）

XAP文件就是windows phone的包文件格式，相当于Android的APK和iOS的APP。它是一个标准的zip 压缩文件，包括了WP应用程序所需的一切文件，如程序集、资源文件等。通过项目的“输出路径”，我们可以找到生成的XAP的文件。

我们试着把XAP文件的后缀改为zip，然后解压，看一下里面包含的内容：

左图是XAP文件包含的内容，看上去和Android有点类似，包括程序文件(exe)、应用配置文件WMAppManifest.xml（类似于安卓的AndroidManifest.xml）、一些dll和一个Assets目录。中图是Assets目录、右图是Assets/Resources目录包含的内容，可以看到主要是游戏资源。

由此可见，和Android一样，WP的程序会把需要用到的资源放在Assets目录下。

进一步认识Assets目录（本节内容可以跳过）

利用cocos2d-x的跨平台特性，我们可以做一个实验

分别编译并运行MyDemo的proj.win32和proj.wp8工程，成功后分别出现如下画面

在整个工程的Resource目录下，找到HelloWorld.png图片，把这张图片的文件名改为

“Helloworld1.png”

打开HelloWorldScene.cpp，找到bool HelloWorld::init()函数做如下修改

//   CCSprite* pSprite = CCSprite::create("HelloWorld.png");
	CCSprite* pSprite = CCSprite::create("HelloWorld1.png");

（此文件在两个工程内都被调用，只要在任一个工程修改，另一个工程内会自动更新）

分别编译并运行，出现如下画面

很明显，Win32成功了，WP8失败了。Debug一下就会知道pSprite的指针是空的。也就是没有拿到刚才已经改名的HelloWorld1.png这张图。为什么会这样呢？我们打开新生成的XAP文件看一下。结果发现XAP包里的Assets/Resources目录下还是原来那张HelloWorld.png的贴图，根本没有HelloWorld1.png的贴图。所以仅仅修改代码和工程的Resources目录下的资源，是无法影响XAP包里的资源的，正确方法请看第3点。

（win32工程不会错误的原因请读者自己研究）

学习如何把资源加入到Assets目录中

我们打开MyDemo的WP8工程，在VS的Solution Explorer下可以发现有Assets目录，见下图，这个目录下存放的就是打入XAP包里Assets目录下的所有资源