Appium 的 enableMultiWindows 参数

beyfound

于 2025-05-22 17:13:01 发布

阅读量300

点赞数 1

分类专栏： Appium自动化测试文章标签： appium 自动化

本文链接：https://blog.csdn.net/qiaotong1/article/details/148144866

版权

Appium自动化测试专栏收录该内容

2 篇文章

订阅专栏

引言

在移动应用自动化测试中，混合应用（Hybrid App）和多窗口场景（如分屏、弹窗、多
WebView）的处理一直是技术难点。Appium 的 enableMultiWindows
参数为这类场景提供了关键支持，但在实际使用中常因配置不当引发问题。

遇到的问题

起初在测试一个期货交易类APP时，订单发送后会有成交回报，在app的上方显示。这个提示弹出框无法被appium获取，获取page souce XML结构时无法找到这个元素。其实这就是因为在Appium初始化driver时，没有把这个参数设置成True，导致，这部分的元素XML结构不可见，所以无法定位，进行成交回报验证和下一步操作。

解决方案

可以在Appium初始化时设置把参数"enableMultiWindows": True 设置成True

caps = {
    "platformName": "Android",
    "deviceName": "emulator-5554",
    "app": "/path/to/app.apk",
    "automationName": "UiAutomator2",  # 必须使用 UiAutomator2
    "enableMultiWindows": True         # 启用多窗口支持
}

但是我们使用的时测试平台，没有底层的初始话driver的操作，就不能在初始的时候去操作这个参数，所以就研究怎么在运行时去修改Appium的参数。其实Appium的代码对外暴露的有修改设置的接口driver.setSetting(Setting.WAIT_FOR_IDLE_TIMEOUT,60);，但是这个Setting的类型时一个Enum类型，在它的源码中能看到有以下几种

    IGNORE_UNIMPORTANT_VIEWS("ignoreUnimportantViews"),
    WAIT_FOR_IDLE_TIMEOUT("waitForIdleTimeout"),
    WAIT_FOR_SELECTOR_TIMEOUT("waitForSelectorTimeout"),
    WAIT_SCROLL_ACKNOWLEDGMENT_TIMEOUT("scrollAcknowledgmentTimeout"),
    WAIT_ACTION_ACKNOWLEDGMENT_TIMEOUT("actionAcknowledgmentTimeout"),
    KEY_INJECTION_DELAY("keyInjectionDelay"),
    NATIVE_WEB_TAP("nativeWebTap"),
    IMAGE_MATCH_THRESHOLD("imageMatchThreshold"),
    FIX_IMAGE_FIND_SCREENSHOT_DIMENSIONS("fixImageFindScreenshotDims"),
    FIX_IMAGE_TEMPLATE_SIZE("fixImageTemplateSize"),
    CHECK_IMAGE_ELEMENT_STALENESS("checkForImageElementStaleness"),
    UPDATE_IMAGE_ELEMENT_POSITION("autoUpdateImageElementPosition"),
    NORMALIZE_TAG_NAMES("normalizeTagNames"),
    IMAGE_ELEMENT_TAP_STRATEGY("imageElementTapStrategy");

其实是没有我们想要的enableMultiWindows这个参数。所以我们接着看setSetting 的底层方法

public interface HasSettings extends ExecutesMethod {
    default void setSetting(Setting setting, Object value) {
        CommandExecutionHelper.execute(this, MobileCommand.setSettingsCommand(setting, value));
    }

    default Map<String, Object> getSettings() {
        Map.Entry<String, Map<String, ?>> keyValuePair = MobileCommand.getSettingsCommand();
        Response response = this.execute((String)keyValuePair.getKey(), (Map)keyValuePair.getValue());
        return ImmutableMap.builder().putAll((Map)Map.class.cast(response.getValue())).build();
    }
}

传进来的setting是在这里使用的MobileCommand.setSettingsCommand(setting, value)
所接着看源码，看看能否自己构造一个，看下setSettingsCommand

    public static Map.Entry<String, Map<String, ?>> setSettingsCommand(Setting setting, Object value) {
        return new AbstractMap.SimpleEntry(SET_SETTINGS, prepareArguments((String)"settings", (Object)prepareArguments(setting.toString(), value)));
    }

可以看到(Object)prepareArguments(setting.toString(), value)其实就是把enum的setting给转成了string，所以我们完全可以自己传进去一个enableMultiWindows,并且把value也设置成true, 这样手动生成一个AbstractMap.SimpleEntry就行了。
所以修改完成的代码就是

CommandExecutionHelper.execute(driver,new AbstractMap.SimpleEntry<>("setSettings", prepareArguments((String)"settings", (Object)prepareArguments("enableMultiWindows", true))));

在测试代码中执行这一行，就能解决没有得到弹窗XML元素的问题。