小米便签源码部署流程

一、准备环境
1. 安装必要工具
Android Studio：最新稳定版（需支持 Kotlin 和 Jetpack Compose）。
JDK：建议 JDK 11 或更高（通过 sdkman 或 brew 安装）。
Git：用于克隆源码。
2. 配置国内镜像源（可选但推荐）
加速依赖下载：

Gradle：在 ~/.gradle/gradle.properties 中添加

 二、获取源码

（1）Git 环境准备
1. 安装 Git
Windows：
下载并运行 Git for Windows 安装程序。

（2）获取小米便签源码
1. 确认源码仓库地址
小米便签若开源，通常会托管在 GitHub、GitLab 或码云等平台。仓库地址为：
https://github.com/xiaomi/mi-note.git

2.克隆仓库

3.查看仓库信息

 4.切换分支（若有多个分支）

 

 三、项目配置与编译
1. 打开项目
启动 Android Studio，选择 Open an Existing Project，定位到源码根目录（含 build.gradle 文件）。
2. 解决依赖问题
现象：Gradle 同步失败，提示缺少库（如 implementation 'androidx.activity:activity-compose:1.++'）。
解决方法：等待 Android Studio 自动下载依赖（需科学上网或配置镜像源）。
手动更新 build.gradle（项目级和模块级）中的依赖版本为最新兼容版本。
3. 配置签名文件（可选）
若需编译正式版 APK，需在 app/build.gradle 中配置签名：

 四、编译与运行
1. 选择设备或模拟器
连接 Android 手机（需开启开发者模式和 USB 调试），或在 Android Studio 中创建模拟器（建议 API 30+）。
2. 编译并运行
点击 Android Studio 工具栏中的 Run 'app' 按钮（绿色箭头），等待 Gradle 构建完成并安装 APK。
常见错误：错误 1：Execution failed for task ':app:compileDebugKotlin'
原因：Kotlin 版本不兼容。
解决：在 build.gradle（模块级）中统一 Kotlin 版本：

错误 2：Manifest merger failed
原因：AndroidManifest.xml 冲突（如权限重复）。
解决：检查主清单文件与模块清单的权限、Activity 声明是否冲突，移除重复项。

五、调试与二次开发
1. 断点调试
在代码中设置断点，通过 Android Studio 的调试工具（如 Logcat、Variables 面板）追踪逻辑。
示例：调试笔记保存功能时，在 NoteRepository.kt 的 saveNote() 方法中设置断点，观察数据库操作。
2. 修改代码并重新运行
直接修改源码（如修改 UI 布局 activity_main.xml），点击 Apply Changes（热重载）或重新编译运行。