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>
97 lines
2.2 KiB
Markdown
97 lines
2.2 KiB
Markdown
# 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
|
||
└── ...
|
||
```
|
||
|
||
## 部署指南
|
||
|
||
### 开发环境准备
|
||
|
||
1. 安装 Playwright 1.58.2
|
||
|
||
```bash
|
||
npm install playwright@1.58.2
|
||
```
|
||
|
||
2. 下载 Chromium 浏览器
|
||
```bash
|
||
npx playwright install chromium
|
||
```
|
||
|
||
### 浏览器文件复制步骤
|
||
|
||
1. **定位源目录**
|
||
- 开发机上找到 Playwright 浏览器缓存目录
|
||
- 默认路径：`C:\Users\<用户名>\AppData\Local\ms-playwright\chromium-1208`
|
||
|
||
2. **复制浏览器文件**
|
||
- 将整个 `chromium-1208` 目录复制到部署目标
|
||
- 目标路径：`%APPDATA%\erpauto\ms-playwright\chromium-1208`
|
||
|
||
3. **验证目录结构**
|
||
- 确认目标路径包含 `chrome-win/chrome.exe`
|
||
- 确保所有子文件完整复制
|
||
|
||
### 环境变量配置
|
||
|
||
如需要自定义浏览器路径，可设置环境变量：
|
||
|
||
```bash
|
||
# Windows
|
||
set PLAYWRIGHT_BROWSERS_PATH=%APPDATA%\erpauto\ms-playwright
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 仅包含 Chromium 浏览器（Firefox 和 WebKit 不需要）
|
||
- 浏览器文件体积约为 280MB
|
||
- 部署时确保目标机器具有相同的 Playwright 版本（1.58.2）
|
||
- 修订号必须匹配（1208），否则可能出现兼容性问题
|
||
|
||
## 故障排查
|
||
|
||
### 浏览器无法启动
|
||
|
||
1. 检查修订号是否匹配（1208）
|
||
2. 确认 `chrome-win/chrome.exe` 文件存在
|
||
3. 验证 PLAYWRIGHT_BROWSERS_PATH 环境变量设置
|
||
|
||
### 版本不匹配错误
|
||
|
||
确保以下版本一致：
|
||
|
||
- package.json 中的 Playwright 版本
|
||
- 下载的 Chromium 修订号
|
||
- browsers.json 中定义版本号
|