# MiCode Notes - 设置指南

## 🚀 快速开始

### 方法一：在Android Studio中直接打开（推荐）

1. **启动Android Studio**
   - 打开Android Studio
   - 选择 "Open an existing Android Studio project"
   - 浏览到项目根目录 `Notes-master`
   - 点击 "OK"

2. **等待Gradle同步**
   - Android Studio会自动检测到这是一个Gradle项目
   - 等待Gradle同步完成（首次可能需要几分钟）
   - 如果提示下载Gradle，点击"OK"

3. **构建项目**
   - 在Android Studio中点击 "Build" → "Make Project"
   - 或使用快捷键 `Ctrl+F9` (Windows) / `Cmd+F9` (Mac)

### 方法二：使用命令行（如果有Gradle）

如果您的系统已安装Gradle：

```bash
# 进入项目目录
cd Notes-master

# 构建项目
gradle build

# 或者安装到设备
gradle installDebug
```

## 🔧 故障排除

### 问题1：Gradle同步失败
**解决方案：**
1. 检查网络连接
2. 在Android Studio中：File → Settings → Build → Gradle
3. 确保使用 "Gradle Wrapper" 选项
4. 如果Gradle Wrapper有问题，Android Studio会自动下载

### 问题2：找不到Android SDK
**解决方案：**
1. 在Android Studio中：File → Settings → Appearance & Behavior → System Settings → Android SDK
2. 确保已安装 Android API 33
3. 设置正确的SDK路径

### 问题3：编译错误
**解决方案：**
1. 清理项目：Build → Clean Project
2. 重新构建：Build → Rebuild Project
3. 如果仍有问题，删除 `.gradle` 文件夹并重新同步

### 问题4：android:exported错误
**已修复：** AndroidManifest.xml中所有组件都已添加正确的android:exported属性

## 📱 运行应用

1. **连接设备或启动模拟器**
   - 连接Android设备并启用USB调试
   - 或在Android Studio中启动AVD模拟器

2. **运行应用**
   - 点击绿色的"Run"按钮
   - 或使用快捷键 `Shift+F10`

## 📋 项目要求

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

## 🎯 项目结构

```
Notes-master/
├── app/                    # 主应用模块
│   ├── src/main/
│   │   ├── java/          # Java源代码
│   │   ├── res/           # 资源文件
│   │   └── AndroidManifest.xml
│   └── build.gradle       # 应用构建配置
├── build.gradle           # 项目构建配置
├── settings.gradle        # 项目设置
└── gradle.properties      # Gradle属性
```

## ✅ 验证安装

项目成功设置后，您应该能够：
- 在Android Studio中看到项目结构
- 成功编译项目（无错误）
- 在设备/模拟器上运行应用
- 看到便签应用的主界面

## 🆘 获取帮助

如果遇到问题：
1. 查看Android Studio的"Build"窗口中的错误信息
2. 检查"Event Log"中的警告和建议
3. 确保所有必需的SDK组件已安装
4. 尝试"File → Invalidate Caches and Restart"

## 📞 支持

- **GitHub Issues**: 报告bug和问题
- **文档**: 查看项目README.md
- **社区**: MiCode论坛讨论