如何让xcode拥有通过注释自动生成文档的功能

如何让xcode拥有自动注释并生成文档的功能：

    开发第一件事，应该就是文档了。好的文档能让开发更清晰，明确的去把握整个项目的方向，脉络。闲话少说，说下具体实现操作吧。

步骤： 1，在XCode里点击TARGETS,然后点添加 + 给项目添加一个TARGET；

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为所生 成的文档标题，可自定义；

 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

顺便看下生成文档后一个类的效果图吧：