在云端 Mac 上用 simctl 建立 iOS 生物识别回归测试

登录页刚完成一次重构，本地验证了密码回退，却没人注意到“未录入生物识别”分支已经无法继续。直到测试环境复用了一台旧模拟器，流程才随机卡住。这类问题不在算法，而在测试没有控制认证状态。云端 Mac 适合把模拟器状态、认证事件和清理步骤固化成流水线，让每次提交都覆盖同一组分支。

先划清自动化边界

simctl biometric 能模拟已录入、未录入、匹配和不匹配事件，适合检查应用收到结果后的界面与状态转换。它不能验证传感器、真实录入过程，也不能证明设备级安全性。测试目标应限定为四件事：

模拟器测试证明的是“应用正确处理系统结果”，不是“生物特征本身可靠”。

真实设备验收仍要保留，但不必把每个业务分支都压在人工操作上。

把系统认证封装成可替换边界

若视图控制器直接创建认证上下文，单元测试只能等待系统弹窗。更稳的做法是定义小协议，让生产实现调用系统框架，测试实现返回确定结果。

import LocalAuthentication

protocol BiometricAuthenticating {
    func authenticate(reason: String) async throws -> Bool
}

struct SystemBiometricAuthenticator: BiometricAuthenticating {
    func authenticate(reason: String) async throws -> Bool {
        let context = LAContext()
        var error: NSError?
        guard context.canEvaluatePolicy(
            .deviceOwnerAuthenticationWithBiometrics,
            error: &error
        ) else {
            throw error ?? LAError(.biometryNotAvailable)
        }
        return try await context.evaluatePolicy(
            .deviceOwnerAuthenticationWithBiometrics,
            localizedReason: reason
        )
    }
}

业务层只接收 BiometricAuthenticating。单元测试负责穷举错误映射，界面测试则保留少量端到端用例，确认系统面板出现后，成功、失败与回退按钮确实连接到正确页面。这样即使系统提示文案随版本变化，核心判断也不会依赖脆弱的全文匹配。

固定模拟器并驱动认证状态

先查看当前工具支持的参数，避免把另一套运行环境里的命令格式直接复制过来：

xcrun simctl help biometric
xcrun simctl list devices available

流水线不要使用模糊的 booted 选择器。并行任务同时启动设备时，它可能命中错误实例。应由任务创建或领取唯一 UDID，再贯穿全部命令：

set -euo pipefail

UDID="${SIMULATOR_UDID:?missing simulator udid}"

xcrun simctl boot "$UDID" 2>/dev/null || true
xcrun simctl bootstatus "$UDID" -b
xcrun simctl biometric "$UDID" unenroll
xcrun simctl biometric "$UDID" enroll

启动测试后，必须等认证面板真正就绪再发送事件。固定休眠两秒在负载变化时很容易失效。可让测试构建在触发认证前输出自有标记，例如 AUTH_PROMPT_READY，外层控制器在带超时的日志流里观察到标记后再执行：

xcrun simctl biometric "$UDID" match face
xcrun simctl biometric "$UDID" nonmatch face

不同运行环境接受的生物类型参数可能有差异，因此最终命令应以本机 help biometric 输出为准，并在环境预检阶段失败，而不是运行到测试中途才发现不兼容。

让用例彼此独立

生物识别录入状态属于模拟器，不属于单个测试方法。前一条用例留下的 enroll 会污染后一条“未录入”测试。建议每个场景明确写前置状态，并在测试结束时恢复：

cleanup() {
  xcrun simctl biometric "$UDID" unenroll 2>/dev/null || true
  xcrun simctl shutdown "$UDID" 2>/dev/null || true
}
trap cleanup EXIT

不要共享同一设备集

同一台 LemonVM 云端 Mac 上并行跑多个测试分片时，为每个任务设置独立的 --set 目录或预先分配不同 UDID。设备集、DerivedData 和结果包都应使用任务标识分目录，避免一个任务擦除另一个任务的设备。

不要断言系统文案

系统对话框会受系统版本、语言和设备能力影响。界面测试应寻找系统面板、应用自有按钮和最终业务状态，不要逐字断言系统提示。错误类型的精确映射放到协议替身的单元测试里完成。

建立失败取证与准入清单

失败时至少保存测试结果包、应用日志、目标 UDID、系统版本、模拟器型号和用例开始前的录入状态。只截一张失败画面往往无法判断是事件过早、设备选错，还是应用没有消费回调。

提交前可按以下清单验收：

• 认证实现可注入，业务层不直接依赖系统上下文。
• 成功、拒绝、未录入和不可用四条路径都有确定断言。
• 每个并行任务持有独立 UDID，不使用全局 booted。
• 发送事件前有可观测的就绪标记和超时。
• 每条用例显式设置录入状态，退出时执行清理。
• 失败产物包含结果包、日志和模拟器信息。
• 发布流程仍保留真实设备上的最小验收。

这套结构的价值不在于多跑几个命令，而在于把“认证状态”从不可见前提变成测试输入。只要输入、设备和时序都能被记录，生物识别回归就能从偶发人工检查变成可重复的工程步骤。

常见问题