使用appium-flutter-driver&webdriverIO实现Flutter与原生应用交互的技术问询

疑问解答与场景验证方案 #

1. ~fab的含义 #

~是Appium-Flutter-Driver中用于定位**Flutter语义化标签（Semantics Label）**的前缀。在Flutter代码里，开发者可以通过Semantics组件或给目标组件添加semanticsLabel属性来设置该标签，示例Flutter代码：

FloatingActionButton(
  semanticsLabel: 'fab',
  onPressed: () {},
)

测试代码中通过~前缀，就能精准定位到带有对应语义化标签的Flutter元素。

2. 不同定位方式的用法 #

由于你的场景需要切换到原生应用（Gmail/拨号器）操作，必须先执行await driver.switchContext('NATIVE_APP');从Flutter专属上下文切换到原生Android/iOS上下文，之后即可使用标准Appium定位方式：

按ID定位

• Android：基于resource-id定位，使用UiSelector语法
• iOS：基于accessibility-id定位，同样用~前缀

// Android：定位Gmail主题输入框
const gmailSubjectInput = await driver.$('android=new UiSelector().resourceId("com.google.android.gm:id/subject_text_view")');
await gmailSubjectInput.click();
await gmailSubjectInput.setValue('测试主题');

// iOS：定位Gmail的主题输入框（accessibility-id为"Subject"）
const gmailSubjectInputIOS = await driver.$('~Subject');

按文本定位

• Android：通过text属性匹配
• iOS：使用谓词语法匹配文本

// Android：验证拨号器中显示的目标号码
const targetPhoneNumber = await driver.$('android=new UiSelector().text("1234567890")');
await expect(targetPhoneNumber.isDisplayed()).toBe(true);

// iOS：定位拨号界面的呼叫按钮
const callButton = await driver.$('-ios predicate string:label == "Call"');
await callButton.click();

按类名定位

通过原生控件的类名定位，适合批量元素或无明确标识的场景：

// Android：定位拨号器的号码输入框
const dialInput = await driver.$('android=new UiSelector().className("android.widget.EditText")');
await dialInput.setValue('9876543210');

针对你的场景的验证方案 #

方案1：验证应用包名/ Bundle ID

切换到原生上下文后，获取当前活跃应用的标识进行断言：

await driver.switchContext('NATIVE_APP');

// Android 验证Gmail包名
const currentAndroidPackage = await driver.getCurrentPackage();
await expect(currentAndroidPackage).toBe('com.google.android.gm');
// Android 验证拨号应用包名
await expect(currentAndroidPackage).toBe('com.android.dialer');

// iOS 验证Gmail Bundle ID
const currentIOSBundleId = await driver.getCurrentDeviceActivity();
await expect(currentIOSBundleId).toBe('com.googlemail.GoogleMail');

方案2：验证Gmail的主题与正文内容

切换到原生上下文后，定位对应元素并校验文本：

await driver.switchContext('NATIVE_APP');

// 验证主题内容
const subjectContent = await driver.$('android=new UiSelector().resourceId("com.google.android.gm:id/subject_text_view")').getText();
await expect(subjectContent).toBe('预设的主题内容');

// 验证正文内容
const bodyContent = await driver.$('android=new UiSelector().resourceId("com.google.android.gm:id/body_text_view")').getText();
await expect(bodyContent).toBe('预设的正文内容');

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