Expecta 技术文档

1. 安装指南

Expecta 可以通过以下几种方式安装：

使用 CocoaPods

1. 在项目的 Podfile 中添加以下内容：

target :MyApp do
  # 其他应用依赖

  target :MyAppTests do
    inherit! search_paths

    pod 'Expecta', '~> 1.0'
  end
end

2. 运行 pod update 或 pod install 在项目目录下。

使用 Carthage

1. 在项目的 Cartfile.private 中添加以下内容：

github "specta/expecta" "master"

2. 运行 carthage update 在项目目录下。
3. 将对应的 Expecta.framework 从 Carthage/Build/ 拖入到 Xcode 项目中，并添加到测试目标（test target）。

手动安装

1. 从 GitHub 上克隆 Expecta。

2. 在项目目录下运行 rake 来构建框架和库。

3. 如果项目尚未设置，向 Xcode 项目中添加一个 Cocoa 或 Cocoa Touch 单元测试包目标。

4. 对于 OS X 项目，将 Products/osx 文件夹中的 Expecta.framework 拷贝并添加到项目的测试目标。

   对于 iOS 项目，将 Products/ios 文件夹中的 Expecta.framework 拷贝并添加到项目的测试目标。

   如果偏好使用静态库，可以选择使用 libExpecta.a — iOS 7.x 及以下版本需要这样做。

5. 在 Xcode 的测试目标中，添加 -ObjC 和 -all_load 到 其他链接器标志（Other Linker Flags）。

2. 项目的使用说明

Expecta 是一个用于 Objective-C 和 Cocoa 的匹配器框架。它的主要优势是不需要指定数据类型，并且其匹配器的语法更加易读，不会出现括号过多的情况。

以下是一些基本使用示例：

expect(@"foo").to.equal(@"foo");
expect(foo).notTo.equal(1);
expect([bar isBar]).to.equal(YES);
expect(baz).to.equal(3.14159);

Expecta 与框架无关，可以很好地与 XCTest 和其他兼容 XCTest 的测试框架（如 Specta、Kiwi）一起工作。

3. 项目API使用文档

Expecta 提供了多种匹配器用于测试，以下是一些常用的匹配器：

• expect(x).to.equal(y); 检查对象或原始值 x 和 y 是否相等或等效。
• expect(x).to.beIdenticalTo(y); 检查对象 x 和 y 是否完全相同（包括内存地址）。
• expect(x).to.beNil(); 如果 x 为 nil 则通过。
• expect(x).to.beTruthy(); 如果 x 计算为 true（非零）则通过。
• expect(x).to.beFalsy(); 如果 x 计算为 false（零）则通过。
• expect(x).to.contain(y); 如果 NSArray 或 NSString x 包含 y 则通过。
• expect(x).to.beSupersetOf(y); 如果 NSArray、NSSet、NSDictionary 或 NSOrderedSet x 包含 y 的所有元素则通过。
• expect(x).to.haveCountOf(y); 如果 NSArray、NSSet、NSDictionary 或 NSString x 的计数或长度为 y 则通过。
• expect(x).to.beEmpty(); 如果 NSArray、NSSet、NSDictionary 或 NSString x 为空则通过。

等等，更多匹配器请参考项目的 README 文件。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明，可通过 CocoaPods、Carthage 或手动安装来设置 Expecta。

以上内容为 Expecta 的技术文档，希望能帮助您更好地了解和使用该项目。