安装appledoc
使用终端下载:
git clone git://github.com/tomaz/appledoc.git
cd ./appledoc
sudo sh install-appledoc.sh
直到出现这个画面说明安装成功
![](https://img.haomeiwen.com/i1528347/ca6cab9c270fe65e.png)
使用appledoc
最方便的方法就是在xcode中添加script
新建target
![](https://img.haomeiwen.com/i1528347/00a54b26364fed02.jpg)
![](https://img.haomeiwen.com/i1528347/1c7e9e19a2e8b9f9.jpg)
通过我们新增加的Run Script
添加一下脚本
#appledoc Xcode script
# Start constants
company="RANY";
companyID="com.RANY";
companyURL="http://ranyeee.top";
target="iphoneos";
#target="macosx";
outputPath="~/help";
# 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这里改一下API文档输出的路径
--output "~/desktop/doc" \
--publish-docset \
--docset-platform-family "${target}" \
--logformat xcode \
--keep-intermediate-files \
--no-repeat-first-par \
--no-warn-invalid-crossref \
--exit-threshold 2 \
"${PROJECT_DIR}"
添加好script之后 run 一下这个target
![](https://img.haomeiwen.com/i1528347/5be9e4ef010644cc.jpg)
run 之后可以在output对应的目录下本地找到一个 html 文件
![](https://img.haomeiwen.com/i1528347/94528a476bc60c29.jpg)
打开html文件就能看到漂亮的文档了
![](https://img.haomeiwen.com/i1528347/d4876cd0c0c170ac.jpg)
网友评论