xCode生成文档
来源:互联网 发布:张予曦淘宝店质量 编辑:程序博客网 时间:2024/06/06 05:54
在写代码的时候,如果按照一定的规范在头文件里写上注释的话,
就可以利用Xcode的文档自动输出功能生成一份完整的HTML项目文档。
生成的格式和Apple Developer网站上的API文档几乎是一样的。
我们来看看如何利用Xcode生成项目文档。
步骤:
1. 在XCode里点击Project,然后点Add Target给项目添加一个TARGET
2. 在添加Target的弹出对话框里,选择Aggregate,点击Next,输入一个你喜欢的名字,点击Finish
3. 你会发现TARGETS下面多了一个项目,点击它,然后在右边点击BuildPhases标签,然后点击Add Build Phase并选择Add Run Script
4. Run Script添加成功后,点击它的下拉菜单,把以下代码拷贝到代码对话框里。
5. 在XCode左上角的Scheme里选定刚才生成的Target,然后点Run。
运行以后,在你的项目文件夹里,就会生成一个文档文件夹了。
这些自动生成的文档都是根据你在源代码里写的注释生成的。
下面就详细介绍一下各种能自动生成文档的注释
■ header : 头文件基本信息。这个用在每个源代码文件的头文件的最开头。
例如:
/*!
@header 这里的信息应该与该源代码文件的名字一致
@abstract 关于这个源代码文件的一些基本描述
@author Kevin Wu (作者信息)
@version 1.00 2012/01/20 Creation (此文档的版本信息)
*/
@header 这里的信息应该与该源代码文件的名字一致
@abstract 关于这个源代码文件的一些基本描述
@author Kevin Wu (作者信息)
@version 1.00 2012/01/20 Creation (此文档的版本信息)
*/
■ class: 类信息。此注释用在类声明的开头。
例如:
/*!
@class
@abstract 这里可以写关于这个类的一些描述。
*/
@interface MyClass : NSObject {
}
@class
@abstract 这里可以写关于这个类的一些描述。
*/
@interface MyClass : NSObject {
}
■ property: property的相关注释。
/*!
@property
@abstract 这里可以写关于这个Property的一些基本描述。
*/
@property (nonatomic,readonly) NSString *helloDocText_;
@property
@abstract 这里可以写关于这个Property的一些基本描述。
*/
@property (nonatomic,readonly) NSString *helloDocText_;
■ method: 函数(方法)的相关注释。
/*!
@method
@abstract 这里可以写一些关于这个方法的一些简要描述
@discussion 这里可以具体写写这个方法如何使用,注意点之类的。如果你是设计一个抽象类或者一个
共通类给给其他类继承的话,建议在这里具体描述一下怎样使用这个方法。
@param text 文字 (这里把这个方法需要的参数列出来)
@param error 错误参照
@result 返回结果
*/
- (BOOL)showText:(NSString *)text
error:(NSError **)error;
@method
@abstract 这里可以写一些关于这个方法的一些简要描述
@discussion 这里可以具体写写这个方法如何使用,注意点之类的。如果你是设计一个抽象类或者一个
共通类给给其他类继承的话,建议在这里具体描述一下怎样使用这个方法。
@param text 文字 (这里把这个方法需要的参数列出来)
@param error 错误参照
@result 返回结果
*/
- (BOOL)showText:(NSString *)text
error:(NSError **)error;
■ enum: enum的相关注释。
/*!
@enum
@abstract 关于这个enum的一些基本信息
@constant HelloDocEnumDocDemoTagNumberPopupView PopupView的Tag
@constant HelloDocEnumDocDemoTagNumberOKButton OK按钮的Tag
*/
typedef enum HelloDocEnumDocDemo_{
HelloDocEnumDocDemoTagNumberPopupView = 100,
HelloDocEnumDocDemoTagNumberOKButton,
}HelloDocEnumDocDemo;
@enum
@abstract 关于这个enum的一些基本信息
@constant HelloDocEnumDocDemoTagNumberPopupView PopupView的Tag
@constant HelloDocEnumDocDemoTagNumberOKButton OK按钮的Tag
*/
typedef enum HelloDocEnumDocDemo_{
HelloDocEnumDocDemoTagNumberPopupView = 100,
HelloDocEnumDocDemoTagNumberOKButton,
}HelloDocEnumDocDemo;
■ category: category的相关注释。
/*!
@category
@abstract NSString的Category
*/
@interface KevinNSString (NSString)
@category
@abstract NSString的Category
*/
@interface KevinNSString (NSString)
■ protocol: protocol的相关注释
/*!
@protocol
@abstract 这个HelloDoc类的一个protocol
@discussion 具体描述信息可以写在这里
*/
@protocol HelloDocDelegate <NSObject>
@protocol
@abstract 这个HelloDoc类的一个protocol
@discussion 具体描述信息可以写在这里
*/
@protocol HelloDocDelegate <NSObject>
0 0
- XCode生成文档
- XCode生成文档
- xcode生成文档
- xCode生成文档
- XCode生成文档
- Xcode生成代码文档
- xcode快速生成文档
- xcode 生成项目文档
- Xcode生成API文档
- 利用Xcode自动生成文档
- Xcode自动生成项目文档
- Appledoc 生成xcode 注释文档
- Xcode 生成文档与注释
- 利用xcode自动生成项目文档
- xcode下生成注释和文档
- Xcode配置Appledoc并生成项目文档
- xcode 自动添加注释,生成文档
- xcode 自动添加注释,生成文档
- 邻接表
- H2内存数据库 支持存储到文件
- spring mvc + freemarker 的简单实现全步骤
- 1012. The Best Rank (25)
- IPSEC.CONF(5) - IPsec配置
- xCode生成文档
- crm使用soap发布应用程序
- android发送邮件
- 实习两周总结-Unity
- 探索性数据分析week3
- <<the architecture of open source applications>> 中关于虚拟机复制与迁移(下)
- opencv--cvReleaseImage()函数出错
- (Miller Rabin算法)判断一个数是否为素数
- Android 零基础学习之路