亲自体验安装使用AppleDoc（iOS编写接口文档工具(网页版
亲自体验安装使用AppleDoc（iOS编写接口文档工具(网页版)）
在写文章前，我想吐槽下，现在文章一大抄，就是看你会抄不会抄。一搜索AppleDoc教程一大堆，但是按照教程做的话，又是错误一大堆，每个教程似乎出自一个人的风格，太奇怪了，有规则和业界良心（可以借鉴别人的，但是也要改改啊，不提倡自己不亲自操作下就抄袭别人的文章）？？？要么不写，要写就写自己的体验感受。对于我这样的小白，看着文档，截图教程又不全面，实在是抓耳挠腮。。。
于是决定自己写一下教程：
1：安装appledoc
使用终端下载：
命令行：
git clone git://github.com/tomaz/appledoc.git
cd ./appledoc
sudo sh install-appledoc.sh
查看是否安装成功：
命令行：
appledoc --version
git clone git://github.com/tomaz/appledoc.git
git clone git://github.com/tomaz/appledoc.git
git clone git://github.com/tomaz/appledoc.git
cd appledoc
sudo sh install-appledoc.sh
当出现INSTALL SUCCESS时说明成功了，你也可以用appledoc --version查看验证下
appledoc --version
2.前期的安装搞好了，接下来是重头戏，也是最容易出错的，就是在这一步，网上一大堆错误，或者不全的教程命令，👵的
都是首先进入到工程目录下，仔细看下面截图，你就懂：
cd /Users/zhaotong/Desktop/iOS资料/思维/04-UITextField练习
appledoc --output ./doc --project-name 04-UITextField练习 --project-company "ttdiOS" --company-id "com.ttdiOS" .
appledoc --no-create-docset --output ./doc --project-name 04-UITextField练习 --project-company "ttdiOS" --company-id "com.ttdiOS" .
appledoc --output ./doc --project-name 04-UITextField练习 --project-company "ttdiOS" --company-id "com.ttdiOS" .
appledoc --no-create-docset --output ./doc --project-name 04-UITextField练习 --project-company "ttdiOS" --company-id "com.ttdiOS" .
上面的2步后就可以在工程目录下出现doc文件夹。
Safari打开index.html就是我们最后的网页api接口文档
index.html
怎么样是不是和我们的官方文档一样😁
闲上面的2步太多，也可以试试这个方法：
appledoc --project-name="04-UITextField练习" --project-company="ttdiOS" --company-id="com.ttdiOS" --output="./" --docset-install-path="./" .
／／／／／／／／／参数说明／／／／／／／／
生成的信息如下：
如果设置设置companyID，则生成文件名为 companyID.projectName.docset
如果不设置则文件名为com.companyname.projectname.projectName.docset
--project-name，--project-company必须输入
--output 为生成的txt文件的目录，这里设置为当前目录
--docset-install-path 为生成docket的目录，这里设置为当前目录。如果此目录不设置，默认会在~/Library/Developer/Shared/Documentation/DocSets/目录生成
／／／／／／／／／参数说明／／／／／／／／
appledoc --project-name="04-UITextField练习" --project-company="ttdiOS" --company-id="com.ttdiOS" --output="./" --docset-install-path="./" .
会在工程目录下出现：
com.ttdiOS.04-UITextField练习.docset和docset-installed.txt
对com.ttdiOS.04-UITextField练习.docset双击出现菜单，选：显示包内容，就会出现下面的文件，最终我们需要的是：index.html（和上面的效果相同）
index.html
补充：当你cd 把工程拖入终端后，执行上面的命令后，出现：
*** Assertion failure in +[GBMethodData methodDataWithType:result:arguments:], /Users/zhaotong/Desktop/911doc/appledoc/Model/GBMethodData.m:44
Oops, something went wrong...
NSInternalInconsistencyException: Invalid parameter not satisfying: [arguments count] >= 1
appledoc/Model/GBMethodData.m:44
这样的错误时，你不要懵逼，去网上查找时，教程又是太少了，不是英文就是，抄袭别人的，驴👄不对马嘴
我当时遇到时也是很懵逼，执行别的工程都没事，唯独到用的时候了出现问题。
🙏这位的文章：Objective-C 自动生成文档工具:appledoc 使用，第一次阅读时，没读懂，多读几次就好了，其实是他把关键词写错了（本来很简单的操作，让你苦恼怎么去解决，不用怕，这时候，你今天目录中文件目录中 按照上面的操作方法再操作一次，这时候，）
正确的修改应该是：本来很简单的操作，让你苦恼怎么去解决，不用怕，这时候，你就去工程里的文件夹目录下 按照上面的操作方法再操作一次，这时候，就好了
没听懂的如图：cd到箭头的文件夹下执行命令就好了，
再不行就再进入里面的文件夹下，依次类堆。。。
个人感觉出现appledoc/Model/GBMethodData.m:44问题应该是工程太大了，进入到里面子目录下执行命令就是
也可以看看其他文章：iOS使用appledoc来创建开发文档（装逼使用）
