117 lines
2.6 KiB
Markdown
117 lines
2.6 KiB
Markdown
# AutoTime Tracker - 快速启动指南
|
||
|
||
## 🚀 立即运行
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
flutter pub get
|
||
```
|
||
|
||
### 2. 运行项目
|
||
|
||
#### Windows 用户（推荐）
|
||
|
||
**方式 1：使用运行脚本（最简单）**
|
||
```bash
|
||
# 双击运行 运行.bat 或在 PowerShell 中运行
|
||
.\运行.ps1
|
||
```
|
||
|
||
**方式 2：直接运行命令**
|
||
```bash
|
||
# Windows 桌面应用
|
||
flutter run -d windows
|
||
|
||
# Web 服务器模式（推荐，兼容性最好）
|
||
flutter run -d web-server
|
||
# 运行后会显示 URL，在浏览器中打开即可
|
||
|
||
# Edge 浏览器
|
||
flutter run -d edge
|
||
```
|
||
|
||
#### Mac/Linux 用户
|
||
|
||
```bash
|
||
# iOS 模拟器
|
||
flutter run -d ios
|
||
|
||
# Android 模拟器/设备
|
||
flutter run -d android
|
||
|
||
# 或指定设备
|
||
flutter devices # 查看可用设备
|
||
flutter run -d <device-id>
|
||
```
|
||
|
||
#### 启动 Android 模拟器（无需 Android Studio）
|
||
|
||
```bash
|
||
# 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:** 确保已启动模拟器或连接设备
|
||
```bash
|
||
# iOS
|
||
open -a Simulator
|
||
|
||
# Android
|
||
flutter emulators --launch <emulator-id>
|
||
```
|
||
|
||
### Q: 依赖安装失败
|
||
**A:** 检查网络连接，或使用国内镜像
|
||
```bash
|
||
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 依赖
|
||
```bash
|
||
flutter pub get
|
||
flutter clean
|
||
flutter pub get
|
||
```
|
||
|
||
## 📚 相关文档
|
||
|
||
- [README.md](./README.md) - 项目概览
|
||
- [开发进度.md](./开发进度.md) - 开发进度和待办事项
|
||
- [真实数据测试指南.md](./真实数据测试指南.md) - 真实设备测试说明
|
||
|