CwlPreconditionTesting

一个用 Swift 和 Objective-C 编写的 Mach 异常处理程序,允许捕获和测试 EXC_BAD_INSTRUCTION(由 Swift 的 assertionFailure/preconditionFailure/fatalError 引发)。

注意:iOS 代码在模拟器中运行。它用于逻辑测试,由于 Mach 异常 API 在 iOS 上是私有的,因此无法部署到设备。

有关此代码的更深入讨论,请参阅 Cocoa with Love 的文章

Swift 中的部分函数,第 2 部分:捕获前提条件失败

要求

从 2.0.0-beta.1 版本开始,构建 CwlPreconditionTesting 需要 Swift 5 或更高版本以及 Swift Package Manager 或 CocoaPods。

对于旧版本的 Swift 或其他包管理器,使用 1.2.0 或更旧版本

添加到您的项目

Swift Package Manager

将以下内容添加到 "Package.swift" 文件中的 dependencies 数组

 .package(url: "https://github.com/mattgallagher/CwlPreconditionTesting.git", from: Version("2.0.0"))

或者,通过将 https://github.com/mattgallagher/CwlPreconditionTesting.git,版本 2.0.0 或更高版本,添加到 Xcode 中任何项目的 Swift 包列表中。

CocoaPods

CocoaPods 是 Cocoa 项目的依赖项管理器。 有关使用和安装说明,请访问他们的网站。 要使用 CocoaPods 将 CwlPreconditionTesting 集成到您的 Xcode 项目中,请在您的 Podfile 中指定它

pod 'CwlPreconditionTesting', '~> 2.0'

用法

在 macOS 和 iOS 上,您可以使用常规版本

import CwlPreconditionTesting

let e = catchBadInstruction {
	precondition(false, "THIS PRECONDITION FAILURE IS EXPECTED")
}

在 tvOS、Linux 和其他平台上,您可以使用 POSIX 版本

import CwlPosixPreconditionTesting

let e = catchBadInstruction {
	precondition(false, "THIS PRECONDITION FAILURE IS EXPECTED")
}

警告:当附加 lldb 时,无法使用此 POSIX 版本,因为 lldb 的 Mach 异常处理程序会阻止 SIGILL 的发生。 您应该禁用 Xcode 中测试的“Debug Executable”设置。 信号处理程序的 POSIX 版本也是整个进程(而不是正确地限定到“捕获”发生的线程)。

感谢

包括来自 @abbeycode, @dnkoutso, @jeffh 和 @ikesyo 的贡献。 特别感谢 @saagarjha 对 ARM64 添加的帮助。