2.6 KiB
2.6 KiB
AutoTime Tracker - 快速启动指南
🚀 立即运行
1. 安装依赖
flutter pub get
2. 运行项目
Windows 用户（推荐）
方式 1：使用运行脚本（最简单）
# 双击运行 运行.bat 或在 PowerShell 中运行
.\运行.ps1
方式 2：直接运行命令
# Windows 桌面应用
flutter run -d windows
# Web 服务器模式（推荐，兼容性最好）
flutter run -d web-server
# 运行后会显示 URL，在浏览器中打开即可
# Edge 浏览器
flutter run -d edge
Mac/Linux 用户
# iOS 模拟器
flutter run -d ios
# Android 模拟器/设备
flutter run -d android
# 或指定设备
flutter devices # 查看可用设备
flutter run -d <device-id>
启动 Android 模拟器（无需 Android Studio）
# 1. 查看可用模拟器
flutter emulators
# 2. 启动模拟器
flutter emulators --launch <emulator-id>
# 3. 运行应用
flutter run
提示： 如果还没有模拟器，可以使用 Android Studio 创建，或者使用物理设备（启用 USB 调试后直接 flutter run）。
📱 界面说明
主界面（Today）
- 总时长显示：大字体显示今日总使用时长
- 效率评分：基于时间分配的效率评分（0-100%）
- 分类饼图：可视化展示各分类时间分布
- Top 应用：显示今日使用时间最长的 5 个应用
统计界面（Stats）
- 时间趋势图：折线图展示每日总时长趋势
- 分类对比图：堆叠柱状图对比各分类时间
- 应用详情：查看每个应用的详细使用数据
设置界面（Settings）
- 应用分类管理：管理应用分类规则
- 时间目标设定：设置每日时间目标
- 数据与隐私：数据管理、导出、删除
- 升级到 Pro：查看高级功能
🐛 常见问题
Q: 运行报错 "No devices found"
A: 确保已启动模拟器或连接设备
# iOS
open -a Simulator
# Android
flutter emulators --launch <emulator-id>
Q: 依赖安装失败
A: 检查网络连接，或使用国内镜像
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
flutter pub get
Q: 图表不显示
A: 确保已安装 fl_chart 依赖
flutter pub get
flutter clean
flutter pub get
📚 相关文档
- README.md - 项目概览
- 开发进度.md - 开发进度和待办事项
- 真实数据测试指南.md - 真实设备测试说明