Fenix（Firefox for Android）本地化截图测试（l10n Screenshots Tests）实战指南

移动开发【免费下载链接】fenix⚠️ Fenix (Firefox for Android) moved to a new repository. It is now developed and maintained as part of: https://github.com/mozilla-mobile/firefox-android项目地址https://gitcode.com/gh_mirrors/fe/fenix点击查看免费下载导读本文围绕 FenixFirefox for Android仓库中的 docs/l10nScreenshotsTests.md 展开系统讲解如何借助screengrab fastlane 为多语言本地化l10n自动采集 UI 截图。你将掌握从 Android Studio 手工跑测试、命令行批量截图、解读 Screengrabfile 配置到 CITaskcluster Firebase Test Lab上调度执行的全链路实战方案并理解仓库中截图测试的底层实现机制。一、为什么需要 l10n 截图测试Firefox for Android 支持数十种语言见仓库app/src/main/res/values-*中大量本地化资源目录每一种语言的界面排版、文字长度、方向RTL都可能不同。本地化团队需要各语言下的真实 UI 截图来审核翻译是否合适、布局是否被撑破。因此仓库引入了l10n 截图测试用 UI 测试驱动真实界面配合screengrab工具按指定 locale 逐语言截图。从文档可知其核心技术栈是screengrabfastlane 生态中负责在 Android 测试运行时捕获截图的工具测试代码通过Screengrab.screenshot(name)主动触发截图UI 测试这些截图全部由 UI 测试产生测试代码位于app/src/androidTest/java/org/mozilla/fenix/screenshots目录注意仓库当前将测试目录放在org.mozilla.fenix.screenshots包下即app/src/androidTest/java/org/mozilla/fenix/screenshots/。该机制的意义在于截图不再依赖人工在每台设备上手工操作而是由可重复、可追溯的自动化测试驱动为 l10n 团队提供稳定的多语言截图资产。二、截图测试的代码组织与实现原理2.1 截图测试包结构仓库中的截图测试集中在app/src/androidTest/java/org/mozilla/fenix/screenshots/ScreenshotTest.java所有截图测试的基类封装了截图引擎初始化、失败自动截图等公共逻辑DefaultHomeScreenTest.kt首页与隐私浏览模式截图MenuScreenShotTest.kt三点菜单、设置各子菜单、历史、书签、标签页抽屉等大量 UI 截图。Screengrabfile中use_tests_in_packages([org.mozilla.fenix.screenshots])与 Flank 配置中的test-targets: package org.mozilla.fenix.screenshots都指向这个包确保只有截图测试被筛选执行。2.2 基类ScreenshotTest.java做了什么基类 ScreenshotTest.java 是理解整套机制的关键授权通过GrantPermissionRule.grant(WRITE_EXTERNAL_STORAGE)预先授予存储写权限保证截图能写入设备截图策略在setUpScreenshots()中调用Screengrab.setDefaultScreenshotStrategy(new UiAutomatorScreenshotStrategy())选择基于UiDevice的截图策略注释中提示可替换为HostScreencap策略失败自动截图注册一个TestWatcher当测试失败时调用Screengrab.screenshot(FAILURE-类名-方法名)便于排查 UI 测试失败原因工具方法takeScreenshotsAfterWait(filename, waitingTime)先等待指定毫秒再截图让界面动画稳定。2.3 具体测试如何截图以 MenuScreenShotTest.kt 为例每个测试类都带Rule val localeTestRule LocaleTestRule()screengrab 提供的规则负责切换 locale 并重置测试流程用仓库自研的 robot 模式驱动界面如homeScreen { }.openThreeDotMenu { }、openSettings { }关键截图点直接调用Screengrab.screenshot(SettingsRobot_settings-menu)截图文件名语义化命名便于后续在fastlane/metadata/android中按语言归档。DefaultHomeScreenTest.kt则演示了默认主页、隐私浏览模式的截图包含通过mDevice.pressBack()退出引导、togglePrivateBrowsingModeOnOff()切换隐私模式等真实交互。三、Screengrabfile 配置详解fastlane/Screengrabfile是本地截图的核心配置文档明确指出“包配置、APK 路径以及 locales 均在此文件中设置若有变更必须同步修改”。逐项解读如下app_package_name(org.mozilla.fenix.debug) # 被测应用的包名debug 变体 use_tests_in_packages([org.mozilla.fenix.screenshots]) # 只运行截图测试包 app_apk_path(app/build/outputs/apk/geckoBeta/debug/app-geckoBeta-x86-debug.apk) # 应用 APK tests_apk_path(app/build/outputs/apk/androidTest/geckoBeta/debug/app-geckoBeta-debug-androidTest.apk) # 测试 APK test_instrumentation_runner androidx.test.runner.AndroidJUnitRunner # 测试运行器 locales([en-US, fr-FR, it-IT, de-DE, ja, ru, zh-CN, zh-TW, ko]) # 目标语言列表 clear_previous_screenshots(true) # 每次先清空旧截图避免残留干扰 exit_on_test_failure false # 单个测试失败不中断整轮 skip_open_summary false # 结束后展示汇总 reinstall_app true # 每次重新安装应用要点说明locales 数组当前配置了 9 种语言en-US / fr-FR / it-IT / de-DE / ja / ru / zh-CN / zh-TW / ko。screengrab 会为每个 locale 启动一轮测试并切换系统语言这正是“l10n 截图”的关键APK 路径指向geckoBeta变体在 x86 模拟器上的产物Screengrabfile末尾注释提示更多可用选项可通过fastlane screengrab --help查看该文件同时配套 fastlane/Appfile其中声明了package_name(org.mozilla.fenix)与json_key_file等 supply 上传配置。四、本地运行Android Studio 与命令行两条路径4.1 方式一Android Studio 直接运行导航到app/src/androidTest/java/org/mozilla/fenix/screenshots仓库当前实际路径点击测试方法左侧的按钮即可运行单个测试或整个测试套件。此方式适合快速验证“测试本身是否通过”但由于没有 fastlane/screengrab 的驱动与归档逻辑截图不会被保存。4.2 方式二命令行 fastlane screengrab按文档步骤执行安装 gemsudo gem install screengrab启动模拟器运行命令前必须有一个已启动的模拟器emulatorscreengrab 会在它上面安装 APK 并驱动测试。执行截图命令fastlane screengrab --test_instrumentation_runner androidx.test.runner.AndroidJUnitRunner--test_instrumentation_runner指定 instrumentation 运行器与Screengrabfile中的配置保持一致。查看产物构建与测试完成后截图会输出到仓库根目录的fastlane/metadata/android下并按 locale 分子目录存放。若因失败未生成目录可能需要先手工创建这些文件夹再重跑。五、CI 上的调度与结果查看5.1 定时任务文档记录当前 CI 上有一个每周一运行的 cron 任务执行这些截图测试。在仓库中该任务的落点在 taskcluster/ci/ui-test/kind.yml 的screenshots-arm任务screenshots-arm: attributes: screenshots: true description: Run UI screenshots tests to keep them up to date run-on-tasks-for: [] run-on-git-branches: [main] run: commands: - [automation/taskcluster/androidTest/ui-test.sh, arm-screenshots-tests, app.apk, android-test.apk, 1] treeherder: symbol: debug(screenshots-arm)注意run-on-tasks-for: []run-on-git-branches: [main]说明它不随 PR 触发仅由周期调度cron在 main 分支运行——这与文档描述的“每周 cron 调度”一致。测试结果可在 Treeherder 上按任务查看。5.2 底层执行链路screenshots-arm任务调用 automation/taskcluster/androidTest/ui-test.sh脚本逻辑为配置 gcloud 服务账号GOOGLE_PROJECT对应moz-fenix凭据来自 Taskcluster secretproject/mobile/fenix/firebase根据设备类型选择 Flank 配置模板截图任务使用flank-arm-screenshots-tests.yml通过 Test Armada 的Flank工具flank.jar在 Firebase Test Lab 上执行测试--max-test-shards由参数传入截图任务为1即单分片单设备无论成败都会拉取flank.log与测试结果并用 parse-ui-test.py 生成 Markdown 汇总供 PR/任务展示最终以测试实际退出码结束便于失败告警kind.yml 中还配置了失败时 Slack 通知。5.3 截图专用的 Flank 配置automation/taskcluster/androidTest/flank-arm-screenshots-tests.yml是截图测试专用的 Flank 配置与普通 UI 测试的区别在于gcloud: results-bucket: fenix_test_artifacts # 结果与产物桶 record-video: true # 录制测试视频 timeout: 15m num-flaky-test-attempts: 1 # 允许 1 次重试抖动用例 use-orchestrator: true directories-to-pull: - /sdcard/screenshots # 关键从设备拉取截图目录 test-targets: - package org.mozilla.fenix.screenshots # 只跑截图包 device: - model: Pixel2.arm # Pixel 2 ARM 虚拟设备 version: 30 locale: en_US flank: max-test-shards: 1 num-test-runs: 1其中directories-to-pull: /sdcard/screenshots正是 screengrab 在设备端写入截图的默认位置Flank 在测试结束后将其拉回作为测试工件artifacts上传供后续在public工件目录查看。六、当前状态与后续演进TBD文档明确指出一个重要的现实边界目前 CI 上这些测试“能跑通、结果被检查”但截图本身并未在 CI 上保存/公开。也就是说现阶段 CI 的价值是持续验证截图测试脚本与用例的可用性防止代码变更导致截图测试失效真正的多语言截图产物仍以本地执行为主。文档将该能力列为 TBD留待 l10n 团队或其他团队提出需求后再落地。文档还给出了可参考的演进方向iOS 端firefox-ios的截图工作流采用 Taskcluster 作为任务编排、Bitrise 执行截图测试、再经 Taskcluster 存储并公开分享截图的方案可作为未来在 Android/Fenix 侧实现“CI 产出并公开 l10n 截图”的参照。七、快速上手清单环节关键操作配置文件/目录定位用例查看截图测试源码screenshots 测试包本地截图fastlane screengrab --test_instrumentation_runner androidx.test.runner.AndroidJUnitRunner需先启动模拟器fastlane/Screengrabfile调整语言增删locales([...])数组fastlane/Screengrabfile截图输出fastlane/metadata/android/locale/...仓库根目录CI 调度每周一 cron 触发screenshots-armtaskcluster/ci/ui-test/kind.ymlCI 执行Flank Firebase Test Lab拉取/sdcard/screenshotsui-test.sh、flank-arm-screenshots-tests.yml遵循上述流程你可以在本地为 9 种语言批量产出真实 UI 截图也能在 CI 侧持续守护这批截图测试的健康度并在未来按需扩展为公开的 l10n 截图资产。赞分享移动开发【免费下载链接】fenix⚠️ Fenix (Firefox for Android) moved to a new repository. It is now developed and maintained as part of: https://github.com/mozilla-mobile/firefox-android项目地址https://gitcode.com/gh_mirrors/fe/fenix点击查看免费下载相关推荐从理论到实践使用gh_mirrors/tra/training构建你的第一个深度学习模型从理论到实践使用gh_mirrors/tra/training构建你的第一个深度学习模型 gh_mirrors/tra/training是MLPerf™训练基Fenix 同步集成测试Sync Integration Tests实战指南验证 Firefox for Android 与桌面端的数据同步Fenix 同步集成测试Sync Integration Tests实战指南验证 Firefox for Android 与桌面端的数据同步 导读 本文基移动开发如何用Python大麦抢票神器实现95%成功率的演唱会门票自动化抢购如何用Python大麦抢票神器实现95%成功率的演唱会门票自动化抢购 还在为热门演唱会门票秒光而烦恼吗每次开票都像打仗一样紧张结果还是抢不到心仪的座位传统GUI 自动化RPA上一篇Mockoon实战指南告别API依赖轻松搭建本地模拟环境下一篇终极跨平台漫画阅读器Tachidesk Sorayomi 完整使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考