|
|
# 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
|
