swift 2.2 和 xcode 7.3 中的模拟和文档

Question

实际上，我正在我的大学学习 IOS 开发课程，但遗憾的是，一些有趣的主题不会被彻底解释。关于这些主题，我有两个主要问题。

我的第一个问题是：

在 xcode 7 上使用第三方库（如 Alamofire）或在他的应用程序中解析时，如何在他的单元测试中模拟 http 请求？

我的第二个问题与文档有关。我最近读到 xcode 7 中 swift 的代码注释过程发生了变化。

我想知道是否有一些好的工具可以根据代码注释生成文档，有点像 javaDoc 或 apidoc 所做的那样？

我提前感谢您提供任何解释、提示、教程，甚至只是对涵盖这两个问题的一些好的资源的指导。

祝你有美好的一天并致以最诚挚的问候，

马丁

Answer 1

模拟网络请求

您可以使用OCMock or OHHTTPStubs模拟网络请求。网上有很多资料。

另一种选择是使用本地 HTTP 服务器。例如，设置 Sinatra server 只需几行代码。这很有用，当您想测试更多较低级别的细节时，例如您的查询参数是否正确组合。

Swift 文档

工具链支持 Swift 源代码和游乐场的特定文档语法。这记录在这里：Markup Formatting Reference.

这是一个示例：

/**
 If `self` is `Success` returns the mapping function `f` applied to the
 value of `Success`. Otherwise, returns a new `Try` with the value of
 `Failure`.

 - parameter f: The maping function.
 - returns: A `Try<U>`.
 */
public func flatMap<U>(@noescape f: T -> Try<U>) -> Try<U> {
    switch self {
    case .Success(let value):
        return f(value)
    case .Failure(let error):
        return Try<U>(error: error)
    }
}

像这样记录的来自第三方库的源代码将使该框架的任何用户在使用 Xcode.

编辑时能够在他们的代码中获得快速帮助

要为您的图书馆创建 HTML 文档（和其他类型的文档），您可以使用 Jazzy。 Jazzy 是一个命令行工具，它直接从源代码创建 HTML 文档。在您的项目中，您可以设置一个 "build task" 来创建文档。

如果您通过 CocoaPods service, the documentation will be automatically created by CocoaPods service (using Jazzy for Swift and AppleDoc for Objective-C) and is available publicly. See here an example: http://cocoadocs.org/docsets/Alamofire/3.3.1/

发布您的图书馆

swift 2.2 和 xcode 7.3 中的模拟和文档

Mocking and documentation in swift 2.2 and xcode 7.3

testing

xcode

mocking

ios

swift

模拟网络请求

Swift 文档