iOS --appledoc的安装和使用

一、安装

　　1、github上下载地址:https://github.com/tomaz/appledoc.git

　　　2、下载之后，终端执行 cd /users/你的位置/desktop/appledoc 进入appledoc文件

　　　3、终端执行 sudo sh install-appledoc.sh 进入安装，安装成功会有success提示　 

二、使用

　　1、在工程里新建一个target，选择 Other 中的 Aggregate。

新建Aggregate

2、在新建的target里选择Build Phases,添加Run Script 

添加Run Script

3、将下面这段代码复制到 Run Script里即可，前五个参数改成你自己的。

```

#appledoc Xcode script

# Start constants

company="abc";    //公司名

companyID="com.abc";    //公司id

companyURL="http://abc.com";  //公司url

target="iphoneos";    //操作系统

#target="macosx";

outputPath="~/desktop/xtmm/document";    //存放的位置

# End constants

/usr/local/bin/appledoc \

--project-name "${PROJECT_NAME}" \

--project-company "${company}" \

--company-id "${companyID}" \

--docset-atom-filename "${company}.atom" \

--docset-feed-url "${companyURL}/${company}/%DOCSETATOMFILENAME" \

--docset-package-url "${companyURL}/${company}/%DOCSETPACKAGEFILENAME" \

--docset-fallback-url "${companyURL}/${company}" \

--output "${outputPath}" \

--publish-docset \

--docset-platform-family "${target}" \

--logformat xcode \

--keep-intermediate-files \

--no-repeat-first-par \

--no-warn-invalid-crossref \

--exit-threshold 2 \

"${PROJECT_DIR}"

```

4、选择创建的这个target,build一下，然后完全退出再重新打开就可以生成文档了。

注意：build的时候会报错  Command /bin/sh failed with exit code 2，但是一样会生成文档，不知道是bug还是为什么....

原文地址：https://www.cnblogs.com/zhangshan/p/5275520.html