iOS14下SwiftUI ToolbarItem的accessibilityIdentifier不生效问题

这是SwiftUI在iOS 14版本的原生框架缺陷：iOS 14 中ToolbarItem的视图渲染逻辑存在漏洞，开发者直接给ToolbarItem实例设置的accessibilityIdentifier不会透传到最终渲染生成的可点击UIBarButtonItem原生控件上——系统对导航栏工具栏按钮做封装时会丢弃外层自定义的无障碍属性，该透传逻辑直到iOS 15才被苹果修复，因此会出现高版本系统识别正常、iOS 14下Appium无法通过ID定位到元素的问题。

• 方案1：调整属性绑定层级（推荐）
  不要直接给ToolbarItem本身挂载accessibilityIdentifier，将属性直接绑定到ToolbarItem内部包裹的可点击控件上，示例代码：

  // 错误写法（iOS14不生效）
  ToolbarItem(placement: .navigationBarTrailing) {
      Image(systemName: "gear")
  }
  .accessibilityIdentifier("nav_setting_btn")
  
  // 正确写法（iOS14/15均生效）
  ToolbarItem(placement: .navigationBarTrailing) {
      Button(action: {
          // 按钮点击业务逻辑
      }) {
          Image(systemName: "gear")
      }
      .accessibilityIdentifier("nav_setting_btn")
  }
  

  注意：iOS14下不要在Button外层套HStack、ZStack等布局容器，否则无障碍属性还是会被系统过滤丢弃。
• 方案2：原生视图遍历补全属性
  如果业务场景无法调整内部控件结构，可以在页面onAppear生命周期里，通过UIKit接口遍历导航栏子视图，手动给对应工具栏按钮赋值无障碍ID，示例代码：

  NavigationView {
      // 页面主体内容
  }
  .onAppear {
      guard #available(iOS 15, *) else {
          // 仅iOS14及以下版本做手动补全
          let keyWindow = UIApplication.shared.connectedScenes
              .filter({$0.activationState == .foregroundActive})
              .compactMap({$0 as? UIWindowScene})
              .first?.windows.first(where: \.isKeyWindow)
          guard let navBar = keyWindow?.rootViewController?.view.subviews.first(where: { $0 is UINavigationBar }) as? UINavigationBar else { return }
          // 按业务实际匹配对应位置的按钮赋值ID，例：右上角设置按钮
          navBar.topItem?.rightBarButtonItem?.accessibilityIdentifier = "nav_setting_btn"
          return
      }
  }
  

• 方案3：测试端定位逻辑兜底
  如果代码端暂时无法发版适配，可以在Appium的iOS14测试用例中临时切换定位方式，不用accessibilityIdentifier定位，改用元素的可见文本、图标默认label、相对层级XPath做定位，等应用最低支持版本升级到iOS15后再切回ID定位即可。

• 适配完成后优先用Xcode自带的Accessibility Inspector连接iOS14测试设备，直接点选对应工具栏按钮，检查元素属性面板中是否正确展示你设置的ID，确认属性生效后再运行Appium用例，减少重复调试成本。
• iOS14下不要给同一个工具栏按钮同时设置accessibilityLabel和accessibilityIdentifier，两个属性同时存在时系统会优先取Label值覆盖ID，导致Appium无法识别到你配置的Identifier。

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