第一部分 快速上手

第1章 搭建Cocos2D-X开发环境

劲松是程序员，万千平凡程序员中的一个。因为名字中有一个松字，做事又很给力，大家就送了他这个北京地铁站的名字。

“劲松，今天有一个学校开学生作品展，我看见一个美女老师，真心漂亮！”文彪刚刚从外面进屋，就兴冲冲地说。

劲松放下鼠标，扭过头来调侃道：“就这烟雾蒙蒙的天气，你确定你看清了？”

“我跟你可不一样，策划都拥有一个发现美的眼睛，不像程序员，发现的都是Bug。”文彪一本正经地说。

SK从旁边屋里走出来问“Dota么？”。SK也是一名程序员，因为Dota打得好，名字的拼音缩写又是SK，刚好和Dota中沙王的缩写吻合，就得到了这个称号。

“去去，说正经事呢。劲松，你相信缘分吗？”。

“算信吧，不过得连到开发环境调试一下才知道……”。

“帮我个忙，你最近不是正研究着什么cos之类的手机开发吗？”。

“cos ? 还正弦呢。Cocos2D-X”。

“呀，反正就是它啦，帮我做个什么放手机上吧，现在手机上这些乱七八糟的应用，追妹子完全不给力啊，望大神给我做个神装。”

“Dota么？”SK看着文彪撇撇嘴。

“Dota啦，劲松，这事就这么说定啦。都赶紧启动，最后进去的开局买鸡。”说着文彪拍了劲松一下，就跳开了。

“我相信缘分么？”看着加载中的Dota，劲松心想。也许试试就知道了。

“单子接了，等我重新搭个环境就上手做。”劲松在Dota的盟友聊天中输入道。

“Ok我包鸡包眼”

……

1.1 引擎简介

Cocos2D-X是一个开源的2D移动游戏框架，它的原型是Cocos2D。此框架的目的是简化游戏开发的流程，让开发者能够专注于开发游戏本身。它是基于MIT许可证发布的，这也就意味着我们可以免费使用它来开发商业产品。

1.1.1 选择Cocos2D-X的理由

Cocos2d-X的核心点是围绕Cocos2D跨平台。使用Cocos2D-X创建的项目可以很容易地运行在iOS、Android、Windows Phone等移动设备上。Cocos2D-X还支持Windows、Mac和Linux等桌面操作系统，因此，我们编写的源代码可以很容易在桌面操作系统中编辑和调试。

在使用Cocos2D-X开发手机游戏时，可以采用的语言有C++、Lua、JavaScript三种。多种语言的支持为游戏框架设计提供了极大的灵活性，方便开发者针对不同的游戏制定不同的方案。

Cocos2D-X用户不仅包括个人开发者和游戏开发爱好者，还包括许多知名大公司如Zynga、Wooga、Gamevil、Glu、GREE、Konami、TinyCo、HandyGames、IGG及Disney Mobile等。截止2013年9月，全球基于Cocos2D-X引擎的游戏下载量逾15亿，其中许多位于苹果应用商店（AppStore）和谷歌应用商店（Google Play）排行榜前列。同时许多公司如触控、谷歌、微软、ARM、英特尔及黑莓等，它们的工程师在Cocos2D-X领域也非常活跃。

1.1.2 Cocos2D-X 3.x版本与先前版本的不同

2014年6月Cocos2D-X推出了最新的版本—Cocos2D-X 3.0。在Cocos2D-X 3.0以及后续版本中做了很多基础的改进，比如性能、兼容性（尤其是Android手机的兼容性）、CPU和内存消耗等。在性能方面优化了很多自动技术，例如当一个游戏场景大出手机屏幕时，引擎会把屏幕之外的东西给剔除掉，使大场景游戏的流畅度有很大的提升。

从开发的角度来说，Cocos2D-X 3.0更改了大量的接口，使得整体代码风格更一致。虽然这会使先前Cocos2D-X 2.x的代码不兼容，但从长远的角度来说，将代码转移到Cocos2D-X 3.x版本上是值得的。Cocos2D-X 3.0引入了大量的C++11特性，使开发过程变得更轻松。

1.2 搭建开发环境

在了解了关于Cocos2D-X最基本的信息后，我们来动手搭建Cocos2D-X开发环境。

1.2.1 安装开发环境

1）安装VS 2012（Visual Studio 2012）。在微软官方网站下载安装包后直接安装即可。

2）找到官网的DownLoad页面（http://www.cocos2d-x.org/download）下载最新的Cocos2D-X并进行解压。本书使用的是Cocos2D-X 3.0版本。

3）解压后进入“build”文件夹，运行VS 2012的项目:cocos2d-win32.vc2012.sln。这样会启动VS 2012。

4）在左侧的解决方案管理器中，找到“TestCpp”项目，右击，在弹出菜单中选择“设为启动项目”，如图1-1所示。

5）按“F5”启动调试。运行调试刚刚设置的启动项目，VS 2012在编译工程文件的同时，会编译需要的依赖库文件。待编译完成后，如果出现如图1-2所示的程序运行界面，说明Cocos2D-X已经配置成功。

1.2.2 安装CocoStudio

开发一个游戏怎么可能没有图形化的编辑工具呢？Cocos2D-X提供了官方团队维护的CocoStudio作为默认的编辑工具。

CocoStudio包括动画编辑器、UI编辑器、场景编辑器、数据编辑器四部分。我们可以在官网（http://www.cocos2d-x.org/download）下载CocoStudio的最新版本。

下载后直接运行即可安装。

一路点击下一步，安装成功后运行CocoStudio，显示如图1-3所示，说明安装成功。

1.3 创建项目

配置好了开发环境，接下来我们创建一个新项目。

1.3.1 安装Python

为什么要安装Python？因为从Cocos2D-X 3.0开始，创建项目要以Python脚本的形式进行。安装Python要简单很多：对于使用Mac开发的用户，因为Mac本身集成了Python，所以不必再安装；对于使用Windows进行开发的用户，要去官网http://www. python.org/ 下载安装包。在这里笔者用的是Python 2.7。

安装Python的过程比较简单，一路点击“下一步”即可。安装完成后运行“命令与提示符”，在其中输入: python，出现如图1-4所示的画面，则表示安装成功。

1.3.2 创建新项目

在安装好Python后，我们就可以创建新项目了。在创建项目之前，我们要配置环境变量。在“命令与提示符”中，进入到Cocos2D-X根目录下。执行setup.py，效果如代码清单1-1所示。

代码清单1-1注册命令路径

        C:\OutFile\cocos2d-x-3.2>setup.py
        Setting up cocos2d-x...
        -> Adding COCOS2D_CONSOLE_ROOT environment variable... OK

          -> Added: COCOS_CONSOLE_ROOT = C:\OutFile\cocos2d-x-3.2\tools/cocos2d-conso
        le/bin
        -> Looking for NDK_ROOT envrironment variable... NOT FOUND
                Please enter its path (or press Enter to skip):
        -> Looking for ANDROID_SDK_ROOT envrironment variable... NOT FOUND
                Please enter its path (or press Enter to skip):
        -> Looking for ANT_ROOT envrironment variable... NOT FOUND
                Please enter its path (or press Enter to skip):
        Set up successfull:
                COCOS_CONSOLE_ROOT was added into registry
        Please restart the terminal or restart computer to make added system variables
        take effect

在执行过程中，脚本程序会停下来询问我们路径的配置，按回车跳过即可。因为这些路径配置都是生成Android程序需要用到的，在第2章中我们会详细介绍。

执行完成后，我们来验证一下安装是否成功。重新启动“命令与提示符”，输入cocos命令，显示代码清单1-2所示的代码，则说明环境配置正确。

代码清单1-2验证安装

        C:\Users\Fansy>cocos
        C:\Users\Fansy>python C:\OutFile\cocos2d-x-3.2\tools\cocos2d-console\bin\/coc
        os.py
        C:\OutFile\cocos2d-x-3.2\tools\cocos2d-console\bin\/cocos.py 0.1- cocos cons
        ole: A command line tool for cocos2d
        Available commands:
                compile    Compiles the current project to binary
                new         Creates a new project
                run         Compiles & deploy project and then runs it on the target
                deploy     Depoly a project to the target
        Example:
                C:\OutFile\cocos2d-x-3.2\tools\cocos2d-console\bin\/cocos.py new --help
                C:\OutFile\cocos2d-x-3.2\tools\cocos2d-console\bin\/cocos.py run --help

安装成功后，如代码清单1-3所示，输入创建项目命令即可创建一个Cocos2D-X项目。

代码清单1-3创建项目命令

        C:\Users\Fansy>cocos new -p com.fansy.HelloWorld -l cpp -d C:\Code HelloWorld
        C:\Users\Fansy>python C:\OutFile\cocos2d-x-3.2\tools\cocos2d-console\bin\/coc
        os.py new -p com.fansy.HelloWorld -l cpp -d C:\Code HelloWorld
        Runing command: new
        > Copy template into C:\Code\HelloWorld
        > Copying cocos2d-x files...
        > Rename project name from 'HelloCpp' to 'HelloWorld'
        > Replace the project name from 'HelloCpp' to 'HelloWorld'
        > Replace the project package name from 'org.cocos2dx.hellocpp' to 'com.fansy.He
        lloWorld'

执行运行命令成功后，一个新的项目就被创建到C:\Code\HelloWorld目录下。

1.3.3 目录结构

回过头来看看1.3.2新建的项目，打开C:\Code\HelloWorld目录，可以看到如图1-5所示的文件结构。

其中：

❑Classes中放置着代码的主体部分。几乎所有的代码文件都要放置在这个文件夹中。

❑以proj.开头的几个目录分别是各个平台下的工程、特有代码、生成文件存放的地方。有我们熟悉的proj.win32，当然还有苹果的proj.ios_mac、谷歌的proj. android等。

❑Resources目录中包含了在项目中用到的图片资源、配置文件等。在生成某个平台的程序时，会结合Classes中的代码、Resources中的资源文件，以及proj.xxx目录中相应的代码来整体生成。

打开proj.win32目录，在其中找到HelloWorld.sln，双击打开即可使用VS 2012打开。按F5键，即可编译运行。看到如图1-6所示运行效果，说明项目创建成功。

1.4 小结

本章介绍了Cocos2D-X 3.x的基本特点，开发环境安装及配置；还介绍了如何使用脚本新建项目；最后介绍了安装CocoStudio，为后面的开发做准备。掌握这些基础知识后，就可以进入到正式的Cocos2D-X游戏开发工作中了。