Appium getClipboardText()在Android 10及以上版本失效及返回null问题咨询

这个问题我之前做Appium自动化测试时也碰到过，核心原因是Android 10（API 29）及以上系统对剪贴板访问权限做了严格限制，再加上旧版Appium Android Driver的兼容性缺陷，才导致getClipboardText()无法正常获取内容。下面给你几个可行的解决方案：

1. 确保测试应用处于前台状态 #

Android 10+明确禁止后台应用访问剪贴板，所以在调用getClipboardText()之前，必须保证你的测试App处于前台活跃状态。可以用Appium的activateApp()方法强制切换到目标应用：

if (Constants.isAndroidTest) {
    AndroidDriver<WebElement> androidDriver = (AndroidDriver<WebElement>) oDriver;
    // 替换成你的测试应用包名
    androidDriver.activateApp("com.your.test.app.package");
    sData = androidDriver.getClipboardText();
} else {
    sData = ((IOSDriver<WebElement>) oDriver).getClipboardText();
}

2. 升级Appium Android Driver版本 #

旧版本的Appium Android Driver没有适配Android 10+的剪贴板机制，建议你把Android Driver升级到4.0.0及以上的稳定版（可通过Maven或npm更新依赖）。新版本已经修复了这个兼容性问题，原生的getClipboardText()方法就能正常工作。

3. 用adb命令兜底获取剪贴板内容 #

如果升级驱动后还是有问题，可以直接通过adb shell命令获取剪贴板内容，绕过Appium的API限制，这个方法在Android 10+上非常可靠：

if (Constants.isAndroidTest) {
    AndroidDriver<WebElement> androidDriver = (AndroidDriver<WebElement>) oDriver;
    // 执行adb命令获取剪贴板内容
    sData = (String) androidDriver.executeScript("mobile: shell", 
        ImmutableMap.of("command", "cmd clipboard get"));
} else {
    sData = ((IOSDriver<WebElement>) oDriver).getClipboardText();
}

注意：cmd clipboard get是Android 10新增的系统命令，刚好适配你的目标版本。

4. 处理WebView场景的特殊情况 #

如果你的测试场景是在WebView中操作剪贴板，需要先切换到原生上下文再调用剪贴板API——因为WebView的剪贴板和原生系统剪贴板是相互独立的：

if (Constants.isAndroidTest) {
    AndroidDriver<WebElement> androidDriver = (AndroidDriver<WebElement>) oDriver;
    // 切换到原生上下文
    androidDriver.context("NATIVE_APP");
    // 获取剪贴板内容
    sData = androidDriver.getClipboardText();
    // 切回WebView上下文（如果后续需要继续WebView操作）
    androidDriver.context("WEBVIEW_com.your.test.app.package");
} else {
    sData = ((IOSDriver<WebElement>) oDriver).getClipboardText();
}

内容的提问来源于stack exchange，提问作者Abhishek M S