# MiCode Notes - 小米便签

![MiCode Notes](app/src/main/res/drawable-xxhdpi/icon_app.png)

## 项目介绍

MiCode Notes 是小米便签的社区开源版，由MIUI团队(www.miui.com)发起并贡献第一批代码，遵循Apache 2.0开源协议。这是一个功能完善的Android便签应用，支持文本笔记、清单、提醒和桌面小部件等功能。

## 功能特点

- **多种笔记类型**：支持普通文本笔记和清单（待办事项）模式
- **文件夹管理**：可以创建文件夹对笔记进行分类管理
- **提醒功能**：支持为笔记设置时间提醒
- **桌面小部件**：提供2x和4x大小的桌面小部件，方便快速查看和创建笔记
- **搜索功能**：支持全文搜索笔记内容
- **Google账户同步**：支持与Google Tasks同步
- **便签分享**：支持分享笔记内容到其他应用
- **多种背景颜色**：支持为笔记设置不同的背景颜色

## 技术架构

### 项目结构
```
app/src/main/java/net/micode/notes/
├── data/        # 数据层，包含ContentProvider和数据库相关代码
├── gtask/       # Google Tasks同步功能
├── model/       # 数据模型
├── tool/        # 工具类
├── ui/          # 用户界面
└── widget/      # 桌面小部件
```

### 主要组件

- **数据存储**：使用SQLite数据库通过ContentProvider提供数据访问
- **UI**：基于传统Android视图系统构建，遵循Material Design设计风格
- **后台服务**：用于提醒和同步功能
- **小部件**：实现了AppWidgetProvider用于桌面小部件

## 系统要求

- Android 5.0 (API 21) 或更高版本
- 支持Android 14 (API 34)

## 开发环境

- Android Studio Iguana或更高版本
- JDK 17
- Gradle 8.6.0或更高版本

## 构建与安装

### 从源码构建

1. 克隆仓库
```bash
git clone https://github.com/MiCode/Notes.git
```

2. 使用Android Studio打开项目

3. 构建并运行
```bash
./gradlew build
```

4. 安装到设备
```bash
./gradlew installDebug
```

### 直接安装

你也可以直接下载最新的APK文件进行安装。

## 使用方法

### 创建笔记

1. 点击主界面右下角的"+"按钮创建新笔记
2. 输入笔记内容
3. 点击返回按钮自动保存

### 创建清单

1. 创建新笔记后，点击菜单中的"模式"选项
2. 选择"清单"模式
3. 添加清单项目并可勾选完成状态

### 设置提醒

1. 打开笔记编辑界面
2. 点击菜单中的"提醒"选项
3. 设置提醒时间

### 使用小部件

1. 长按主屏幕空白处
2. 选择"小部件"
3. 找到"米便签"并选择2x或4x大小
4. 放置到桌面上

## 贡献指南

欢迎为MiCode Notes贡献代码或提出建议：

1. 提交Bug和功能请求：
   - 访问[GitHub Issues](https://github.com/MiCode/Notes/issues)

2. 参与讨论：
   - 访问[MiCode论坛](http://micode.net/forum.php?mod=forumdisplay&fid=38)

3. 提交代码：
   - Fork仓库
   - 创建功能分支
   - 提交变更
   - 创建Pull Request

## 许可证

本项目采用[Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0)开源许可证。详情请参阅项目中的NOTICE文件。

## 联系方式

- GitHub项目：https://github.com/MiCode/Notes
- MiCode社区：http://www.micode.net