Notes-master/SETUP_GUIDE.md

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：

# 进入项目目录
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论坛讨论