如何让xcode拥有自动注释并生成文档的功能:
开发第一件事,应该就是文档了。好的文档能让开发更清晰,明确的去把握整个项目的方向,脉络。闲话少说,说下具体实现操作吧。
步骤:
1,在XCode里点击TARGETS,然后点添加 + 给项目添加一个TARGET;![](https://img-blog.csdn.net/20170628163153492?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbGFvZGVuZzA1MTI=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
2,弹出框中选择Cross-platform - Other ,选中Aggregate,点击next,命名,例如项目中我的命名ShowDoc,点击finish完成;
3,TARGET出现选项ShowDoc,点击,选择最上方Build Phases,选 + Add Run Script;
4,Run Script添加完后,拷贝以下代码到代码对话框里:
# shell script goes here
mkdir -p headerDoc
find /Users/shiye/Documents/GitHub/Document_Show/TestView -name \*.h -print | xargs headerdoc2html -o headerDoc
gatherheaderdoc headerDoc
exit 0
5,注意这里/Users/shiye/Documents/GitHub/Document_Show/TestView,这个位置以你自己文件所放位置而变化,注意修改成自己项目文件的路径。headerDoc为所生
成的文档标题,可自定义;![](https://img-blog.csdn.net/20170628163500878?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbGFvZGVuZzA1MTI=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/Center)
6,基本设置完成,运行。 在XCode左上角的Scheme里选定刚才生成的Target:ShowDoc,然后点Run。运行以后,在你的项目文件夹里,就会生成一个文档文件夹headerDoc
了。这些自动生成的文档都是根据你在源代码里写的注释生成的。
接下来,另一个重要步骤来了,源代码中注释写法的具体说明:
1,header,头文件基本描述信息;这个用在每个源代码文件的头文件的最开头。
eg:/*! @header ViewController.h
@abstract 首页
@author 窃笑
@version 1.00 2016/12/19 Creation
*/
2,class,类信息。此注释用在类声明的开头。
eg:/*! @class
@abstract 首页,控制显示ui
*/
3,property, property的注释书写。
eg:/*! @property
@abstract 左边标题选择tableview控件
*/
4,method: 函数的相关注释。
eg:/*! @method
@abstract 左侧目录点击
@discussion 点击分别显示右侧各类图标:1,泡泡图;2,散点图;3,柱状图;4,折线图;5,饼图;6,雷达图;7,k线 图;8,仪表盘;9,热力图;10,关系图;
@param tableView 选中的tableview
@param indexPath 选中列
*/
5,property, property的注释书写。
eg:/*! @protocol
@abstract 协议类
@discussion 议具体描述信息
*/
......注释方法还有很多,具体请查看官方api文档。以上描述注释均来自dema里边供参考。
需要源码的可以查看我的github账号上源码下载:https://github.com/Deng0512/Document_Show
顺便看下生成文档后一个类的效果图吧: