用途:在截图自动化工具(如 Maestro 或 AXe)能稳定点击元素之前,需要为应用元素添加稳定的无障碍标识符。本技能说明如何跨框架添加这些标识符。
主要能力:按框架给出添加方式。Flutter 3.19+ 使用 Semantics(identifier: ...);SwiftUI 使用 .accessibilityIdentifier("settings_button");UIKit 设置 button.accessibilityIdentifier = "settings_button";Jetpack Compose 在 Modifier.semantics { testTag = "settings_button" } 中使用 testTag;Android XML 视图需同时设置 android:id 与 android:tag,Maestro 使用 android:tag 作为 id: 选择器;React Native 使用 testID。
命名规范:统一使用 context_element 模式,小写加下划线;按屏幕或上下文加前缀避免冲突;列表项使用索引(list_item_0);不要使用本地化文本作为标识符;保持简短且具描述性。文中还提供导航、功能卡片、列表项、屏幕内操作的示例命名。
验证方式:通用可用 maestro studio 打开浏览器界面点击元素查看标识符;iOS 可用 axe describe-ui --udid <SIMULATOR_UDID>;各框架也可用对应的调试工具,如 Flutter 的 showSemanticsDebugger、Xcode Accessibility Inspector、Android Layout Inspector、Appium Inspector。
适用场景与限制:适用于准备截图自动化前为导航标签、主操作、可滚动内容项、关键操作按钮、弹窗触发器等添加标识符。需避免给非交互部件添加标识符、使用本地化字符串、忘记重新构建、在同一屏幕重复使用同一标识符,以及 XML Android 仅用 android:id 而不用 android:tag。