添加noReset='true'后Appium无法启动应用，请求协助排查

问题描述 #

在Appium测试中，当在capabilities里添加noReset='true'配置时，应用无法启动导致测试失败；移除该配置后测试可正常运行。需求是在部分测试中保留应用缓存不被清除，但当前noReset配置无法正常生效。

环境信息 #

Appium: 2.5.3
Python: 3.12
Appium-Python-Client: 4.0.0

示例代码 #

import unittest
from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.common.appiumby import AppiumBy

capabilities = dict(
    platformName='Android',
    automationName='uiautomator2',
    deviceName='Android',
    appPackage='com.android.settings',
    appActivity='.Settings',
    language='en',
    locale='US',
    noReset='true' # 注释此行后应用可正常启动
)

appium_server_url = 'http://localhost:4723'

class TestAppium(unittest.TestCase):
    def setUp(self) -> None:
        self.driver = webdriver.Remote(appium_server_url, options=UiAutomator2Options().load_capabilities(capabilities))

    def tearDown(self) -> None:
        if self.driver:
            self.driver.quit()

    def test_find_battery(self) -> None:
        el = self.driver.find_element(by=AppiumBy.XPATH, value='//*[@text="Battery"]')
        el.click()

if __name__ == '__main__':
    unittest.main()

解决方案 #

1. 修正noReset参数类型 #

noReset的正确取值应为布尔类型True，而非字符串'true'。Appium对capabilities参数类型有严格校验，字符串类型的配置无法被正确解析，导致功能失效。修改后的capabilities如下：

capabilities = dict(
    platformName='Android',
    automationName='uiautomator2',
    deviceName='Android',
    appPackage='com.android.settings',
    appActivity='.Settings',
    language='en',
    locale='US',
    noReset=True # 使用布尔值而非字符串
)

2. 显式声明fullReset配置 #

若仅设置noReset=True仍有问题，可显式添加fullReset=False（默认值即为False，但显式声明可避免潜在的配置冲突）：

capabilities = dict(
    # 其他配置...
    noReset=True,
    fullReset=False
)

3. 检查应用状态与权限 #

当noReset=True时，Appium不会重新安装或清除应用数据。如果应用处于异常状态（如崩溃残留进程、必要权限未授予），会导致无法启动。可手动启动一次应用确认其能正常打开，同时检查并授予应用所需的特殊权限。

4. 验证UiAutomator2驱动状态 #

确保UiAutomator2驱动已正确安装，执行以下命令检查：

appium driver list --installed

若未安装，运行命令安装：

appium driver install uiautomator2

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