Appium 的 enableMultiWindows 参数

引言

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

遇到的问题

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

解决方案

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

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

2. 但是我们使用的时测试平台，没有底层的初始话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元素的问题。