安装appledoc
使用终端下载:
git clone git://github.com/tomaz/appledoc.git
cd ./appledoc
sudo sh install-appledoc.sh
直到出现这个画面说明安装成功
image.png
使用appledoc
最方便的方法就是在xcode中添加script
新建target
62671436F2C0F9E5E9CB0CC55D697839.jpg
BB0387477B5B7C162A3B2FA3F1AA873E.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
1B531CC204DD9FE98BA3156C140C0470.jpg
run 之后可以在output对应的目录下本地找到一个 html 文件
C291A89EBD5B46AA8BE438197AB52976.jpg
打开html文件就能看到漂亮的文档了
E401AA0F7A30924AD29893F1C1AAB364.jpg