# todo

**Repository Path**: xiaochenbian/todo

## Basic Information

- **Project Name**: todo
- **Description**: todo 任务管理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-05
- **Last Updated**: 2026-09-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Todo 工具（cl-todo-app）

基于 **四象限（艾森豪威尔矩阵）** 的 Android 待办应用，支持 **桌面小组件** 与 App 内管理。可在桌面直接添加任务、勾选完成、查看子任务，并自定义小组件样式。

## 功能概览

### 桌面小组件
- 添加 Todo / Idea（底部贴键盘输入条，全宽多行）
- 列表可上下滑动浏览
- 展示四象限标签、子任务、创建日期（`MMDD`）
- 勾选完成 / 取消完成（已完成可显示删除线）
- 进入 App、样式配置（文字色、背景色、透明度、是否显示已完成 / 子任务）
- 圆角半透明背景，添加 / 编辑后自动刷新

### App 内
- 与小组件一致的 Todo / Idea 排版
- 编辑任务标题、四象限、子任务（编辑后更新 `updatedAt`；列表时间展示创建时间）
- 顶部「已完成」开关，与小组件配置同步
- 已完成任务删除线展示

### 四象限
| 象限 | 含义 |
|------|------|
| I | 重要且紧急 |
| II | 重要不紧急 |
| III | 不重要紧急 |
| IV | 不重要不紧急 |

任务按优先级 I → II → III → IV 排序。

## 技术栈

| 项 | 说明 |
|----|------|
| 语言 | Kotlin |
| UI | Jetpack Compose（App）+ RemoteViews（小组件） |
| 存储 | Room（Todo / Idea / SubTask） |
| 最低 SDK | 26 |
| 目标 SDK | 34 |
| 包名 | `com.todoapp` |

## 项目结构

```
cl-todo-app/
├── app/src/main/
│   ├── java/com/todoapp/
│   │   ├── data/          # Room 实体与 DAO
│   │   ├── ui/            # Compose 主界面、添加/编辑、样式配置
│   │   ├── widget/        # 小组件 Provider / ListView Service / 样式
│   │   └── util/          # 展示格式化
│   ├── res/layout/        # 小组件与底部输入条布局
│   └── AndroidManifest.xml
├── build.gradle.kts
└── settings.gradle.kts
```

## 环境要求

- Android Studio Hedgehog 或更新版本（推荐）
- JDK 17
- Android SDK 34

## 构建与运行

1. 用 Android Studio 打开 `cl-todo-app` 目录  
2. 等待 Gradle Sync 完成  
3. 连接设备或启动模拟器  
4. Run `app`

命令行（需本机已配置 SDK，且存在 `local.properties`）：

```bash
# Windows 示例
java -classpath gradle/wrapper/gradle-wrapper.jar org.gradle.wrapper.GradleWrapperMain :app:assembleDebug
```

Debug APK 输出路径：

```
app/build/outputs/apk/debug/app-debug.apk
```

## 使用说明

1. 安装 App 后，长按桌面 → 添加「Todo 工具」小组件  
2. 点 **+** 添加任务（可选四象限与子任务）  
3. 点灯泡图标添加 Idea  
4. 点房子图标进入 App；点竖三点进入样式配置  
5. 升级或更换小组件实现后，建议 **删除再重新添加** 小组件  

## 远程仓库

```
https://gitee.com/xiaochenbian/todo.git
```

## License

个人项目，可按需自行约定使用方式。