天天看点

《Cocos2D权威指南》——1.2 下载与安装

本节介绍cocos2d的下载与安装。如果想使用cocos2d开发iphone应用或游戏,首先要下载cocos2d的模板,然后安装该模板,最后创建cocos2d**的帮助文档。下面分别来介绍这几个步骤。

1.2.1 下载cocos2d**

首先登录cocos2d的官方网站:<code>http://www.cocos2d-iphone.org</code>,切换到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之前的版本,则可以在浏览器中输入以下链接:<code>https://github.com/cocos2d/cocos2d-iphone/tags</code>。

当然,这只是其中一种方式,在这里,我们向大家推荐一种更加方便的做法,那就是使用git。git和svn一样,也是一款源代码管理工具,它和svn最大的区别就是:git是分布式的,而svn是集中式的。具体的区别大家可以通过google查看,建议大家深入学习一下。为什么要使用git呢?首先,cocos2d目前放在github上面托管,全世界所有的开发者都可以非常方便地从github上面获取到cocos2d的最新开发进展的源代码,同时可以向该项目贡献源代码。

使用git之前,首先我们需要安装git。大家首先在浏览器中打开地址<code>http://code.google.com/p/git-osx-installer/downloads/list</code>,然后下载最新版本安装即可。如图1-3所示。

《Cocos2D权威指南》——1.2 下载与安装

安装完成之后,需要打开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所示。

《Cocos2D权威指南》——1.2 下载与安装

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所示。

《Cocos2D权威指南》——1.2 下载与安装
《Cocos2D权威指南》——1.2 下载与安装

此时应打开finder,选择“go to”,然后选择“go to folder”,输入之前保存cocos2d模板的路径,如图1-8所示。

《Cocos2D权威指南》——1.2 下载与安装

在templates子目录下创建cocos2d v2.x和file templates两个子目录,并在file templates子目录下创建cocos2d v2.x目录,如图1-9所示。

《Cocos2D权威指南》——1.2 下载与安装

再次回到terminal,输入“./install-templates.sh-u-f”,此时会提示顺利安装,如图1-10所示。

《Cocos2D权威指南》——1.2 下载与安装

注意 使用的用户需要设定密码,如果没有设置密码,请到“系统设置”-“用户”里去设置。

那么,如果要删除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。单击下载安装即可。

《Cocos2D权威指南》——1.2 下载与安装

安装完dash之后,需要安装cocos2d的文档集。首先,打开dash的“应用程序偏好设置”,并切换到downloads标签,如图1-12所示。

《Cocos2D权威指南》——1.2 下载与安装

安装好cocos2d的文档包之后我们再打开dash,这时在左上角的搜索框内输入ccsprite,此时会得到如图1-13所示输出(免费版本字体显示红色)。

《Cocos2D权威指南》——1.2 下载与安装

1.2.4 使用cocos2d中内置的项目

安装了cocos2d之后不要错过其中内置的项目,如果认真研究,大家可以从中学到很多知识,了解到更多有关cocos2d的强大功能。

从finder中找到documents,进入cocos2d-iphone目录,打开cocos2d-ios.xcodeproj文件,如图1-14所示。

《Cocos2D权威指南》——1.2 下载与安装

我们可以看到其中有多个target,可以选择不同的target逐一编译运行,体验cocos2d的强大功能,如图1-15所示。

《Cocos2D权威指南》——1.2 下载与安装

在了解cocos2d的基础知识后,我们还可以随时打开这个工程,查看每种测试的详细代码,从而更深入地学习cocos2d。

学习使用cocos2d中内置的模板,是从入门到精通的必经之路。