如何编写含多控制器的UINavigationController的Xcode UI测试用例？

哈哈，确实，单页面的UI测试写起来顺手，但碰到带多层控制器的UINavigationController时，就得稍微调整下思路了——核心是模拟用户真实的操作路径，一步步在导航栈里跳转、验证，而不是直接硬定位深层元素。下面给你梳理下具体的做法：

1. 先理清用户的操作路径 #

首先得明确这个导航栈里的典型用户流程：比如从根控制器（首页）→ 点击按钮进入二级页面→ 操作后进入三级页面→ 返回上一级→ 再跳转其他分支。测试用例要完全贴合这个路径，不要跳步，不然很容易出现定位失效的问题。

2. 抛弃脆弱的层级定位，改用更可靠的方式 #

你示例里的链式children(matching:)定位特别脆弱，只要页面布局微调，测试就会挂掉。推荐这两种更稳定的定位方式：

• 给控件设置accessibilityIdentifier：这是UI测试的最佳实践！给导航栏按钮、列表单元格、输入框等都设上唯一ID，比如给首页跳转按钮设为"home_to_list_btn"，之后直接用app.buttons["home_to_list_btn"]就能定位，完全不用管层级。
• 用自然属性定位：如果控件文本/标题是固定的，也可以直接用，比如app.navigationBars["列表页面"].buttons["返回"]，可读性和稳定性都不错。

3. 完整的多导航控制器测试示例 #

假设我们的导航栈是：根控制器（首页）→ 列表页面→ 详情页面，测试用例可以这么写：

func testFullNavigationFlow() {
    let app = XCUIApplication()
    app.launch()
    
    // 步骤1：从首页跳转至列表页面
    app.buttons["进入列表"].tap()
    // 验证是否成功跳转：检查导航栏标题是否正确
    XCTAssertTrue(app.navigationBars["列表页面"].exists)
    
    // 步骤2：在列表页点击某一行进入详情页
    let targetCell = app.tables.cells["第1条数据"]
    // 加个等待，避免网络加载慢导致元素未出现
    XCTAssertTrue(targetCell.waitForExistence(timeout: 3))
    targetCell.tap()
    // 验证详情页核心元素存在
    XCTAssertTrue(app.staticTexts["详情标题"].exists)
    
    // 步骤3：从详情页返回列表页
    app.navigationBars["详情页面"].buttons["返回"].tap()
    XCTAssertTrue(app.navigationBars["列表页面"].exists)
    
    // 步骤4：从列表页返回首页
    app.navigationBars["列表页面"].buttons["返回"].tap()
    XCTAssertTrue(app.navigationBars["首页"].exists)
}

4. 额外的实用小技巧 #

• 处理模态弹出的导航控制器：如果是用present弹出的导航控制器，要先等待模态窗口加载完成，比如XCTAssertTrue(app.navigationBars["模态页面"].waitForExistence(timeout: 5))，避免测试超时。
• 验证导航栈状态：如果需要确认当前导航栈的层级，可以通过检查返回按钮的数量、或者页面专属元素来判断，比如首页没有返回按钮，二级页面有一个返回按钮，三级页面有两个（返回+首页）。
• 复用常用操作：如果多个测试用例都需要走相同的跳转路径，可以把这些步骤封装成方法，比如func navigateToListPage(app: XCUIApplication)，减少重复代码。

内容的提问来源于stack exchange，提问作者NNikN