254 lines
4.6 KiB
Markdown
254 lines
4.6 KiB
Markdown
# 启动 AISee Flutter 项目指南
|
||
|
||
## 前提条件检查
|
||
|
||
### 1. 检查 Flutter 是否安装
|
||
|
||
打开命令提示符（CMD）或 PowerShell，运行：
|
||
|
||
```bash
|
||
flutter --version
|
||
```
|
||
|
||
**如果显示版本信息**，说明 Flutter 已安装，跳到步骤 2。
|
||
|
||
**如果提示"命令不存在"**，需要先安装 Flutter，参考：`Flutter开发环境搭建.md`
|
||
|
||
### 2. 检查设备连接
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
应该看到：
|
||
- Android 模拟器，或
|
||
- 连接的 Android 真机
|
||
|
||
**如果没有设备**：
|
||
- 启动 Android 模拟器（Android Studio -> Device Manager）
|
||
- 或连接真机并开启 USB 调试
|
||
|
||
## 启动步骤
|
||
|
||
### 方法 1：使用脚本（推荐）
|
||
|
||
1. **安装依赖**
|
||
- 双击 `install.bat`
|
||
- 等待依赖下载完成
|
||
|
||
2. **运行项目**
|
||
- 双击 `run.bat`
|
||
- 等待编译和安装
|
||
|
||
### 方法 2：使用命令行
|
||
|
||
打开命令提示符，进入项目目录：
|
||
|
||
```bash
|
||
cd C:\Users\xdedmi\Desktop\aisee\aisee_flutter
|
||
|
||
# 1. 安装依赖
|
||
flutter pub get
|
||
|
||
# 2. 检查设备
|
||
flutter devices
|
||
|
||
# 3. 运行项目
|
||
flutter run
|
||
```
|
||
|
||
### 方法 3：使用 VS Code
|
||
|
||
1. 用 VS Code 打开项目文件夹
|
||
2. 按 `F5` 或点击右上角的运行按钮
|
||
3. 选择设备（模拟器或真机）
|
||
4. 等待编译和安装
|
||
|
||
## 配置后端地址
|
||
|
||
在运行前，需要配置后端 API 地址。
|
||
|
||
编辑文件：`lib/utils/app_config.dart`
|
||
|
||
```dart
|
||
class AppConfig {
|
||
// 如果使用 Android 模拟器
|
||
static const String apiBaseUrl = 'http://10.0.2.2:8000';
|
||
|
||
// 如果使用真机（改为你的电脑 IP 地址）
|
||
// static const String apiBaseUrl = 'http://192.168.1.100:8000';
|
||
|
||
// ...
|
||
}
|
||
```
|
||
|
||
### 如何获取电脑 IP 地址？
|
||
|
||
**Windows:**
|
||
```bash
|
||
ipconfig
|
||
# 查找 "IPv4 地址"，例如：192.168.1.100
|
||
```
|
||
|
||
**确保手机和电脑在同一 WiFi 网络！**
|
||
|
||
## 首次运行
|
||
|
||
首次运行需要：
|
||
1. 下载 Gradle 依赖（约 5-10 分钟）
|
||
2. 编译 Android 应用（约 2-3 分钟）
|
||
3. 安装到设备
|
||
|
||
**请耐心等待，不要中断！**
|
||
|
||
## 运行成功标志
|
||
|
||
看到以下信息说明成功：
|
||
|
||
```
|
||
✓ Built build/app/outputs/flutter-apk/app-debug.apk.
|
||
Installing build/app/outputs/flutter-apk/app.apk...
|
||
Syncing files to device...
|
||
Flutter run key commands.
|
||
r Hot reload.
|
||
R Hot restart.
|
||
```
|
||
|
||
应用会自动在设备上打开。
|
||
|
||
## 使用应用
|
||
|
||
1. **授予权限**
|
||
- 首次打开会请求相机权限
|
||
- 点击"允许"
|
||
|
||
2. **打开相机**
|
||
- 点击首页的"打开相机"按钮
|
||
|
||
3. **开始传输**
|
||
- 点击"开始传输"按钮
|
||
- 观察状态栏的帧数统计
|
||
|
||
4. **查看效果**
|
||
- 捕获帧数：相机捕获的总帧数
|
||
- 上传帧数：成功上传到后端的帧数
|
||
|
||
## 常见问题
|
||
|
||
### 1. Flutter 命令不存在
|
||
|
||
**问题**：`'flutter' 不是内部或外部命令`
|
||
|
||
**解决**：
|
||
1. 检查 Flutter 是否安装
|
||
2. 检查环境变量是否配置
|
||
3. 重启命令提示符
|
||
4. 参考 `Flutter开发环境搭建.md`
|
||
|
||
### 2. 没有可用设备
|
||
|
||
**问题**：`No devices found`
|
||
|
||
**解决**：
|
||
- 启动 Android 模拟器
|
||
- 或连接真机并开启 USB 调试
|
||
|
||
### 3. Gradle 下载慢
|
||
|
||
**问题**：卡在 `Running Gradle task 'assembleDebug'...`
|
||
|
||
**解决**：
|
||
1. 配置国内镜像（见环境搭建文档）
|
||
2. 使用代理
|
||
3. 耐心等待（首次需要 10-30 分钟）
|
||
|
||
### 4. 编译错误
|
||
|
||
**问题**：`FAILURE: Build failed with an exception`
|
||
|
||
**解决**：
|
||
```bash
|
||
# 清理项目
|
||
flutter clean
|
||
|
||
# 重新获取依赖
|
||
flutter pub get
|
||
|
||
# 重新运行
|
||
flutter run
|
||
```
|
||
|
||
### 5. 相机权限被拒绝
|
||
|
||
**问题**：应用显示"相机权限被拒绝"
|
||
|
||
**解决**：
|
||
1. 进入手机设置 -> 应用管理 -> aisee_flutter
|
||
2. 权限 -> 相机 -> 允许
|
||
3. 重启应用
|
||
|
||
### 6. 网络连接失败
|
||
|
||
**问题**：上传图像失败
|
||
|
||
**解决**：
|
||
1. 确保后端服务已启动
|
||
2. 检查 `app_config.dart` 中的 IP 地址
|
||
3. 模拟器用 `10.0.2.2`，真机用电脑 IP
|
||
4. 确保手机和电脑在同一网络
|
||
5. 关闭防火墙（测试时）
|
||
|
||
## 热重载
|
||
|
||
代码修改后，无需重新编译：
|
||
|
||
```bash
|
||
# 在运行的终端按：
|
||
r # 热重载（保留状态）
|
||
R # 热重启（重置状态）
|
||
q # 退出
|
||
```
|
||
|
||
或在 VS Code 中：
|
||
- `Ctrl + S` 保存后自动热重载
|
||
- `Ctrl + F5` 热重启
|
||
|
||
## 调试
|
||
|
||
### 查看日志
|
||
|
||
```bash
|
||
flutter logs
|
||
```
|
||
|
||
### 查看性能
|
||
|
||
```bash
|
||
flutter run --profile
|
||
```
|
||
|
||
### 查看设备信息
|
||
|
||
```bash
|
||
flutter doctor -v
|
||
```
|
||
|
||
## 下一步
|
||
|
||
项目运行成功后：
|
||
|
||
1. 测试拍照功能
|
||
2. 测试实时传输
|
||
3. 调整配置参数（分辨率、帧率）
|
||
4. 开发后端 API
|
||
5. 集成 AI 模型
|
||
|
||
---
|
||
|
||
**需要帮助？**
|
||
|
||
查看项目根目录的其他文档：
|
||
- `Flutter开发环境搭建.md` - 环境配置
|
||
- `Flutter项目初始化.md` - 项目结构
|
||
- `技术方案.md` - 技术架构
|