MiCode Notes - 小米便签

项目介绍

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. 克隆仓库

git clone https://github.com/MiCode/Notes.git

2. 使用Android Studio打开项目

3. 构建并运行

./gradlew build

4. 安装到设备

./gradlew installDebug

直接安装

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

使用方法

创建笔记

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

创建清单

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

设置提醒

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

使用小部件

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

贡献指南

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

1. 提交Bug和功能请求：

   • 访问GitHub Issues

2. 参与讨论：

   • 访问MiCode论坛

3. 提交代码：

   • Fork仓库
   • 创建功能分支
   • 提交变更
   • 创建Pull Request

许可证

本项目采用Apache License 2.0开源许可证。详情请参阅项目中的NOTICE文件。

联系方式

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