我希望这不是重复的，但是在浏览了其他问题之后，我认为它可以提出我在 Appledoc 2.2-963 中遇到的几个问题。我使用 brew 安装，效果很好，Apple doc 一直在为我生成很棒的文档，但我觉得每次运行时软件段都会出错和中断，这对我来说是错误的。下面是我用来在我的工作目录中运行带有项目文件的 appledoc 的脚本。
#! /bin/bash
appledoc \
--project-name "GSFDataCollector" \
--project-company "GSF SDP Team" \
--company-id "com.sdpllnl" \
--docset-feed-url "https://github.com/mbaptist23/open-fusion-ios" \
--docset-package-url "https://github.com/mbaptist23/open-fusion-ios" \
--docset-fallback-url "https://github.com/mbaptist23/open-fusion-ios" \
--output "~/help" \
--publish-docset \
--logformat xcode \
--keep-undocumented-objects \
--keep-undocumented-members \
--no-repeat-first-par \
--ignore "*.m" \
--ignore "*.mm" \
--ignore "GoogleMaps.bundle" \
--ignore "GoogleMaps.framework" \
--ignore "GSFDataCollecter.*" \
--ignore "Pods" \
--ignore "Podfile" \
--ignore "Podfile.lock" \
--ignore "LICENCE" \
--index-desc "./README.md" \
"."
此外，我正在使用此处找到的 VVDocumenter：https ://github.com/onevcat/VVDocumenter-Xcode 。
一切似乎都很好，但是我得到了一些错误。分段错误：11，另一个错误是出了点问题。（无法为这个快速问题重现它）。无论如何，你明白了。每次使用都会崩溃。
这也是我使用 VV 进行记录的示例
//
// GSFSpinner.h
// GSFDataCollecter
//
// Created by Michael Baptist on 3/13/14.
// Copyright (c) 2014 Michael Baptist - LLNL. All rights reserved.
//
#import <UIKit/UIKit.h>
@interface GSFSpinner : UIView
/**
* Creates a default spinner in the middle of the screen.
*
* @return A new GSFSpinner.
*/
- (id)init;
/**
* Creates a spinner with custom size and custom location.
*
* @param frame The frame for the new GSFSpinner to be used.
*
* @return A new GSFSpinner with custom frame.
*/
- (id)initWithFrame:(CGRect)frame;
/**
* The actual spinner itself that is inside the custom view. Since this is a regular UIActivity spinner. The developer can customize it how ever they want.
*/
@property (nonatomic) UIActivityIndicatorView *spinner;
/**
* Label that says why the spinner is spinning.
*/
@property (nonatomic) UILabel *label;
/**
* Width of the view containing the spinner.
*/
@property (nonatomic) NSUInteger width;
/**
* Height of the view containing the spinner.
*/
@property (nonatomic) NSUInteger height;
// sets the label text to white system font of size 14
/**
* Sets the label tetx to white system font of size 14.
*
* @param text The text to be inserted into the label.
*/
- (void)setLabelText:(NSString*)text;
@end
我想我的问题是，即使它工作了一半，我这样做是否正确？还有一种方法可以在我的工作目录中将文档生成为 html，以便我也可以将其推送到 github（或者这不是一个好习惯）？我只是想学习这一点，除了提供的 --help 选项和一些非常低于 IMO 的博客之外，似乎很少有好的使用示例。
无论如何，非常感谢其他人发现这篇文章有帮助，因为我确实知道其他人看到过类似的问题但只是放弃了，我认为这是一个用户错误。
——迈克尔·巴蒂斯特
编辑：
另外我忘了提到这也是说我的所有课程都没有记录，例如上面提供的示例。这是因为我没有完成或其他事情，或者我做错了。
啊.. 最后一件事是有一种方法可以将基础类也链接到文档中。例如在函数中使用 NSArray 并将 NSArray 链接到主文档集。
再次感谢。
编辑：2014 年 4 月 7 日
这是一个典型的崩溃报告。
2014-04-07 11:38:50.555 appledoc[69348:507] -[__NSCFArray errorHandleDataReceived:]: unrecognized selector sent to instance 0x7fce10289f90
Oops, something went wrong...
NSInvalidArgumentException: -[__NSCFArray errorHandleDataReceived:]: unrecognized selector sent to instance 0x7fce10289f90
@ 0 CoreFoundation 0x00007fff8399725c __exceptionPreprocess + 172
@ 1 libobjc.A.dylib 0x00007fff857cae75 objc_exception_throw + 43
@ 2 CoreFoundation 0x00007fff8399a12d -[NSObject(NSObject) doesNotRecognizeSelector:] + 205
@ 3 CoreFoundation 0x00007fff838f53f2 ___forwarding___ + 1010
@ 4 CoreFoundation 0x00007fff838f4f78 _CF_forwarding_prep_0 + 120
@ 5 CoreFoundation 0x00007fff83965e0c __CFNOTIFICATIONCENTER_IS_CALLING_OUT_TO_AN_OBSERVER__ + 12
@ 6 CoreFoundation 0x00007fff83859a6d _CFXNotificationPost + 2893
@ 7 Foundation 0x00007fff863947ba -[NSNotificationCenter postNotificationName:object:userInfo:] + 68
@ 8 Foundation 0x00007fff8648d450 _performFileHandleSource + 1548
@ 9 CoreFoundation 0x00007fff838c8731 __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 17
@ 10 CoreFoundation 0x00007fff838b9f69 __CFRunLoopDoSources0 + 441
@ 11 CoreFoundation 0x00007fff838b962f __CFRunLoopRun + 831
@ 12 CoreFoundation 0x00007fff838b90b5 CFRunLoopRunSpecific + 309
@ 13 HIToolbox 0x00007fff892cba0d RunCurrentEventLoopInMode + 226
@ 14 HIToolbox 0x00007fff89417a81 GetNextEventMatchingMask + 349
@ 15 HIToolbox 0x00007fff8941787a WNEInternal + 168
@ 16 HIToolbox 0x00007fff894177c6 WaitNextEvent + 52
@ 17 AppleScript 0x000000010beefaf9 _Z19AEDefaultActiveProcPv + 131
@ 18 AppleScript 0x000000010bef4400 _Z23InternalComponentActivej + 82
@ 19 AppleScript 0x000000010bf229eb _Z13UASRemoteSendhhhhhPh + 653
@ 20 AppleScript 0x000000010bf2dfdb _Z13UASValue_Sendhh14TUASClassIndexh + 329
@ 21 AppleScript 0x000000010bf0950b _Z11UASExecute1v + 321
@ 22 AppleScript 0x000000010bf09378 _Z10UASExecuteh + 188
@ 23 AppleScript 0x000000010bed95ba _Z9ASExecutejjiPj + 460
@ 24 AppleScript 0x000000010bed530d AppleScriptComponent + 845
@ 25 AppleScript 0x000000010beef523 _ZN12AGenericCall8DelegateEP23ComponentInstanceRecord + 37
@ 26 AppleScript 0x000000010beef4e9 _ZN15AGenericManager13HandleOSACallEP19ComponentParameters + 57
@ 27 AppleScript 0x000000010beeeaf8 GenericComponent + 104
@ 28 OpenScripting 0x00007fff8fc7bff1 OSAExecute + 72
@ 29 Foundation 0x00007fff86455ae2 -[NSAppleScript(NSPrivate) _executeWithMode:andReturnError:] + 127
@ 30 appledoc 0x00000001091223c4 appledoc + 304068
@ 31 appledoc 0x0000000109109648 appledoc + 202312
@ 32 CoreFoundation 0x00007fff838cb479 __53-[__NSArrayM enumerateObjectsWithOptions:usingBlock:]_block_invoke + 137
@ 33 CoreFoundation 0x00007fff838cac1f -[__NSArrayM enumerateObjectsWithOptions:usingBlock:] + 319
@ 34 appledoc 0x0000000109109465 appledoc + 201829
@ 35 appledoc 0x00000001090dbf9a appledoc + 16282
@ 36 appledoc 0x00000001090da756 appledoc + 10070
@ 37 appledoc 0x00000001090da956 appledoc + 10582
@ 38 appledoc 0x00000001090d9e74 appledoc + 7796
@ 39 ??? 0x000000000000002c 0x0 + 44