删除冗余代码，美化UI界面
This commit is contained in:
247
TESTING_FFMPEG.md
Normal file
247
TESTING_FFMPEG.md
Normal file
@@ -0,0 +1,247 @@
|
||||
# FFmpeg 安装测试指南
|
||||
|
||||
## 测试目标
|
||||
测试在没有 FFmpeg 的电脑上全新安装该软件后，第一次启动时的 FFmpeg 自动安装流程。
|
||||
|
||||
## 测试方法
|
||||
|
||||
### 方法 1：临时重命名 FFmpeg（推荐）
|
||||
|
||||
如果你的电脑已经安装了 FFmpeg，可以临时重命名它来模拟未安装的情况：
|
||||
|
||||
#### macOS/Linux:
|
||||
```bash
|
||||
# 1. 查找 FFmpeg 位置
|
||||
which ffmpeg
|
||||
|
||||
# 2. 临时重命名（需要 sudo）
|
||||
# 如果在 /usr/local/bin/ffmpeg
|
||||
sudo mv /usr/local/bin/ffmpeg /usr/local/bin/ffmpeg.backup
|
||||
sudo mv /usr/local/bin/ffprobe /usr/local/bin/ffprobe.backup
|
||||
|
||||
# 如果在 /opt/homebrew/bin/ffmpeg (Apple Silicon)
|
||||
sudo mv /opt/homebrew/bin/ffmpeg /opt/homebrew/bin/ffmpeg.backup
|
||||
sudo mv /opt/homebrew/bin/ffprobe /opt/homebrew/bin/ffprobe.backup
|
||||
|
||||
# 3. 测试完成后恢复
|
||||
sudo mv /usr/local/bin/ffmpeg.backup /usr/local/bin/ffmpeg
|
||||
sudo mv /usr/local/bin/ffprobe.backup /usr/local/bin/ffprobe
|
||||
```
|
||||
|
||||
#### Windows:
|
||||
```cmd
|
||||
# 1. 查找 FFmpeg 位置
|
||||
where ffmpeg
|
||||
|
||||
# 2. 临时重命名
|
||||
ren "C:\path\to\ffmpeg.exe" "ffmpeg.exe.backup"
|
||||
ren "C:\path\to\ffprobe.exe" "ffprobe.exe.backup"
|
||||
|
||||
# 3. 测试完成后恢复
|
||||
ren "C:\path\to\ffmpeg.exe.backup" "ffmpeg.exe"
|
||||
ren "C:\path\to\ffprobe.exe.backup" "ffprobe.exe"
|
||||
```
|
||||
|
||||
### 方法 2：删除应用数据目录
|
||||
|
||||
删除应用存储的 FFmpeg：
|
||||
|
||||
#### macOS:
|
||||
```bash
|
||||
rm -rf ~/Library/Application\ Support/FormatConverter/ffmpeg
|
||||
```
|
||||
|
||||
#### Windows:
|
||||
```cmd
|
||||
del /F /Q "%LOCALAPPDATA%\FormatConverter\ffmpeg.exe"
|
||||
```
|
||||
|
||||
#### Linux:
|
||||
```bash
|
||||
rm -rf ~/.local/share/format-converter/ffmpeg
|
||||
```
|
||||
|
||||
### 方法 3：使用虚拟机或容器
|
||||
|
||||
最彻底的测试方法：
|
||||
1. 使用虚拟机（VirtualBox、VMware、Parallels）
|
||||
2. 使用 Docker 容器
|
||||
3. 使用云端测试环境
|
||||
|
||||
## 测试流程
|
||||
|
||||
### 1. 启动应用
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 2. 观察初始化过程
|
||||
|
||||
应该看到以下流程：
|
||||
|
||||
1. **应用启动**
|
||||
- 显示主页面
|
||||
- 底部状态栏显示"检测编码器..."
|
||||
|
||||
2. **检测 FFmpeg**
|
||||
- 控制台输出：`正在检测 FFmpeg...`
|
||||
- 控制台输出：`调用 check_ffmpeg_status...`
|
||||
|
||||
3. **弹出安装引导**
|
||||
- 如果未检测到 FFmpeg，自动弹出安装引导弹窗
|
||||
- 弹窗标题：🔧 需要安装 FFmpeg
|
||||
- 显示两个选项：
|
||||
- 🚀 自动安装（推荐）
|
||||
- 📝 手动安装
|
||||
|
||||
4. **点击"开始安装"**
|
||||
- 弹窗关闭
|
||||
- 切换到安装页面
|
||||
- 显示进度条和安装信息
|
||||
|
||||
5. **安装过程**
|
||||
- 0-5%: 准备下载 FFmpeg...
|
||||
- 5-50%: 正在下载 FFmpeg... (显示下载进度)
|
||||
- 50-90%: 正在解压...
|
||||
- 90-95%: 正在安装...
|
||||
- 95-100%: 正在清理...
|
||||
- 100%: FFmpeg 安装完成
|
||||
|
||||
6. **安装完成**
|
||||
- 自动返回主页面
|
||||
- 底部状态栏显示"编码器"（绿色点）
|
||||
- 鼠标悬停显示 FFmpeg 版本信息
|
||||
|
||||
### 3. 验证安装
|
||||
|
||||
安装完成后，验证功能：
|
||||
|
||||
1. **选择文件**
|
||||
- 点击或拖拽文件到主页面
|
||||
- 应该能正常分析文件
|
||||
|
||||
2. **转换测试**
|
||||
- 选择一个小文件进行转换
|
||||
- 观察转换过程是否正常
|
||||
|
||||
3. **检查安装位置**
|
||||
```bash
|
||||
# macOS
|
||||
ls -la ~/Library/Application\ Support/FormatConverter/
|
||||
|
||||
# Windows
|
||||
dir "%LOCALAPPDATA%\FormatConverter\"
|
||||
|
||||
# Linux
|
||||
ls -la ~/.local/share/format-converter/
|
||||
```
|
||||
|
||||
## 预期结果
|
||||
|
||||
### 成功场景
|
||||
- ✅ 自动检测到 FFmpeg 未安装
|
||||
- ✅ 弹出安装引导弹窗
|
||||
- ✅ 点击"开始安装"后显示安装页面
|
||||
- ✅ 显示实时下载和安装进度
|
||||
- ✅ 安装完成后自动返回主页面
|
||||
- ✅ 状态栏显示"编码器"（绿色）
|
||||
- ✅ 可以正常使用转换功能
|
||||
|
||||
### 失败场景处理
|
||||
- ❌ 网络连接失败：显示错误信息，提示检查网络
|
||||
- ❌ 下载失败：显示错误信息，提供重试选项
|
||||
- ❌ 解压失败：显示错误信息，提示手动安装
|
||||
- ❌ 权限不足：显示错误信息，提示以管理员身份运行
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 点击"稍后安装"后怎么办？
|
||||
A: 弹窗关闭，但状态栏仍显示"编码器未安装"。用户可以：
|
||||
- 手动安装 FFmpeg 到系统 PATH
|
||||
- 重启应用，会再次弹出安装引导
|
||||
|
||||
### Q: 安装失败怎么办？
|
||||
A: 应用会显示错误信息。用户可以：
|
||||
1. 检查网络连接
|
||||
2. 点击重试
|
||||
3. 选择手动安装 FFmpeg
|
||||
|
||||
### Q: 如何手动安装 FFmpeg？
|
||||
A:
|
||||
- **macOS**: `brew install ffmpeg`
|
||||
- **Windows**: 从 [ffmpeg.org](https://ffmpeg.org/download.html) 下载并添加到 PATH
|
||||
- **Linux**: `sudo apt install ffmpeg` 或对应包管理器
|
||||
|
||||
### Q: 安装后在哪里？
|
||||
A:
|
||||
- **macOS**: `~/Library/Application Support/FormatConverter/ffmpeg`
|
||||
- **Windows**: `%LOCALAPPDATA%\FormatConverter\ffmpeg.exe`
|
||||
- **Linux**: `~/.local/share/format-converter/ffmpeg`
|
||||
|
||||
## 调试技巧
|
||||
|
||||
### 查看控制台日志
|
||||
```bash
|
||||
# 开发模式下，控制台会输出详细日志
|
||||
npm run dev
|
||||
|
||||
# 查看后端日志
|
||||
# 在终端中查看 Rust 输出
|
||||
```
|
||||
|
||||
### 手动触发安装
|
||||
在浏览器控制台中执行：
|
||||
```javascript
|
||||
// 显示安装引导
|
||||
document.getElementById('ffmpeg-install-guide').classList.add('active');
|
||||
|
||||
// 直接开始安装
|
||||
installFFmpeg();
|
||||
```
|
||||
|
||||
### 检查 FFmpeg 状态
|
||||
在浏览器控制台中执行：
|
||||
```javascript
|
||||
// 检查 FFmpeg 状态
|
||||
window.tauriInvoke('check_ffmpeg_status').then(console.log);
|
||||
|
||||
// 获取 FFmpeg 版本
|
||||
// 返回: [installed: boolean, version: string | null]
|
||||
```
|
||||
|
||||
## 测试清单
|
||||
|
||||
- [ ] 应用启动时自动检测 FFmpeg
|
||||
- [ ] 未安装时弹出安装引导弹窗
|
||||
- [ ] 安装引导 UI 显示正常
|
||||
- [ ] 点击"开始安装"切换到安装页面
|
||||
- [ ] 显示实时下载进度
|
||||
- [ ] 显示解压和安装进度
|
||||
- [ ] 安装完成后返回主页面
|
||||
- [ ] 状态栏显示"编码器"（绿色）
|
||||
- [ ] 可以正常选择和转换文件
|
||||
- [ ] 点击"稍后安装"可以关闭弹窗
|
||||
- [ ] 安装失败时显示错误信息
|
||||
- [ ] 重启应用后不再弹出安装引导（已安装）
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **网络要求**: 自动安装需要网络连接，下载大小约 50-100 MB
|
||||
2. **权限要求**: 某些系统可能需要管理员权限
|
||||
3. **磁盘空间**: 确保有足够的磁盘空间（至少 200 MB）
|
||||
4. **防火墙**: 确保防火墙允许应用访问网络
|
||||
5. **代理设置**: 如果使用代理，可能需要配置系统代理
|
||||
|
||||
## 恢复测试环境
|
||||
|
||||
测试完成后，记得恢复 FFmpeg：
|
||||
|
||||
```bash
|
||||
# macOS/Linux
|
||||
sudo mv /usr/local/bin/ffmpeg.backup /usr/local/bin/ffmpeg
|
||||
sudo mv /usr/local/bin/ffprobe.backup /usr/local/bin/ffprobe
|
||||
|
||||
# Windows
|
||||
ren "C:\path\to\ffmpeg.exe.backup" "ffmpeg.exe"
|
||||
ren "C:\path\to\ffprobe.exe.backup" "ffprobe.exe"
|
||||
```
|
||||
Reference in New Issue
Block a user