【Appium 系列】第03节-驱动初始化 — BaseDriver 的设计与实现

第03节-驱动初始化 — BaseDriver 的设计与实现对应代码配套代码base/base_driver.py说明本节代码示例与配套代码中的BaseDriver类一一对应。这节讲什么Appium 测试的第一步是获取 driver。但 driver 不是webdriver.Remote()一句话那么简单。Android 要配 UiAutomator2 引擎、APK 包名、Activity、权限授予。iOS 要配 XCUITest 引擎、Bundle ID、WDA 地址。配完一个 10-30 秒的启动时间跑不掉。100 个测试用例每个都初始化一次 driver 100 次初始化 半个小时耗在启动上。解决办法用 session 级 fixture 在整个测试会话里只初始化一次 driver所有用例复用。配套代码的base_driver.py封装了这套逻辑。这节把它拆开讲清楚。BaseDriver 的核心设计class BaseDriver: def __init__(self, platformandroid, appium_server_urlhttp://localhost:4723): self.platform platform.lower() self.appium_server_url appium_server_url self.driver None def get_driver(self): if self.driver: return self.driver # 已初始化过直接用 if self.platform span classwx-em-red android: self.driver self._init_android_driver() elif self.platform /span ios: self.driver self._init_ios_driver() else: raise ValueError(f不支持的平台: {self.platform}) return self.driver关键设计if self.driver: return self.driver这就是个简单的单例模式。第一次调用get_driver()时初始化 driver后面调用直接返回已有的实例。配合 pytest 的 session 级 fixture整个测试会话只初始化一次。Android 驱动初始化def _init_android_driver(self): android_version os.getenv(ANDROID_PLATFORM_VERSION, ) if not android_version: # 自动检测 Android 版本 import subprocess result subprocess.run( [adb, shell, getprop, ro.build.version.release], capture_outputTrue, textTrue, timeout5 ) if result.returncode span classwx-em-red 0: android_version result.stdout.strip() else: android_version 11.0 # 检测不到就用默认值 # 检查 Appium Settings 是否已安装 skip_install self._check_appium_settings_installed() capabilities { platformName: Android, platformVersion: android_version, deviceName: os.getenv(ANDROID_DEVICE_NAME, Android Emulator), automationName: UiAutomator2, noReset: True, # 不重置应用数据 fullReset: False, # 不完全重置 autoGrantPermissions: True, # 自动授权 newCommandTimeout: 300, skipServerInstallation: skip_install, uiautomator2ServerInstallTimeout: 60000, uiautomator2ServerLaunchTimeout: 60000, } # 包名和 Activity app_package os.getenv(APP_PACKAGE, ) app_activity os.getenv(APP_ACTIVITY, ) if app_package: capabilities[appPackage] app_package if app_activity: capabilities[appActivity] app_activity options UiAutomator2Options().load_capabilities(capabilities) driver webdriver.Remote(self.appium_server_url, optionsoptions) return driver参数说明参数作用为什么这么设noResetTrue不重置应用数据避免每次测试都重新登录autoGrantPermissionsTrue自动授权弹窗不授权的话测试会被弹窗卡住skipServerInstallation跳过 UiAutomator2 安装装过了就别再装了省时间uiautomator2ServerInstallTimeout60000安装超时 60 秒默认 20 秒不够慢的设备会超时iOS 驱动初始化Tidevice 模式def _init_ios_driver_with_tidevice(self): bundle_id os.getenv(BUNDLE_ID, ) udid os.getenv(IOS_UDID, ) tidevice_port int(os.getenv(TIDEVICE_PORT, 8100)) wda_url fhttp://127.0.0.1:{tidevice_port} capabilities { platformName: iOS, platformVersion: os.getenv(IOS_PLATFORM_VERSION, 15.0), deviceName: os.getenv(IOS_DEVICE_NAME, iPhone 13), automationName: XCUITest, noReset: True, fullReset: False, newCommandTimeout: 300, webDriverAgentUrl: wda_url, # 关键连 Tidevice 代理 useNewWDA: False, # 不要重新装 WDA shouldUseSingletonTestManager: False, skipServerInstallation: True, } if udid: capabilities[udid] udid if bundle_id: capabilities[bundleId] bundle_id options XCUITestOptions().load_capabilities(capabilities) driver webdriver.Remote(self.appium_server_url, optionsoptions) return driver关键点webDriverAgentUrl指向 Tidevice 的 wdaproxy 地址。这样 Appium Server 就不需要自己管理 WDA 了直接用 Tidevice 提供好的代理。省掉了 Xcode 编译 WDA 的麻烦。Appium Settings 安装检测def _check_appium_settings_installed(self) - bool: 检查设备上是否已安装 Appium Settings已装则跳过安装 result subprocess.run( [adb, shell, pm, list, packages, io.appium.settings], capture_outputTrue, textTrue, timeout5 ) if result.returncode /span 0 and io.appium.settings in result.stdout: return True return False这个小优化能省 10-20 秒。每次初始化都重新装一遍 Appium Settings 太浪费时间了装过就不装了。和 conftest.py 配合配套代码的conftest.py里这样用pytest.fixture(scopesession) def driver_setup(request): 会话级 fixture整个测试只初始化一次 driver platform os.getenv(PLATFORM, android) base_driver BaseDriver(platformplatform) driver base_driver.get_driver() def driver_teardown(): try: driver.quit() except Exception as e: logger.error(f驱动关闭异常: {str(e)}) request.addfinalizer(driver_teardown) yield driverscopesession是关键。不加的话默认是 function 级别每个测试函数重新初始化一次 driver100 个测试就是 100 次初始化的时间。踩过的坑1. 每次初始化都重新装 UiAutomator2第一次跑测试花了 30 秒初始化以为正常。跑了 10 个用例后才发现每次都在重新装 Server。加skipServerInstallation检测后每次省 15 秒。2. Android 版本号写死一开始platformVersion写死了11.0。换了个 Android 14 的设备跑Capabilities 里的版本跟实际不匹配部分操作异常。改成自动检测后解决。3. iOS 用 Tidevice 时忘了先启动 wdaproxy症状driver 初始化超时。 原因webDriverAgentUrl配置了但tidevice wdaproxy没跑。跟 Appium Server 没启动是一个道理。4.noResetFalse导致每次重新登录默认noResetTrue但有人为了干净环境改成False。结果每次测试前都要重新装 App、重新登录一个用例跑 2 分钟。还是noResetTrue快。