AppleDoc 使用介绍
如果还未安装AppleDoc,请参考:AppleDoc 安装步骤
项目集成了AppleDoc生成脚本,通过编译项目即可生成项目API文档。
具体操作步骤如下:
1. 切换项目scheme到RCodeDoc,选中Any iOS Device。
2. 查看CodeDoc的Target。
3. 修改脚本
# AppleDoc Xcode script
# Start constants
company="xxxx";# 公司名
companyID="com.xxxx.xxxx";# 公司ID
companyURL="http://www.xxxx.com";# 公司网址
target="iphoneos";# 编译平台 macosx、iphoneos
outputPath="xxxx/xxx";
ScanFilePath="xxxx/xxx";# 文档扫描路径 该路径下的所有类都会导出到html中 除了Pods目录下和所有.m文件
Release="--no-warn-undocumented-object --no-warn-undocumented-member ";# 导出模式,如果有不符合备注规范的代码,也会忽略,直接生成文档。--no-warn-undocumented-object 表示没有注释的文件不提示警告;--no-warn-undocumented-member 表示没有注释的属性和方法不提示警告
Debug="";# 调试模式,如果有不符合备注规范的代码,将会在报错日志中展示。
# 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}" --publish-docset --logformat xcode --docset-platform-family "${target}"
--output "${outputPath}"
-i Pods -i *.m --no-warn-invalid-crossref --no-repeat-first-par --keep-intermediate-files --keep-undocumented-objects --keep-undocumented-members ${Release}
${ScanFilePath}
默认配置了Release,会直接导出API文档。