add first version

aisee_flutter/启动指南.md

@@ -0,0 +1,253 @@
+# 启动 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` - 技术架构