在移动互联网时代移动端 Web 应用的质量直接影响用户体验。传统的移动端自动化工具如 Appium 虽然功能强大但配置复杂、执行速度慢且学习曲线陡峭。微软推出的 Playwright 框架凭借其现代的 API 设计、出色的稳定性和卓越的性能迅速成为 Web 自动化测试的首选工具。本文将深入探讨 Playwright 在 Android 平台上的应用从环境搭建到实战案例全面展示如何利用 Playwright 实现高效的移动端浏览器自动化。一、Playwright for Android 概述Playwright 是微软开发的开源 Web 自动化测试框架支持 Chromium、Firefox 和 WebKit 三大浏览器引擎提供统一的 API 接口。自 2020 年发布以来Playwright 不断拓展其能力边界引入了对 Android 平台的实验性支持能够直接控制 Android 设备上的 Chrome 浏览器和 WebView 组件Playwright。1.1 核心优势统一 API 体验与桌面端 Web 自动化使用完全相同的 API无需学习新的语法直接浏览器控制通过 CDP 协议直接与浏览器通信执行速度远超 Appium内置等待机制自动等待元素就绪大幅减少不稳定测试flaky tests丰富的调试工具支持截图、视频录制、追踪功能问题定位更便捷多语言支持支持 JavaScript/TypeScript、Python、Java 和.NET无需额外服务器不依赖 Appium Server直接通过 ADB 与设备通信1.2 适用场景移动 Web 应用的功能测试和回归测试混合应用Hybrid App中的 WebView 部分测试响应式 Web 设计在真实 Android 设备上的验证PWA渐进式 Web 应用的自动化测试跨平台 Web 应用的一致性测试二、环境搭建2.1 开发环境准备首先需要安装以下基础工具Node.js推荐 LTS 版本v18可从nodejs.org下载ADBAndroid Debug Bridge连接 Android 设备的核心工具ADB 安装方式推荐方式安装 Android Studio自动配置 SDK 和 ADB轻量方式单独安装平台工具macOSbrew install android-platform-toolsWindows下载ADB 压缩包并配置环境变量Linuxsudo apt-get install android-sdk-platform-tools配置环境变量设置ANDROID_HOME指向 SDK 安装目录将$ANDROID_HOME/platform-tools添加到系统PATH中验证安装bash运行adb version adb devices2.2 Android 设备配置开启开发者选项进入「设置」→「关于手机」连续点击「版本号」7 次直到提示 开发者模式已启用配置开发者选项进入「设置」→「开发者选项」开启「USB 调试」开启「USB 安装」部分设备需要开启「保持唤醒状态」可选防止设备休眠开启「USB 调试安全设置」部分小米设备需要Chrome 浏览器配置确保设备上安装了 Chrome 87 或更高版本打开 Chrome 浏览器访问chrome://flags搜索并启用 Enable command line on non-rooted devicesPlaywright重启 Chrome 浏览器使设置生效2.3 Playwright 安装创建新项目并安装 Playwrightbash运行# 创建项目目录 mkdir playwright-android-demo cd playwright-android-demo # 初始化Node.js项目 npm init -y # 安装Playwright npm install playwright验证安装创建一个简单的测试脚本test-connection.jsjavascript运行const { _android: android } require(playwright); (async () { try { // 列出所有已连接的Android设备 const devices await android.devices(); console.log(发现 ${devices.length} 台已连接的Android设备); if (devices.length 0) { console.log(未检测到任何设备请检查USB连接和开发者选项设置); return; } // 连接第一台设备 const device devices[0]; console.log(设备型号: ${device.model()}); console.log(设备序列号: ${device.serial()}); console.log(Android版本: ${device.sdkVersion()}); // 关闭连接 await device.close(); console.log(设备连接测试成功); } catch (error) { console.error(连接失败:, error.message); } })();运行脚本bash运行node test-connection.js如果一切配置正确你将看到设备信息输出。三、核心概念与 API3.1 设备连接与管理Playwright 通过_android对象提供 Android 设备的访问能力javascript运行const { _android: android } require(playwright); // 获取所有已连接设备 const devices await android.devices(); // 连接指定设备通过序列号 const device await android.connect({ deviceSerialNumber: your-device-serial, adbPort: 5037 // 默认ADB端口 }); // 设备基本信息 console.log(型号:, device.model()); console.log(序列号:, device.serial()); console.log(SDK版本:, device.sdkVersion()); // 关闭设备连接 await device.close();3.2 浏览器启动与上下文Playwright 可以直接在 Android 设备上启动 Chrome 浏览器并创建浏览器上下文javascript运行// 强制停止已运行的Chrome避免冲突 await device.shell(am force-stop com.android.chrome); // 启动Chrome浏览器并创建上下文 const context await device.launchBrowser({ args: [--disable-popup-blocking, --no-first-run], viewport: { width: 390, height: 844 }, // Pixel 8尺寸 locale: zh-CN, timezoneId: Asia/Shanghai }); // 创建新页面 const page await context.newPage(); // 与桌面端完全相同的API await page.goto(https://m.baidu.com); await page.fill(input[nameword], Playwright Android); await page.click(input[typesubmit]); await page.waitForNavigation(); // 截图 await page.screenshot({ path: baidu-search.png, fullPage: true }); // 关闭上下文 await context.close();3.3 WebView 自动化Playwright 最强大的功能之一是能够自动化原生应用中的 WebView 组件javascript运行// 启动包含WebView的应用 await device.shell(am start -n org.chromium.webview_shell/.WebViewShellActivity); // 等待WebView出现 const webview await device.webView({ pkg: org.chromium.webview_shell }); // 获取WebView中的页面对象 const page await webview.page(); // 现在可以使用所有Playwright Web API await page.goto(https://github.com/microsoft/playwright); console.log(页面标题:, await page.title()); // 与WebView中的元素交互 await page.click(a[href/microsoft/playwright/issues]); await page.waitForNavigation(); // 截图WebView内容 await page.screenshot({ path: webview-github.png });3.4 设备级操作除了浏览器控制Playwright 还提供了设备级别的操作能力javascript运行// 执行Shell命令 const output await device.shell(ls /sdcard/); console.log(SD卡内容:, output); // 设备截图整个屏幕 await device.screenshot({ path: device-fullscreen.png }); // 模拟按键事件 await device.press(BACK); // 返回键 await device.press(HOME); // 主页键 await device.press(MENU); // 菜单键 await device.press(VOLUME_UP); // 音量加 // 模拟触摸和滑动 await device.tap({ x: 100, y: 200 }); // 点击坐标 await device.swipe({ startX: 200, startY: 500, endX: 200, endY: 200, duration: 500 }); // 向上滑动 // 文件传输 // 推送文件到设备 await device.push(Buffer.from(Hello Playwright!), /sdcard/test.txt); // 从设备拉取文件 const fileContent await device.pull(/sdcard/test.txt); console.log(文件内容:, fileContent.toString());四、实战案例4.1 案例一移动 Web 应用登录流程测试让我们编写一个完整的测试脚本模拟用户在移动 Web 应用上的登录流程javascript运行const { _android: android } require(playwright); async function testMobileLogin() { // 连接设备 const [device] await android.devices(); console.log(连接到设备: ${device.model()}); try { // 启动Chrome浏览器 await device.shell(am force-stop com.android.chrome); const context await device.launchBrowser(); const page await context.newPage(); // 访问登录页面 console.log(访问登录页面...); await page.goto(https://example.com/mobile/login); // 等待页面加载完成 await page.waitForLoadState(networkidle); // 输入用户名和密码 console.log(输入登录信息...); await page.fill(input[nameusername], testuser); await page.fill(input[namepassword], testpassword123); // 点击登录按钮 console.log(点击登录按钮...); await Promise.all([ page.waitForNavigation({ waitUntil: networkidle }), page.click(button[typesubmit]) ]); // 验证登录成功 const welcomeText await page.locator(.welcome-message).textContent(); if (welcomeText.includes(欢迎回来testuser)) { console.log(✅ 登录测试通过); } else { console.log(❌ 登录测试失败); } // 截图保存结果 await page.screenshot({ path: login-success.png }); // 测试登出功能 console.log(测试登出功能...); await page.click(.user-menu); await page.click(text退出登录); await page.waitForNavigation(); // 验证已登出 const loginButton await page.locator(button[typesubmit]).isVisible(); if (loginButton) { console.log(✅ 登出测试通过); } else { console.log(❌ 登出测试失败); } await context.close(); console.log(所有测试完成); } catch (error) { console.error(测试过程中发生错误:, error); // 错误时截图 await device.screenshot({ path: test-error.png }); } finally { await device.close(); } } testMobileLogin();4.2 案例二混合应用 WebView 自动化测试这个案例展示如何测试一个包含 WebView 的原生 Android 应用javascript运行const { _android: android } require(playwright); async function testHybridAppWebView() { const [device] await android.devices(); console.log(连接到设备: ${device.model()}); try { // 启动混合应用 console.log(启动混合应用...); await device.shell(am force-stop com.example.hybridapp); await device.shell(am start -n com.example.hybridapp/.MainActivity); // 等待应用启动并出现WebView console.log(等待WebView加载...); const webview await device.webView({ pkg: com.example.hybridapp, timeout: 10000 }); const page await webview.page(); console.log(WebView连接成功); // 等待WebView内容加载 await page.waitForLoadState(domcontentloaded); // 与WebView中的内容交互 console.log(测试WebView中的表单提交...); await page.fill(#name, 张三); await page.fill(#email, zhangsanexample.com); await page.selectOption(#city, { label: 北京 }); await page.check(#agree-terms); // 提交表单 await Promise.all([ page.waitForNavigation(), page.click(#submit-button) ]); // 验证提交结果 const successMessage await page.locator(.success-message).textContent(); console.log(提交结果:, successMessage); // 测试WebView与原生应用的交互 console.log(测试WebView与原生交互...); await page.click(#open-native-dialog); // 使用设备级API点击原生弹窗的确定按钮 await device.locator(text确定).click({ timeout: 5000 }); // 验证WebView收到了原生应用的回调 const callbackResult await page.locator(#callback-result).textContent(); console.log(原生回调结果:, callbackResult); console.log(✅ 混合应用WebView测试通过); } catch (error) { console.error(测试失败:, error); await device.screenshot({ path: hybrid-app-error.png }); } finally { await device.close(); } } testHybridAppWebView();4.3 案例三设备级操作与多场景测试这个案例展示了如何结合设备级操作进行更复杂的测试javascript运行const { _android: android } require(playwright); async function testDeviceLevelOperations() { const [device] await android.devices(); console.log(连接到设备: ${device.model()}); try { // 测试1切换网络状态 console.log(\n测试1切换网络状态); await device.shell(svc wifi disable); await page.waitForTimeout(2000); await device.shell(svc wifi enable); await page.waitForTimeout(2000); console.log(✅ 网络切换测试通过); // 测试2模拟不同屏幕方向 console.log(\n测试2屏幕方向测试); await device.shell(settings put system user_rotation 1); // 横屏 await page.waitForTimeout(1000); await device.screenshot({ path: landscape.png }); await device.shell(settings put system user_rotation 0); // 竖屏 await page.waitForTimeout(1000); await device.screenshot({ path: portrait.png }); console.log(✅ 屏幕方向测试通过); // 测试3多页面切换 console.log(\n测试3多页面切换测试); const context await device.launchBrowser(); const page1 await context.newPage(); await page1.goto(https://www.baidu.com); console.log(页面1标题:, await page1.title()); const page2 await context.newPage(); await page2.goto(https://www.github.com); console.log(页面2标题:, await page2.title()); // 切换回第一个页面 await page1.bringToFront(); await page1.fill(input[namewd], Playwright Android); await page1.press(Enter); await page1.waitForNavigation(); console.log(✅ 多页面切换测试通过); // 测试4文件下载测试 console.log(\n测试4文件下载测试); const downloadPromise page1.waitForEvent(download); await page1.click(a[href$.pdf]); // 点击PDF下载链接 const download await downloadPromise; console.log(下载文件名:, download.suggestedFilename()); await download.saveAs(./downloads/${download.suggestedFilename()}); console.log(✅ 文件下载测试通过); await context.close(); console.log(\n所有设备级操作测试完成); } catch (error) { console.error(测试失败:, error); } finally { await device.close(); } } testDeviceLevelOperations();五、高级用法5.1 多设备并行测试Playwright 支持同时连接多台 Android 设备进行并行测试javascript运行const { _android: android } require(playwright); async function runTestOnDevice(deviceSerial, testName) { const device await android.connect({ deviceSerialNumber: deviceSerial }); console.log(在设备 ${device.model()} (${deviceSerial}) 上运行测试: ${testName}); try { const context await device.launchBrowser(); const page await context.newPage(); await page.goto(https://example.com); await page.screenshot({ path: ${testName}-${deviceSerial}.png }); await context.close(); console.log(✅ 设备 ${deviceSerial} 测试完成); } catch (error) { console.error(❌ 设备 ${deviceSerial} 测试失败:, error); } finally { await device.close(); } } async function parallelTest() { const devices await android.devices(); console.log(发现 ${devices.length} 台设备开始并行测试...); const testPromises devices.map((device, index) runTestOnDevice(device.serial(), test-${index 1}) ); await Promise.all(testPromises); console.log(所有并行测试完成); } parallelTest();5.2 云设备集成Playwright 可以与云测试平台如 LambdaTest、BrowserStack集成在远程真实设备上运行测试javascript运行const { _android: android } require(playwright); async function testOnLambdaTest() { const capabilities { LT:Options: { platformName: android, deviceName: Pixel 8, platformVersion: 14, isRealMobile: true, build: Playwright Android Build, name: 移动Web测试, user: process.env.LT_USERNAME, accessKey: process.env.LT_ACCESS_KEY, network: true, video: true, console: true } }; const device await android.connect( wss://cdp.lambdatest.com/playwright?capabilities${encodeURIComponent(JSON.stringify(capabilities))} ); console.log(连接到LambdaTest云设备成功); try { const context await device.launchBrowser(); const page await context.newPage(); await page.goto(https://m.baidu.com); await page.fill(input[nameword], 云测试); await page.click(input[typesubmit]); await page.waitForNavigation(); console.log(页面标题:, await page.title()); await page.screenshot({ path: lambda-test-result.png }); await context.close(); console.log(✅ 云设备测试通过); } catch (error) { console.error(云设备测试失败:, error); } finally { await device.close(); } } testOnLambdaTest();5.3 CI/CD 集成将 Playwright Android 测试集成到 CI/CD 流水线中GitHub Actions 配置示例.github/workflows/android-test.ymlyamlname: Android Playwright Tests on: push: branches: [ main ] pull_request: branches: [ main ] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Setup Node.js uses: actions/setup-nodev4 with: node-version: 20 cache: npm - name: Install dependencies run: npm ci - name: Setup Android SDK uses: android-actions/setup-androidv3 with: api-level: 34 build-tools: 34.0.0 - name: Create AVD run: | sdkmanager system-images;android-34;google_apis;x86_64 echo no | avdmanager create avd -n test-avd -k system-images;android-34;google_apis;x86_64 --device pixel_8 - name: Start emulator run: | emulator -avd test-avd -no-window -no-audio -no-boot-anim adb wait-for-device adb shell settings put global window_animation_scale 0 adb shell settings put global transition_animation_scale 0 adb shell settings put global animator_duration_scale 0 - name: Install Chrome run: | wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb adb install google-chrome-stable_current_amd64.deb - name: Run Playwright tests run: npm test - name: Upload test results if: always() uses: actions/upload-artifactv4 with: name: test-results path: | screenshots/ videos/ test-results/六、Playwright Android vs Appium 对比表格特性Playwright AndroidAppium主要用途移动 Web、WebView、PWA 测试原生应用、混合应用、移动 Web 测试架构直接通过 ADB 和 CDP 与浏览器通信客户端 - 服务器架构依赖 Appium Server执行速度非常快直接控制浏览器较慢需要通过多个中间层配置复杂度简单仅需 ADB复杂需要 Appium Server、驱动、SDKAPI 设计现代、简洁、统一基于 WebDriver 协议相对繁琐原生应用支持有限仅 WebView 部分完整支持调试能力强大内置追踪、视频、截图有限需要额外工具学习曲线平缓与桌面 Web 相同 API陡峭跨平台支持目前仅支持 Android支持 Android 和 iOS社区生态快速增长成熟庞大选择建议如果主要测试移动 Web 应用或混合应用的 WebView 部分优先选择 Playwright如果需要测试纯原生应用或iOS 应用Appium 仍然是更好的选择可以结合使用用 Playwright 测试 Web 部分用 Appium 测试原生部分七、常见问题与解决方案7.1 设备连接问题问题adb devices能看到设备但 Playwright 无法连接解决方案确保设备已接受 USB 调试授权重启 ADB 服务adb kill-server adb start-server检查 Chrome 版本是否为 87确保在chrome://flags中启用了 Enable command line on non-rooted devices尝试使用不同的 USB 线和 USB 端口7.2 WebView 无法找到问题device.webView()超时无法找到 WebView解决方案确保应用已正确启动检查包名是否正确adb shell dumpsys window | grep mCurrentFocus增加超时时间device.webView({ timeout: 20000 })确保 WebView 已启用调试模式在应用代码中添加WebView.setWebContentsDebuggingEnabled(true)7.3 权限弹窗处理问题应用请求权限时测试脚本卡住解决方案javascript运行// 处理位置权限弹窗 try { await device.locator(text允许).click({ timeout: 3000 }); } catch (e) { console.log(未检测到位置权限弹窗); } // 或者使用更通用的方法 async function handlePermissionPopup(device) { const permissionButtons [允许, 始终允许, 仅在使用中允许]; for (const buttonText of permissionButtons) { try { await device.locator(text${buttonText}).click({ timeout: 1000 }); return true; } catch (e) { continue; } } return false; }7.4 性能优化技巧强制停止 Chrome每次测试前使用am force-stop com.android.chrome确保干净的环境禁用动画在开发者选项中禁用窗口动画、过渡动画和动画时长缩放使用无头模式虽然 Android 不支持真正的无头模式但可以使用--headlessnew参数合理设置超时根据设备性能调整超时时间避免不必要的等待并行测试利用多设备并行执行提高测试效率八、最佳实践保持测试独立性每个测试应该独立运行不依赖其他测试的结果使用页面对象模式将页面元素和操作封装成页面对象提高代码可维护性合理使用等待优先使用 Playwright 的自动等待机制避免使用waitForTimeout完善的错误处理在测试失败时自动截图、录制视频便于问题定位参数化测试使用不同的测试数据覆盖更多场景定期清理设备测试完成后清理应用数据和缓存避免影响后续测试结合设备模拟在开发阶段使用 Playwright 的设备模拟功能快速验证在 CI 阶段使用真实设备版本控制锁定 Playwright 和 Chrome 的版本避免因版本更新导致测试失败九、总结与展望Playwright for Android 为移动端浏览器自动化带来了全新的体验。它继承了 Playwright 在桌面端的所有优势提供了统一的 API、出色的性能和强大的调试能力。虽然目前仍处于实验阶段且主要专注于 Web 和 WebView 测试但它已经能够满足大多数移动 Web 应用的自动化需求。随着微软的持续投入和社区的不断发展我们可以期待 Playwright 在移动端的能力会进一步增强。未来可能会看到对 iOS 平台的支持更完善的原生应用自动化能力更好的性能和稳定性与更多云测试平台的集成对于开发和测试团队来说现在是开始探索和采用 Playwright for Android 的好时机。它不仅能够提高测试效率还能让团队从繁琐的配置和维护工作中解放出来专注于编写高质量的测试用例。