# 启动 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` - 技术架构