aisee/aisee_flutter/启动指南.md

启动 AISee Flutter 项目指南

前提条件检查

1. 检查 Flutter 是否安装

打开命令提示符（CMD）或 PowerShell，运行：

flutter --version

如果显示版本信息，说明 Flutter 已安装，跳到步骤 2。

如果提示"命令不存在"，需要先安装 Flutter，参考：Flutter开发环境搭建.md

2. 检查设备连接

flutter devices

应该看到：

• Android 模拟器，或
• 连接的 Android 真机

如果没有设备：

• 启动 Android 模拟器（Android Studio -> Device Manager）
• 或连接真机并开启 USB 调试

启动步骤

方法 1：使用脚本（推荐）

1. 安装依赖

   • 双击 install.bat
   • 等待依赖下载完成

2. 运行项目

   • 双击 run.bat
   • 等待编译和安装

方法 2：使用命令行

打开命令提示符，进入项目目录：

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

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:

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

解决：

# 清理项目
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. 关闭防火墙（测试时）

热重载

代码修改后，无需重新编译：

# 在运行的终端按：
r  # 热重载（保留状态）
R  # 热重启（重置状态）
q  # 退出

或在 VS Code 中：

• Ctrl + S 保存后自动热重载
• Ctrl + F5 热重启

调试

查看日志

flutter logs

查看性能

flutter run --profile

查看设备信息

flutter doctor -v

下一步

项目运行成功后：

1. 测试拍照功能
2. 测试实时传输
3. 调整配置参数（分辨率、帧率）
4. 开发后端 API
5. 集成 AI 模型

---

需要帮助？

查看项目根目录的其他文档：

• Flutter开发环境搭建.md - 环境配置
• Flutter项目初始化.md - 项目结构
• 技术方案.md - 技术架构