OCMockito 技术文档

1. 安装指南

OCMockito 支持多种安装方式，用户可以根据自己的项目需求选择合适的安装方法。

1.1 Swift Package Manager

在 Xcode 项目中，选择 File > Swift Packages > Add Package Dependency，然后输入以下 URL：

https://github.com/jonreid/OCMockito.git

1.2 CocoaPods

在项目根目录下创建或更新 Podfile 文件，添加以下内容：

pod 'OCMockito'

然后执行以下命令：

pod install

1.3 Carthage

在项目根目录下创建或更新 Cartfile 文件，添加以下内容：

github "jonreid/OCMockito"

然后执行以下命令：

carthage update

1.4 预编译框架

下载预编译的 OCMockito 框架，将其拖入项目。

1.5 自行编译

从 GitHub 下载 OCMockito 源代码，然后在 Xcode 中打开项目并构建。

2. 项目使用说明

OCMockito 是一个 Objective-C 实现，支持创建、验证和存根模拟对象。以下是 OCMockito 的核心用法：

2.1 创建模拟对象

NSMutableArray *mockArray = mock([NSMutableArray class]);

2.2 使用模拟对象

[mockArray addObject:@"one"];
[mockArray removeAllObjects];

2.3 验证交互

[verify(mockArray) addObject:@"one"];
[verify(mockArray) removeAllObjects];

2.4 存根方法

[given([mockArray objectAtIndex:0]) willReturn:@"first"];

2.5 验证方法调用次数

[verifyCount(mockArray, times(2)) addObject:@"twice"];

3. 项目 API 使用文档

OCMockito 提供了丰富的 API 用于创建、验证和存根模拟对象，以下是一些常用的 API：

• mock(class): 创建指定类的模拟对象。
• mockProtocol(protocol): 创建指定协议的模拟对象。
• mockObjectAndProtocol(class, protocol): 创建同时实现类和协议的模拟对象。
• verify(mock): 验证模拟对象的交互。
• verifyCount(mock, times(count)): 验证模拟对象方法的调用次数。
• given(mock): 为模拟对象设置存根。
• willReturn: 设置方法调用的返回值。
• willThrow: 设置方法调用抛出的异常。
• stubProperty(mock, property, stubbedValue): 存根属性以便 KVO 能正常工作。

更多 API 和用法，请参考项目官方文档。

4. 项目安装方式

请参考上文 "1. 安装指南"。