一个 Mach 异常处理程序,用 Swift 和 Objective-C 编写,允许捕获并测试由 Swift 的 assertionFailure
/preconditionFailure
/fatalError
产生的 EXC_BAD_INSTRUCTION
。
注意:iOS 代码仅在模拟器中运行 仅。它是用于逻辑测试的,由于 Mach 异常 API 在 iOS 中是私有的,因此不能部署到设备。
有关此代码的详细讨论,请参见 Cocoa with Love 文章
从 2.0.0-rc.1 版本开始,构建 CwlPreconditionTesting 需要 Swift 5 或更高版本,以及 Swift 包管理器或 CocoaPods。
对于使用较旧版本的 Swift 或其他包管理器,请使用 1.2.0 或更早版本。
将以下内容添加到您的 "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 是 Cocoa 项目的依赖管理器。有关使用和安装说明,请访问他们的网站。要将 CwlPreconditionTesting 集成到您的 Xcode 项目中使用 CocoaPods,请在您的 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")
}
警告:此 POSIX 版本在附加了 lldb 时无法使用,因为 lldb 的 Mach 异常处理程序阻止 SIGILL 始终发生。您应该禁用 Xcode 中测试的 "调试可执行文件" 设置。信号处理程序的 POSIX 版本也是整个进程(而不是正确地作用到 "捕获" 发生的线程)。
包括来自 @abbeycode、@dnkoutso、@jeffh 和 @ikesyo 的贡献。特别感谢 @saagarjha 帮助添加 ARM64 支持。