健康保险网站胶州市城乡建设局网站截图

## Flutter 开发常见问题排查与解决

### 1. 项目初始化与依赖问题
```bash
# 清理项目
flutter clean

# 获取依赖
flutter pub get

# 详细日志运行
flutter run -v
```

### 2. 网络和下载问题
- 网络慢可能导致依赖下载卡住
- 使用 `-v` 参数可查看详细日志
- 检查网络连接
- 可以尝试使用国内镜像源

### 3. Android 设备认证与配置
#### 设备连接前准备
1. 确保安装 Android SDK Command-line Tools
2. 开启开发者模式
3. 允许USB调试

### 4. 系统状态检查
```bash
# 检查Flutter开发环境状态
flutter doctor
```

### 5. Gradle 配置优化

#### build.gradle 配置
```gradle
// 调整最小SDK版本
defaultConfig {
    minSdkVersion 34  // 根据实际设备调整
    targetSdkVersion 35
}
```

#### gradle-wrapper.properties 修改
```properties
# 修改下载链接为 bin 版本
distributionUrl=https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
```

### 6. 常见卡住情况处理
- 网络问题：检查代理、切换网络
- 依赖下载：使用 `flutter pub get --verbose`
- 编译卡住：查看详细日志 `flutter run -v`

### 7. 网络加速建议
- 使用国内镜像
- 配置 pub 源
```bash
# 配置国内镜像
flutter pub config proxy=http://your-proxy-server
```

### 8. 设备连接troubleshooting
- 确保USB调试已开启
- 检查驱动程序
- 尝试更换USB接口
- 重启ADB服务 `adb kill-server && adb start-server`

### 9. 常用调试命令
```bash
# 列出可用设备
flutter devices

# 查看详细诊断信息
flutter doctor -v
```

### 10. 最佳实践
- 定期更新Flutter和Dart SDK
- 保持Gradle和依赖版本兼容
- 使用稳定的网络环境
- 备份项目依赖配置

## 温馨提示
- 遇到问题先看日志
- 不要盲目尝试，逐步排查
- 必要时可以清理缓存重新开始