# FlutterCarManager **Repository Path**: HesenjanJava/flutter-car-manager ## Basic Information - **Project Name**: FlutterCarManager - **Description**: 基于Flutter的汽车管理应用开发项目，提供车辆信息管理、维护提醒等功能，助力开发者快速构建高效美观的汽车管理应用。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-06-24 - **Last Updated**: 2026-03-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ERP System 1.0.6 - 自动更新功能 ## 项目简介 ERP System 1.0.6 版本实现了完整的跨平台自动更新功能，支持 Windows、Android、macOS 和 iOS 平台。本项目提供了版本检查、下载、安装等完整的自动更新解决方案。 ## 主要功能 ### 自动更新功能 - ✅ 版本检查 (手动和自动) - ✅ 流式下载更新包 - ✅ 跨平台安装支持 - ✅ 实时进度反馈 - ✅ 完善的错误处理 - ✅ 支持取消下载 ### 跨平台支持 - ✅ Windows 7/8/10/11 (64位) - ✅ Android 5.0+ (API 21+) - ✅ macOS 10.14+ (Intel 和 Apple Silicon) - ⚠️ iOS 12.0+ (待测试) ## 快速开始 ### 环境要求 #### Windows 开发环境 - Windows 10/11 (64位) - Flutter SDK 3.9.2+ - Visual Studio 2019/2022 - .NET Framework 4.7.2+ #### Android 开发环境 - Android Studio - Android SDK - Java JDK 8+ #### macOS 开发环境 - macOS 10.14+ - Xcode 12+ - CocoaPods ### 安装依赖 ```bash flutter pub get ``` ### 构建应用 #### Windows ```bash # 构建可执行文件 flutter build windows --release # 创建 MSIX 包 flutter pub run msix:create # 或使用自动构建脚本 build_windows.bat ``` #### Android ```bash # 构建 APK flutter build apk --release # 构建 App Bundle flutter build appbundle --release ``` #### macOS ```bash # 构建 macOS 版本 flutter build macos # 或使用跨平台构建脚本 bash build_all_platforms.sh ``` ### 运行应用 ```bash # Windows flutter run -d windows # Android flutter run -d android # macOS flutter run -d macos ``` ## 项目结构 ``` flutter-car-manager/ ├── lib/ │ ├── services/ │ │ ├── auto_update_service.dart # 原始自动更新服务 │ │ └── enhanced_auto_update_service.dart # 增强的自动更新服务 │ ├── models/ │ │ └── sys_app_update_model.dart # 更新数据模型 │ └── app/ │ └── modules/ │ └── update/ │ ├── update_check_page.dart # 原始更新检查页面 │ └── enhanced_update_check_page.dart # 增强的更新检查页面 ├── build/ │ ├── windows/ │ │ └── x64/runner/Release/ │ │ ├── erp.exe # Windows 可执行文件 │ │ └── erp.msix # Windows MSIX 包 │ └── app/outputs/ │ ├── flutter-apk/ │ │ └── app-release.apk # Android APK │ └── bundle/release/ │ └── app-release.aab # Android App Bundle ├── windows/ │ └── runner/ │ └── Runner.rc # Windows 资源配置 ├── android/ │ └── app/ │ └── build.gradle # Android 构建配置 ├── macos/ │ └── Runner/ │ └── Configs/ # macOS 配置 ├── ios/ │ └── Runner/ # iOS 配置 ├── build_windows.bat # Windows 构建脚本 ├── build_all_platforms.sh # 跨平台构建脚本 ├── installer.iss # Inno Setup 安装脚本 ├── win-appcast.xml # Windows 更新源配置 ├── mac-appcast.xml # macOS 更新源配置 ├── license.txt # 软件许可协议 ├── AUTO_UPDATE_TEST_PLAN.md # 自动更新测试计划 ├── QUALITY_ASSURANCE_REPORT.md # 质量保证评估报告 ├── DEPLOYMENT_GUIDE.md # 部署指南 ├── PROJECT_SUMMARY.md # 项目总结 └── README.md # 本文件 ``` ## 核心功能说明 ### EnhancedAutoUpdateService 增强的自动更新服务，提供完整的更新功能: ```dart // 初始化服务 final updateService = Get.find(); // 手动检查更新 await updateService.checkForUpdates(manual: true); // 下载并安装更新 await updateService.downloadAndInstallUpdate(); // 取消下载 updateService.cancelDownload(); // 启动自动检查 updateService.startAutoCheck(); // 停止自动检查 updateService.stopAutoCheck(); ``` ### EnhancedUpdateCheckPage 更新检查页面，提供友好的用户界面: - 显示当前版本信息 - 显示更新状态 - 显示下载进度 - 管理更新设置 - 显示更新历史 ## 配置说明 ### 更新服务器配置 在 `enhanced_auto_update_service.dart` 中配置: ```dart static const String _updateServerUrl = 'https://cdn.serkol.cn/erp/downloads/'; static const Duration _checkInterval = Duration(hours: 24); ``` ### 更新源配置 #### Windows (win-appcast.xml) ```xml ERP System 1.0.6 https://cdn.serkol.cn/erp/downloads/erp_1.0.6.exe 1.0.6 ``` #### macOS (mac-appcast.xml) ```xml ERP System 1.0.6 https://cdn.serkol.cn/erp/downloads/erp_1.0.6.dmg 1.0.6 ``` ### API 配置 更新检查 API 端点: ``` GET /api/sys/app/check/{platform}/{buildNumber} ``` 响应示例: ```json { "id": 1, "type": 50000000, "remark": "更新说明", "url": "https://cdn.serkol.cn/erp/downloads/erp_1.0.6.exe", "version_name": "1.0.6", "version": 106, "status": 1 } ``` ## 测试 ### 运行测试 ```bash # 运行所有测试 flutter test # 运行特定测试 flutter test test/auto_update_test.dart ``` ### 测试计划 详细的测试计划请参考 [AUTO_UPDATE_TEST_PLAN.md](AUTO_UPDATE_TEST_PLAN.md) 测试覆盖: - 功能测试 (11 个用例) - 平台兼容性测试 (12 个用例) - 性能测试 (4 个用例) - 安全性测试 (3 个用例) - 用户体验测试 (3 个用例) - 回归测试 (3 个用例) **总计: 36+ 测试用例** ## 质量保证 ### 质量评估 详细的质量保证评估报告请参考 [QUALITY_ASSURANCE_REPORT.md](QUALITY_ASSURANCE_REPORT.md) **综合评分: 8.73/10 (优秀)** | 评估项目 | 评分 | |---------|------| | 代码质量 | 8.5/10 | | 功能完整性 | 9.0/10 | | 性能 | 9.0/10 | | 安全性 | 8.5/10 | | 用户体验 | 8.5/10 | | 兼容性 | 8.5/10 | ### 主要优点 - ✅ 自动更新功能完整 - ✅ 跨平台支持良好 - ✅ 性能优秀 - ✅ 安全性良好 - ✅ 用户体验良好 - ✅ 代码质量良好 ### 需要改进的方面 - ⚠️ iOS 平台支持待完善 - ⚠️ 断点续传功能待完善 - ⚠️ 文件完整性检查待加强 - ⚠️ 代码注释覆盖率待提高 ## 部署 ### 部署指南 详细的部署指南请参考 [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) ### 部署步骤 1. **构建应用** ```bash # Windows flutter build windows --release flutter pub run msix:create # Android flutter build apk --release flutter build appbundle --release ``` 2. **数字签名** ```bash # Windows signtool sign /f certificate.pfx /p password build/windows/x64/runner/Release/erp.exe # Android jarsigner -keystore erp-release.keystore build/app/outputs/flutter-apk/app-release.apk erp ``` 3. **上传到 CDN** ```bash scp build/windows/x64/runner/Release/erp.exe user@cdn.serkol.cn:/erp/downloads/windows/ scp build/app/outputs/flutter-apk/app-release.apk user@cdn.serkol.cn:/erp/downloads/android/ ``` 4. **更新 appcast.xml** - 更新版本信息 - 更新下载链接 - 更新发布说明 5. **发布** - 更新官方网站 - 发布更新公告 - 通知用户 ## 文档 ### 项目文档 - [AUTO_UPDATE_TEST_PLAN.md](AUTO_UPDATE_TEST_PLAN.md) - 自动更新测试计划 - [QUALITY_ASSURANCE_REPORT.md](QUALITY_ASSURANCE_REPORT.md) - 质量保证评估报告 - [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) - 部署指南 - [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) - 项目总结 ### 外部文档 - [Flutter 官方文档](https://flutter.dev/docs) - [Dart 编程语言](https://dart.dev/guides) - [GetX 状态管理](https://github.com/jonataslaw/getx) ## 常见问题 ### Q: 如何启用自动更新检查? A: 在更新设置页面启用"启用自动检查更新"选项，应用将每24小时自动检查一次更新。 ### Q: 如何手动检查更新? A: 在更新检查页面点击"手动检查更新"按钮即可。 ### Q: 下载失败怎么办? A: 请检查网络连接，然后重试。如果问题持续，请联系技术支持。 ### Q: 支持哪些平台? A: 目前支持 Windows 7/8/10/11、Android 5.0+ 和 macOS 10.14+。iOS 支持正在开发中。 ### Q: 如何回滚到旧版本? A: 当前版本不支持自动回滚。如需回滚，请联系技术支持。 ## 技术支持 如有任何问题或建议，请联系: - 项目负责人: [联系方式] - 技术支持: [联系方式] - 质量保证: [联系方式] ## 许可证 本项目采用 [许可证名称] 许可证。详见 [LICENSE](LICENSE) 文件。 ## 更新日志 ### 1.0.6 (2026-02-25) - ✅ 实现完整的自动更新功能 - ✅ 支持跨平台更新 (Windows, Android, macOS) - ✅ 创建 Windows 和 Android 安装包 - ✅ 编写完整的测试计划 - ✅ 进行全面的质量保证评估 - ✅ 编写详细的部署指南 ## 贡献 欢迎贡献代码、报告问题或提出建议。请遵循以下步骤: 1. Fork 本项目 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 开启 Pull Request ## 致谢 感谢所有为本项目做出贡献的开发者和用户。 --- **ERP System 1.0.6** - 跨平台自动更新解决方案 **发布日期**: 2026-02-25 **版本**: 1.0.6 **评分**: 8.73/10 (优秀)