6步给 react-native-vision-camera 相机库搭一张完整的自动化测试安全网【免费下载链接】react-native-vision-camera A powerful, high-performance React Native Camera library.项目地址: https://gitcode.com/GitHub_Trending/re/react-native-vision-camera上线当晚,相机黑屏,直到用户投诉才发现。要是 react-native-vision-camera 自动化测试的安全网提前织好,这次事故会在 PR 阶段就被拦下。本文按开发者的实操路径,带你在这套 monorepo 里从零跑通:第一个测试、真机套件、CI 流水线。 先把测试金字塔的占比想清楚再动手别急着装依赖,先想明白比例。测试金字塔像盖楼:底层是单元级的纯函数测试,快、便宜,占比约七成;中层是组件测试,守住单个组件的生命周期,两成左右;顶层是 E2E,最贵,一成就够,只走用户真实会走的那几条路。纯函数测试是代码库的烟雾报警器,便宜,跑得勤,一点烟就报警。反过来倒金字塔——E2E 当主力——CI 又慢又抖,跑着跑着你就不会再信这条流水线了。 三步命令,把测试工具箱配齐这个仓库的工具链其实不复杂。react-native-harness 是一个 Jest 兼容的 runner,把套件直接跑在真机或模拟器上,你写过 Jest 组件测试,手感直接复用;bun test 守纯逻辑;Playwright 给文档站做截图 E2E。设备端场景很多团队会找 Detox 端到端测试,这里则用 harness runner 在真机上跑真实套件,思路一致。仓库用 bun 做包管理,配齐环境就三条命令:git clone https://gitcode.com/GitHub_Trending/re/react-native-vision-camera cd react-native-vision-camera bun install cd apps/simple-camera bun run build:android第三条命令产出 debug APK,后面所有设备端测试都装在它上面跑。这套做法也不只服务这个仓库,任何 React Native 相机测试都能照搬这个骨架。✍️ 写下第一个测试:验证纯函数 getUIRotation第一个测试挑最小的纯函数下手:getUIRotation,算当前界面方向下 UI 该转多少度。它的测试在 visioncamera.utils.harness.ts,核心断言就这么几行:it(calculates UI rotation, () { expect(getUIRotation(up, right)).toBe(90) expect(getUIRotation(up, down)).toBe(180) expect(getUIRotation(up, left)).toBe(-90) })连一台安卓设备(模拟器也行),运行bun run test:harness:android -- --testPathPatternsutils。跑起来看到什么算通过?终端打出 PASS 加一个绿勾,计数是 1 passed。失败时也没得猜:报告里 received 和 expected 摆得明明白白。相机组件测试的四个关键点习惯用 React Native Testing Library 写组件测试的话,思路是通的:渲染最小的组件树,等真实生命周期事件,通过公开的 ref 或回调断言。写测试前,先问自己四个问题:权限:授权后断言状态是authorized;用户拒绝时,应用该降级而不是崩溃。模式切换:会话运行中再次configure,输入与输出能重新接线,起止监听器按序触发。拍照:返回的Photo宽高都大于 0,容器格式和请求一致;设备没有闪光灯时,flashMode: on应当 reject。录像:recorder.stop()后文件非空;maxDuration、maxFileSize能自动掐停;等onRecordingFinished回调,别轮询isRunning。 模拟真实用户:在真机上跑 E2E 套件仓库里的 E2E 分两支。设备端,harness 套件模拟用户完整路径:装好 debug APK,应用启动授予相机权限进相机页,会话启动,预览不再是纯黑屏点拍照,验证返回的照片录几秒后停止,验证视频文件非空一条命令跑完全套:bun run test:harness:android。Web 端则用 Playwright 截图测试守文档站,下面两张就是它的基线快照,页面一变、截图对不上,测试就失败:把测试搬上 CI 流水线设备端套件挂了两个工作流:harness-android-emulator.yml 在每次 PR 和 push 时拉起 Pixel API 35 模拟器,因为模拟器的相机是仿真的,算尽力而为的一跑;harness-aws-device.yml 把套件送上 AWS Device Farm 真机农场,真手机、真相机管线,判定红绿才算数。失败后别瞎猜:下载工作流产物,harness output log 是每个测试的 JS 控制台输出,JUnit XML 用 IDE 的 JUnit 视图一开就是结构化汇总,skip 汇总还会告诉你测试设备缺哪些能力。测试覆盖率想要数字的话,给 Jest 兼容套件加覆盖率开关跑一遍,标准报告会告诉你哪些输出至今没有任何测试。⚠️ 踩坑速查:最常见的四个问题相机硬件依赖:现象 —— 真机农场缺 HDR、闪光灯等特性,测试直接红。对策 —— 先查能力标志(如supportsPhotoHDR),不具备就用context.skip带原因跳过,别让它失败。异步时序:现象 ——session.isRunning还是 false,轮询等固定时间,测试时好时坏。对策 —— 等addOnStartedListener这类真实事件再配合waitUntil;写sleep(500)让它工作是 bug,不是补丁。权限:现象 —— 重装 APK 后,第一条权限断言就挂。对策 —— 权限按安装授予一次,adb install -r之后重新执行pm grant。iOS/Android 差异:现象 —— 某平台独有 API 让同一条测试红掉。对策 —— 静态平台专属特性(如 iOS 的CameraObjectOutput)拆成独立it并加平台跳过;行为本该跨平台一致的,别掩盖,留红让 CI 暴露差异。安全网不是一夜变密的,每个 PR 多一个it块,就多守住一次回归。规则最权威的说明,是测试目录自带的README;而搬上流水线长什么样,上面两条 CI 工作流就是现成答案。【免费下载链接】react-native-vision-camera A powerful, high-performance React Native Camera library.项目地址: https://gitcode.com/GitHub_Trending/re/react-native-vision-camera创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
