一个用 Swift 和 Objective-C 编写的 Mach 异常处理程序,允许捕获和测试 EXC_BAD_INSTRUCTION
(由 Swift 的 assertionFailure
/preconditionFailure
/fatalError
引发)。
注意:iOS 代码仅在模拟器中运行。它用于逻辑测试,由于 Mach 异常 API 在 iOS 上是私有的,因此无法部署到设备。
有关此代码的更深入讨论,请参阅 Cocoa with Love 的文章
从 2.0.0-beta.1 版本开始,构建 CwlPreconditionTesting 需要 Swift 5 或更高版本以及 Swift Package Manager 或 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 项目的依赖项管理器。 有关使用和安装说明,请访问他们的网站。 要使用 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 添加的帮助。