|
|
# 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论坛讨论
|
