b3abad7fae
Move Playwright from dev to production dependencies and implement robust browser management for company deployment environment: - Move playwright and playwright-core to dependencies - Set PLAYWRIGHT_BROWSERS_PATH to user data directory before imports - Add startup validation for Chromium browser with friendly error dialog - Update build scripts to skip browser download during build process - Configure electron-builder to unpack Playwright for native module access - Add deployment documentation for browser setup in restricted environments This allows manual browser installation in company environments where direct downloads are blocked during build. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
Playwright 浏览器版本信息
本文档记录 ERPAuto 项目使用的 Playwright 浏览器版本和部署信息。
版本信息
| 组件 | 版本号 |
|---|---|
| Playwright | 1.58.2 |
| Chromium | 145.0.7632.6 |
| Chromium 修订号 | 1208 |
浏览器目录结构
Playwright 将浏览器文件缓存在以下位置：
Windows 开发环境
C:\Users\<用户名>\AppData\Local\ms-playwright\
└── chromium-1208/
└── chrome-win/
├── chrome.exe
└── ...
目标部署环境
%APPDATA%\erpauto\ms-playwright\
└── chromium-1208/
└── chrome-win/
├── chrome.exe
└── ...
部署指南
开发环境准备
-
安装 Playwright 1.58.2
npm install playwright@1.58.2 -
下载 Chromium 浏览器
npx playwright install chromium
浏览器文件复制步骤
-
定位源目录
- 开发机上找到 Playwright 浏览器缓存目录
- 默认路径：
C:\Users\<用户名>\AppData\Local\ms-playwright\chromium-1208
-
复制浏览器文件
- 将整个
chromium-1208目录复制到部署目标 - 目标路径：
%APPDATA%\erpauto\ms-playwright\chromium-1208
- 将整个
-
验证目录结构
- 确认目标路径包含
chrome-win/chrome.exe - 确保所有子文件完整复制
- 确认目标路径包含
环境变量配置
如需要自定义浏览器路径，可设置环境变量：
# Windows
set PLAYWRIGHT_BROWSERS_PATH=%APPDATA%\erpauto\ms-playwright
注意事项
- 仅包含 Chromium 浏览器（Firefox 和 WebKit 不需要）
- 浏览器文件体积约为 280MB
- 部署时确保目标机器具有相同的 Playwright 版本（1.58.2）
- 修订号必须匹配（1208），否则可能出现兼容性问题
故障排查
浏览器无法启动
- 检查修订号是否匹配（1208）
- 确认
chrome-win/chrome.exe文件存在 - 验证 PLAYWRIGHT_BROWSERS_PATH 环境变量设置
版本不匹配错误
确保以下版本一致：
- package.json 中的 Playwright 版本
- 下载的 Chromium 修订号
- browsers.json 中定义版本号