本地开发环境

基线要求

• Flutter SDK：以仓库 README 和当前 workflow 为准
• Java：Android 构建需要
• Android 工具链：生成 APK 需要

首次启动

1. 安装 Flutter，并确认 flutter doctor
2. 运行 flutter pub get
3. 创建 lib/common/config/ignoreConfig.dart
4. 填入 GitHub OAuth 所需的 CLIENT_ID 和 CLIENT_SECRET

示例：

class NetConfig {
  static const CLIENT_ID = "xxxx";
  static const CLIENT_SECRET = "xxxx";
}

常用命令

flutter pub get
flutter analyze
dart run build_runner build --delete-conflicting-outputs
flutter build apk --release --target-platform=android-arm64 --no-shrink

什么时候需要重新生成

• 改模型、序列化、Riverpod 注解或 env 源文件时，跑 build_runner
• 改 ARB 多语言文件时，重新生成本地化输出

常见失败原因

• 缺少 ignoreConfig.dart
• Flutter 版本不匹配
• 拉包时网络或代理异常
• 手改生成文件但没同步源文件

当前本地验证策略

仓库目前没有提交进来的自动化测试目录，因此本地验证以静态检查、构建和手工冒烟为主：

• 跑 flutter analyze
• 对构建相关改动跑 APK 构建
• 在模拟器或真机上手工验证改动功能