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。
2、在新建的target里选择Build Phases,添加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还是为什么....