本节介绍Cocos2D的下载与安装。如果想使用Cocos2D开发iPhone应用或游戏,首先要下载Cocos2D的模板,然后安装该模板,最后创建Cocos2D**的帮助文档。下面分别来介绍这几个步骤。1.2.1 下载Cocos2D**首先登录Cocos2D的官方网站:http://www.cocos2d-iphone.org,切换到Download选项,可以看到如图1-2所示的网站页面。由图1-2可以看到,Cocos2D的最新稳定版本有v1.0.1和v2.0版。考虑到Cocos2D v2.0版本支持众多的新特性,同时也是今后官方主力维护的版本(1.x版本留给社区更新,而引擎的主力开发者Ricardo Quesada将主要负责Cocos2D v2.0及其后续版本的更新与维护),本书将直接使用最新的v2.0版本。直接单击“cocos2d-iphone-2.0.tar.gz”这个链接就可以开始下载了。如果要下载Cocos2D之前的版本,则可以在浏览器中输入以下链接:https://github.com/cocos2d/cocos2d-iphone/tags。当然,这只是其中一种方式,在这里,我们向大家推荐一种更加方便的做法,那就是使用Git。Git和SVN一样,也是一款源代码管理工具,它和SVN最大的区别就是:Git是分布式的,而SVN是集中式的。具体的区别大家可以通过Google查看,建议大家深入学习一下。为什么要使用Git呢?首先,Cocos2D目前放在GitHub上面托管,全世界所有的开发者都可以非常方便地从GitHub上面获取到Cocos2D的最新开发进展的源代码,同时可以向该项目贡献源代码。使用Git之前,首先我们需要安装Git。大家首先在浏览器中打开地址http://code.google.com/p/git-osx-installer/downloads/list,然后下载最新版本安装即可。如图1-3所示。
安装完成之后,需要打开Mac OS X中的终端程序(Terminal),然后在里面输入“git clone git://github.com/cocos2d/cocos2d-iphone.git”就可以了。这句命令的意思是把Cocos2D的源代码仓库从远程服务器上复制一份放在本地机器上面。等进度完成100%之后,输入“cd cocos2d-iphone”,然后通过“ls”命令,就可以在终端里列出所有与Cocos2D相关的文件。 注意 Git里面有一个分支的概念,第一次复制过来的版本仓库,默认在master分支上面。而此分支的作用就是发布项目当前的稳定版本。从Cocos2D官网可知,目前的稳定版本是Cocos2D-iphone-1.01。因为本书将以Cocos2D v2.0版本为蓝本,所以需要切换到Cocos2D v2.0分支上面去。 切换到Cocos2D v2.0只需要一条简单的命令,即在终端里面输入“git checkout master-v2”。因为现在Cocos2D的1.x版本已经到1.1了,所以如果大家想获得1.1版本,可以在终端里面输入“git checkout master”。 注意,Cocos2D 1.x版本和2.x版本的项目模板是可以共存的,当使用Xcode创建新项目的时候,可以在左边的项目模板中同时看到1.x和2.x的模板,如图1-4所示。 1.2.2 安装 Cocos2D 模板 在安装Cocos2D模板之前,首先确保自己的系统上已经安装了Xcode,否则请先安装最新版本的Xcode。本书中使用的操作系统是最新的Mac OS 10.8.1,开发工具是Xcode 4.4.1。 开发环境搭好之后我们就可以获取Cocos2D v2.0的源代码了。如果是使用直接下载压缩包的方式,只需要在下载完之后解压缩到Documents目录。如果是使用Git的方式获取的源代码,则记得一定要切换到master-v2分支上。然后找到Terminal工具(Application→Utilities→Terminal,如图1-5所示)。 打开Terminal工具,通过“cd Documents”命令进入Documents目录,通过“ls”命令列出当前目录,然后再通过“cd cocos2d-iphone”命令进入源代码所在根目录,通过命令“ ./install-templates.sh-u-f”安装,如图1-6所示(如果使用的是Git的方式,则直接输入“git checkout master-v2”命令之后,输入“./install-templates.sh-u-f”命令就可以安装Cocos2D v2.0的模板了)。 但如果并非首次安装Cocos2D,有时会在Terminal中显示很多权限错误,如图1-7所示。 此时应打开Finder,选择“Go to”,然后选择“Go to Folder”,输入之前保存Cocos2D模板的路径,如图1-8所示。 在Templates子目录下创建cocos2d v2.x和File Templates两个子目录,并在File Templates子目录下创建cocos2d v2.x目录,如图1-9所示。 再次回到Terminal,输入“./install-templates.sh-u-f”,此时会提示顺利安装,如图1-10所示。 注意 使用的用户需要设定密码,如果没有设置密码,请到“系统设置”-“用户”里去设置。 那么,如果要删除Cocos2D之前的版本,该如何处理呢?很简单,只需打开Finder,选择“Go to”,选择“Go to Folder”,然后输入之前保存Cocos2D模板的路径,并删除Templates中的所有内容即可。 1.2.3 创建Cocos2D-iPhone的帮助文档 Cocos2D中的API不属于苹果官方提供,因此,在默认情况下,Xcode的帮助文档中无法查到Cocos2D中的API帮助信息。为了方便学习和使用Cocos2D中所提供的API,可以访问Cocos2D官方提供的在线文档。 除此之外,还有一种方法可以非常方便地获取最新的API文档,那就是使用Dash工具。Dash是一款集API文档浏览和代码片断管理于一体的工具,它支持iOS、Android、Cocos2D、Unity等20多种框架或语言的文档浏览功能。最重要的是,这些文档会随时得到更新,只需要升级相应的更新包即可。虽然这款软件不是免费的,想要使用其完整的功能必须购买才行。不过,其免费版本并不妨碍我们把它当作文档查询工具来使用。 要使用Dash,首先必须下载。下载过程其实非常简单,只需要打开App Store,在搜索里面输入Dash关键字,在查询的结果中找到图1-11所示的程序Icon。单击下载安装即可。 安装完Dash之后,需要安装Cocos2D的文档集。首先,打开Dash的“应用程序偏好设置”,并切换到Downloads标签,如图1-12所示。 安装好Cocos2D的文档包之后我们再打开Dash,这时在左上角的搜索框内输入CCSprite,此时会得到如图1-13所示输出(免费版本字体显示红色)。 1.2.4 使用Cocos2D中内置的项目 安装了Cocos2D之后不要错过其中内置的项目,如果认真研究,大家可以从中学到很多知识,了解到更多有关Cocos2D的强大功能。 从Finder中找到Documents,进入cocos2d-iphone目录,打开cocos2d-ios.xcodeproj文件,如图1-14所示。 我们可以看到其中有多个Target,可以选择不同的Target逐一编译运行,体验Cocos2D的强大功能,如图1-15所示。 在了解Cocos2D的基础知识后,我们还可以随时打开这个工程,查看每种测试的详细代码,从而更深入地学习Cocos2D。 学习使用Cocos2D中内置的模板,是从入门到精通的必经之路。 相关资源:cocos2d-1.0.1-x-0.13.0-beta.zip