展会信息港展会大全

cocos2D(二)---- cocos2D文档的使用,----cocos2d 生成HTML文档 将cocos2d的文档集成到Xcode中
来源:互联网   发布日期:2015-09-28 15:29:01   浏览:2370次  

导读: cocos2D(二)---- cocos2D文档的使用,----cocos2d 在使用cocos2d进行游戏开发的过程中,难免要查阅cocos2d的API文档,搞清楚怎么使用某个类或者某个方...

cocos2D(二)---- cocos2D文档的使用,----cocos2d

在使用cocos2d进行游戏开发的过程中,难免要查阅cocos2d的API文档,搞清楚怎么使用某个类或者某个方法。幸运的是,cocos2d的作者已经在源代码里面添加了文档注释,我们只需要使用文档生成工具解析源代码生成文档即可。最常用的文档生成工具是Doxygen。

用Doxygen处理cocos2d文档有2种方式:

第1种方式:安装Doxygen软件,解析cocos2d源代码,生成html格式的静态文档

第2种方式:利用cocos2d自带的Doxygen功能,将文档集成到Xcode中

下面我分别详细说明上述2种方式的实现步骤:

生成HTML文档

1.下载dmg格式的Doxygen软件http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc

2.安装好Doxygen后,打开软件进行参数设置

3.点击Run doxygen开始生成文档

4.生成完毕后,打开文档的生成位置(刚才设置的是cocos2d文件夹),多了一个html文件夹,

5.打开html文件夹中的index.html文件,这个是文档的入口

6.这里可以查看所有的类

7.我们来看看CCSprite类

8.有继承结构图

9.有方法列表

10.点击某个方法,还可以看到方法的详细说明

到这里为止,html格式的文档就搞定了

将cocos2d的文档集成到Xcode中

说明:cocos2d版本是1.0.1,Xcode版本是4.5

前提:先安装上面的Doxygen软件到Applications(应用程序)目录下

1.打开cocos2d中的doxygen.config文件,设置成输出中文文档(其实只是部分关键字为中文,这个步骤可以省略)

2.双击打开cocos2d-ios.xcodeproj

3.设置cocos2d-documentation为target

4.编译这个target

提示:点击编译后,会自动执行一些脚本去生成文档,请耐心等待。编译过程中会产生很多错误和警告,这个不影响文档的生成,可以忽略

5.看到Build succeed就代表文档生成完毕,这时候请完全退出Xcode后再重新打开Xcode,接着查看文档

6.可以看到cocos2d的文档已经集成到Xcode中了

7.其实本质是将文档打包成一个.docset文件,然后生成到:/Users/apple/Library/Developer/Shaerd/Documentation/DocSets文件夹中(我的用户名叫apple),Xcode会去这里加载所有的文档,不过只会在打开Xcode时加载一次,这也是要完全重启Xcode才能查看新生成的cocos2d文档的原因

两种处理cocos2d文档的方式都介绍完了,个人更推荐采取第2种方式:集成到Xcode中,这也是开发中最常见的方式

原文地址:http://blog.csdn.net/q199109106q/article/details/8590609

感谢作者~!

怎让cocos2d可以用ARC

将User Head Search Paths设为Cocos2d源代码的路径(例如:/Users/ming/Documents/cocos2d-iphone/**),并且选择recursive。3.打开cocos2d的源代码文件夹,找到cocos2d-ios.xcodeproj文件,将其拖入你的项目里。再次点击项目文件,点Build Phases,从Link Binary With Libraries中添加libcocos2d.a,libCocosDenshion.a。此时文件名是红色的,不用管。4.删除libs文件夹5.运行后 main报错,改为:#import int main(int argc, char *argv[]) {@autoreleasepool {int retVal = UIApplicationMain(argc, argv, nil, @"AppController");第二种方法:1.删除libs文件夹 删除时选Remove References2.创建cocos2d静态库 点击 Add Target,在弹出的对话框里,展开Framework&Library组,选择Cocoa Touch Static Library. 点next.再在出来的对话框里输入这个静态库的product Name并取消下面的两个复选框,点Finish. 然后会回到xcode里 选中创建的静态库 在它的Build Settings里Always Search User Paths设为Yes。将User Head Search Paths设为./**3.在TARGETS里选中原目标程序,在Build Phases里的Link Binary With Libraries里添加libcocos2d-library.a4.点击xcode的File->Add Files to "name- of-project", 找到libs文件夹,再取消下面Destination的复选框,Folders选Create groups for any added folders,Add to targets 只选你创建的静态库。然后add.5.运行一下程序。6.点击xcode的Edit->Refactor->Convert to Objective-c ARC 。弹出的对话框中选择你的原目标程序,不要选cocos2d-library目标程序。点Check。

赞助本站

人工智能实验室

相关热词: android开发 应用开发

AiLab云推荐
推荐内容
展开

热门栏目HotCates

Copyright © 2010-2024 AiLab Team. 人工智能实验室 版权所有    关于我们 | 联系我们 | 广告服务 | 公司动态 | 免责声明 | 隐私条款 | 工作机会 | 展会港