# moneytracker

**Repository Path**: winterhai/moneytracker

## Basic Information

- **Project Name**: moneytracker
- **Description**: 记账
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-11
- **Last Updated**: 2026-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 日常记账 (MoneyTracker)

一个简洁纯粹的 Android 离线记账 App：记录每天的收支明细，掌握自己的钱花在了哪里。

**全程离线运行，无广告、无需注册、不联网，数据保存在手机本地。**

## 功能特性

| 模块 | 说明 |
|---|---|
| 明细 | 所有账目列表，支持按 类型 / 分类 / 日期 / 关键词 筛选 |
| 记一笔 | 输入金额、选择分类、填写备注，一键保存 |
| 统计 | 按日 / 月 / 年查看收支汇总与结余 |
| 排行榜 | 分类支出排行、单笔最大支出一目了然 |
| 分类管理 | 自定义支出 / 收入分类，软删除不丢历史数据 |
| 关于 | 应用版本信息 |

## 技术栈

- **语言**：Kotlin
- **UI**：Jetpack Compose + Material 3
- **架构**：MVVM + Repository，单 Activity
- **数据库**：Room（KSP 编译期处理）
- **导航**：Navigation Compose
- **异步**：Coroutines + Flow

## 环境要求

| 项 | 版本 |
|---|---|
| Android Studio | 最新稳定版 |
| JDK | 17（Android Studio 自带 JBR 即可） |
| compileSdk / targetSdk | 35 (Android 15) |
| minSdk | 26 (Android 8.0)，覆盖绝大多数设备 |

## 构建运行

1. 克隆仓库：

   ```bash
   git clone https://gitee.com/winterhai/moneytracker.git
   ```

2. 用 Android Studio 打开项目根目录，等待 Gradle Sync 完成
3. 点击 Run（绿色三角）即可安装到模拟器或真机

命令行打包 APK：

```bash
./gradlew assembleRelease
```

## 项目结构

```
app/src/main/java/com/ldh/moneytracker/
├── MainActivity.kt          # 唯一的 Activity（单 Activity 架构）
├── data/                    # 数据层：Room 实体、DAO、数据库、仓库
├── ui/
│   ├── navigation/          # 导航图
│   ├── screens/             # 各功能页面
│   ├── theme/               # 主题（颜色、字体）
│   └── common/              # 通用组件
├── viewmodel/               # ViewModel 层
└── util/                    # 工具类（金额格式化、日期处理）
```

## 相关文档

- [开发教程.md](开发教程.md) —— 本项目的完整开发过程实录：环境搭建 → 项目结构 → 技术栈 → 编码实现 → 踩坑排查 → 打包安装，适合零基础入门。

## 许可证

详见 [LICENSE](LICENSE)。