生成iOS-Xcode技术文档

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

从源码中抽取注释生成文档的专用工具：

[doxygen](http://www.stack.nl/~dimitri/doxygen/index.html)：适于生成html文档与pdf文档。支持的语言多，可以配置的地方也比较多。默认生成的风格与苹果的风格不一致。
[headdoc](http://developer.apple.com/opensource/tools/headerdoc.html) ：是 Xcode 自带的文档生成工具。在安装完 Xcode 后，就可以用命令行来生成对应的文档。不过它只生成以/*! */
的格式的注释。不兼容 /** */
格式的注释
[appledoc](http://gentlebytes.com/appledoc/): [Github地址](https://github.com/tomaz/appledoc) ，适于生成html文档和xcode帮助文档（docset）。可以兼容 /** */
格式，也可以兼容 /*! */
格式的注释。

我直接选取了 appledoc,下面是安装步骤和使用步骤:

安装

两种方式：

1 如果你装了homebrew，打开终端，输入以下命令：

brew install appledoc

第一次用的这种方式，安装虽然成功了但是去找不到生成的html文件，后来找到了文件打开之后里面的内容却不对，所以如果有朋友看到后可以告诉我怎么回事，先谢谢了~
2 打开终端，输入以下命令:

git clone git://github.com/tomaz/appledoc.git
cd appledoc
sudo sh install-appledoc.sh

我这里是选用的第二种方式,不知道是网速慢还是什么,等了太久就结束第一种方式,开始了第二种方式了.

3.终端命令执行完之后,进行以下操作,如下图所示,则表示成功了.

使用

首先创建一个项目appledoc,为了便于演示，写几个注释：

//
// ViewController.m
// AppleDoc
//
// Created by 思彭 on 2017/4/5.
// Copyright © 2017年思彭. All rights reserved.
//#import "ViewController.h"// 主控制器
@interface ViewController ()@property (nonatomic, strong) NSString *name; /**<名字 */
@property (nonatomic, strong) NSString *sex; /**<性别 */
@property (nonatomic, assign) NSInteger age; /**<年龄 */
@property (nonatomic, strong) NSString *address; /**<住址 */@end@implementation ViewController- (void)viewDidLoad {
[super viewDidLoad];
}/**
网络请求方法 @param params 需要的参数
*/
- (void)netWork: (NSDictionary *)params {}/**
返回字符串方法 @param string 传递字符串
@return 返回的字符串
*/
- (NSString *)string: (NSString *)string { return string;
}@end