BLD-ERPAuto/BIPMaterialManager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: remove migrated root browser docs

Browse Source
This commit is contained in:
Misaka
2026-03-20 21:52:25 +08:00
parent 2216720e24
commit 6d4b5efc95
3 changed files with 0 additions and 373 deletions
Download Patch File Download Diff File Expand all files Collapse all files

176
BROWSER_DEPLOYMENT.md
View File

@@ -1,176 +0,0 @@
# Playwright 浏览器部署指南
## 概述
本文档为开发人员提供 ERPAuto 应用程序中 Playwright Chromium 浏览器的部署指南。文档说明如何将浏览器文件从开发机复制到目标用户机器，确保应用程序能够正常运行浏览器自动化任务。
**重要提示**：部署前请先阅读 [BROWSER_VERSIONS.md](./BROWSER_VERSIONS.md) 了解版本信息。
## 目标路径
浏览器文件必须部署在以下路径：
```
%APPDATA%\erpauto\ms-playwright\chromium-1208\
```
完整展开路径示例（Windows）：
```
C:\Users\<用户名>\AppData\Roaming\erpauto\ms-playwright\chromium-1208\
```
## 目录结构
部署完成后，目标目录结构应如下所示：
```
%APPDATA%\erpauto\ms-playwright\
└── chromium-1208/
└── chrome-win/
├── chrome.exe # 浏览器可执行文件
├── chrome_dll.dll
├── resources/
├── locales/
└── ... # 其他浏览器文件
```
**关键文件**：`chrome-win/chrome.exe` 必须存在，否则浏览器无法启动。
## 部署步骤
### 步骤 1：在开发机上准备
1. 确保开发机已安装正确版本的 Playwright：
```bash
npm install playwright@1.58.2
```
2. 下载 Chromium 浏览器：
```bash
npx playwright install chromium
```
3. 定位开发机上的浏览器缓存目录：
```
C:\Users\<开发机用户名>\AppData\Local\ms-playwright\chromium-1208
```
### 步骤 2：复制文件
1. **复制整个浏览器目录**
- 将开发机上的 `chromium-1208` 目录完整复制
- 不要只复制部分文件，确保所有子目录和文件都包含在内
2. **粘贴到目标路径**
- 在目标机器上创建目录：`%APPDATA%\erpauto\ms-playwright\`
- 将 `chromium-1208` 目录粘贴到该路径下
3. **验证文件完整性**
- 确认目标路径存在：`%APPDATA%\erpauto\ms-playwright\chromium-1208\chrome-win\chrome.exe`
- 检查文件大小约为 280MB
### 步骤 3：配置环境变量（可选）
如需确保应用程序使用正确的浏览器路径，可设置以下环境变量：
```batch
set PLAYWRIGHT_BROWSERS_PATH=%APPDATA%\erpauto\ms-playwright
```
或在应用程序代码中设置：
```javascript
process.env.PLAYWRIGHT_BROWSERS_PATH = path.join(app.getPath('userData'), 'ms-playwright')
```
## 验证步骤
部署完成后，执行以下验证步骤：
### 验证 1：检查目录结构
在目标机器上运行：
```batch
dir %APPDATA%\erpauto\ms-playwright\chromium-1208\chrome-win\chrome.exe
```
应显示文件存在。
### 验证 2：启动浏览器测试
运行 ERPAuto 应用程序，执行以下操作：
1. 登录应用程序
2. 进入「数据提取」页面
3. 输入一个有效订单号
4. 点击「开始提取」
5. 观察浏览器是否正常启动并执行任务
### 验证 3：检查日志
查看应用程序日志，确认没有浏览器相关的错误信息：
- 无 "browser not found" 错误
- 无 "chromium revision not found" 错误
- 无 "PLAYWRIGHT_BROWSERS_PATH" 相关警告
## 故障排查
### 问题 1：浏览器无法启动
**症状**：应用程序报错，提示找不到浏览器或启动失败。
**解决方案**：
1. 确认修订号匹配（必须是 1208）
2. 检查 `chrome-win/chrome.exe` 文件是否存在
3. 验证 `PLAYWRIGHT_BROWSERS_PATH` 环境变量设置正确
4. 确认目标机器具有相同的 Playwright 版本（1.58.2）
### 问题 2：版本不匹配错误
**症状**：应用程序启动时报出版本冲突错误。
**解决方案**：
1. 检查 `package.json` 中的 Playwright 版本是否为 1.58.2
2. 确认复制的 Chromium 修订号为 1208
3. 参考 [BROWSER_VERSIONS.md](./BROWSER_VERSIONS.md) 核对所有版本信息
### 问题 3：权限不足
**症状**：无法写入或读取浏览器目录。
**解决方案**：
1. 确保目标目录具有适当的读写权限
2. 以管理员身份运行应用程序进行测试
3. 检查防病毒软件是否阻止了浏览器执行
### 问题 4：路径错误
**症状**：应用程序在错误的位置查找浏览器文件。
**解决方案**：
1. 确认 `%APPDATA%` 环境变量指向正确的用户目录
2. 检查应用程序是否正确解析了 `userData` 路径
3. 在代码中硬编码浏览器路径进行调试
## 注意事项
- **仅部署 Chromium**：ERPAuto 只需要 Chromium 浏览器，不需要 Firefox 或 WebKit
- **版本一致性**：开发机和目标机器的 Playwright 版本必须一致
- **修订号匹配**：Chromium 修订号（1208）必须完全匹配，否则可能出现兼容性问题
- **文件完整性**：复制时确保所有文件完整，损坏的浏览器文件会导致启动失败
- **网络隔离环境**：目标机器如果无法访问互联网，必须提前部署浏览器文件，因为无法自动下载
## 参考文档
- [BROWSER_VERSIONS.md](./BROWSER_VERSIONS.md) - 版本信息和目录结构详情
- [README.md](./README.md) - 项目总体说明

96
BROWSER_VERSIONS.md
View File

@@ -1,96 +0,0 @@
# 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 中定义版本号

101
PLAYWRIGHT_DEPLOYMENT.md
View File

@@ -1,101 +0,0 @@
# Playwright 部署说明
## 浏览器路径问题修复
### 问题描述
应用启动时提示"浏览器文件未找到"，但浏览器文件已经放置在正确路径下。
**原因**：Playwright 1.48+ 改变了浏览器目录命名规则：
- **旧格式**：`chromium-win32/chrome.exe`
- **新格式**：`chromium-1208/chrome-win64/chrome.exe`（revision 号可能不同）
### 解决方案
代码已更新为自动检测新旧两种格式，并显示当前目录内容以便调试。
## 快速部署
### 方法 1：使用 Playwright CLI（推荐）
```bash
# 在应用目录运行
npx playwright install chromium
```
浏览器会自动下载并安装到正确位置：
- **用户数据目录**：`%APPDATA%\erpauto\ms-playwright\`
- **完整路径**：`C:\Users\pengq\AppData\Roaming\erpauto\ms-playwright\chromium-<revision>\chrome-win64\chrome.exe`
### 方法 2：手动复制
如果你已经有 Playwright 浏览器文件，可以复制到应用的用户数据目录：
1. 找到现有浏览器文件（通常在 `%USERPROFILE%\AppData\Local\ms-playwright`）
2. 复制到 `%APPDATA%\erpauto\ms-playwright\`
3. 确保目录结构正确：
```
ms-playwright/
├── chromium-1208/
│ ├── chrome-win64/
│ │ └── chrome.exe
│ └── INSTALLATION_COMPLETE
└── chromium_headless_shell-1208/
└── ...
```
### 方法 3：使用 PLAYWRIGHT_BROWSERS_PATH 环境变量
将浏览器文件放在共享位置，然后设置环境变量：
```bash
# 系统环境变量
setx PLAYWRIGHT_BROWSERS_PATH "D:\shared\playwright-browsers"
```
或在应用启动脚本中设置。
## 验证安装
运行应用后，检查是否还有错误提示。如果没有浏览器错误，说明安装成功。
你也可以在应用日志中查找：
- `Found Chromium revision: chromium-1208` - 表示成功找到浏览器
- `Playwright browser not found` - 表示未找到，会显示可用目录列表
## 常见问题
### Q: 显示"浏览器文件未找到"但文件确实在那里
检查目录结构是否正确：
```powershell
# 查看当前目录内容
Get-ChildItem $env:APPDATA\erpauto\ms-playwright
# 检查 chrome.exe 是否存在
Test-Path "$env:APPDATA\erpauto\ms-playwright\chromium-*/chrome-win64/chrome.exe"
```
### Q: 不同用户使用同一个浏览器文件
使用环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向共享目录。
### Q: 离线部署
1. 在有网络的机器上运行 `npx playwright install chromium`
2. 复制整个 `ms-playwright` 目录
3. 在目标机器上设置 `PLAYWRIGHT_BROWSERS_PATH` 指向该目录
## 下次构建
只需运行：
```bash
npm run build:win
```
所有配置已保存，Playwright 模块和浏览器路径检查会自动处理。