# MiCode Notes - Modern Android Version

## 📱 项目简介

这是小米便签(MiCode Notes)的现代化版本，已从原始的Eclipse ADT项目迁移到现代的Android Studio Gradle构建系统。

## 🔄 迁移说明

### 原始项目问题
- 使用Eclipse ADT项目结构
- 基于非常老的Android API (minSdkVersion 14)
- 缺少现代Android项目必需的构建配置
- 无法在最新版Android Studio中正常运行

### 迁移改进
- ✅ 转换为标准Gradle项目结构
- ✅ 更新到现代Android API (minSdk 21, targetSdk 34)
- ✅ 添加Material Design支持
- ✅ 修复已废弃的API调用
- ✅ 添加现代Android构建配置
- ✅ 支持AndroidX库

## 🏗️ 项目结构

```
MiCode-Notes/
├── app/                          # 主应用模块
│   ├── src/main/
│   │   ├── java/                 # Java源代码
│   │   ├── res/                  # 资源文件
│   │   └── AndroidManifest.xml   # 应用清单
│   ├── build.gradle              # 模块构建配置
│   └── proguard-rules.pro        # ProGuard规则
├── gradle/                       # Gradle Wrapper
├── build.gradle                  # 项目构建配置
├── settings.gradle               # 项目设置
└── gradle.properties             # Gradle属性
```

## 🛠️ 构建要求

- **Android Studio**: Arctic Fox (2020.3.1) 或更高版本
- **Gradle**: 8.2
- **Android Gradle Plugin**: 8.2.0
- **Java**: JDK 8 或更高版本
- **Android SDK**: API 34

## 🚀 快速开始

### 1. 克隆项目
```bash
git clone <repository-url>
cd Notes-master
```

### 2. 在Android Studio中打开
1. 启动Android Studio
2. 选择 "Open an existing Android Studio project"
3. 选择项目根目录
4. 等待Gradle同步完成

### 3. 构建项目
```bash
./gradlew build
```

### 4. 运行应用
```bash
./gradlew installDebug
```

## 📋 主要功能

- 📝 便签创建、编辑、删除
- 📁 文件夹管理和分类
- 🔍 便签搜索功能
- ⏰ 提醒功能
- 🔄 Google Task同步
- 🏠 桌面小部件 (2x2, 4x4)
- 📤 文本导出功能
- 🎨 多种背景颜色

## 🔧 技术栈

- **语言**: Java
- **架构**: MVC
- **数据库**: SQLite
- **UI框架**: Material Design Components
- **同步**: Google Tasks API
- **构建工具**: Gradle

## 📱 兼容性

- **最低支持**: Android 5.0 (API 21)
- **目标版本**: Android 14 (API 34)
- **架构支持**: ARM, ARM64, x86, x86_64

## 🐛 已知问题

1. **Google同步功能暂时禁用** - 为了确保项目能正常编译运行，暂时禁用了Google Tasks同步功能
2. 部分UI可能需要进一步适配Material Design
3. 某些老旧设备可能存在兼容性问题

## ⚠️ 当前状态

- ✅ **核心功能正常** - 便签创建、编辑、删除、搜索等功能完全可用
- ✅ **现代化构建** - 使用最新的Gradle和Android构建工具
- ⚠️ **同步功能禁用** - Google Tasks同步功能暂时禁用，可在后续版本中重新启用
- ✅ **桌面小部件** - 2x2和4x4桌面小部件功能正常

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 开源协议

本项目遵循 Apache License 2.0 协议。详见 [NOTICE](NOTICE) 文件。

## 🙏 致谢

- 原始项目由 MIUI 团队发起
- 现由 MiCode 社区维护
- 感谢所有贡献者的努力

## 📞 支持

- **Bug反馈**: [GitHub Issues](https://github.com/MiCode/Notes/issues)
- **功能建议**: [MiCode论坛](http://micode.net/forum.php?mod=forumdisplay&fid=38)
- **文档**: 查看项目Wiki