开发者自行构建 — 从源码编译 APK

构建前置条件

从 Gloom 源码编译 APK 需要三个工具：

工具	最低版本	安装方式
Git	2.x	git-scm.com/downloads 或系统包管理器
JDK	11	Oracle JDK 或 OpenJDK（推荐 11，Gloom 可能还没升到 17）
Android SDK	—	跟着 Android Studio 一起装最省事

推荐直接装 Android Studio（developer.android.com/studio）——它会自动装 SDK + 合适的 JDK + Gradle 版本，省去手动装一堆东西的麻烦。

git clone https://github.com/MateriiApps/Gloom.git
cd Gloom

最简单的方式，直接在 Android Studio 里点「运行」按钮（或菜单栏 Build → Build Bundle(s) / APK(s) → Build APK(s)）。

也可以命令行构建：

.\gradlew assembleDebug

构建产物位置：

app\build\outputs\apk\debug\gloom-debug.apk

两种方式：

Release 构建需要 signing keystore（签名密钥），Android Studio 里可以生成：

MateriiApps 官方 release 包的 keystore 不在仓库里（安全原因），你自己构建的 release 包和官方 release 包签名不同，不能互相覆盖升级。

源码构建的好处是你可以自定义 Gloom：

Gloom 的启动图标定义在 app/src/main/res/ 目录下的 mipmap-*dpi 文件夹里。把你自己的图标 PNG 按各分辨率尺寸放进去替换，重新构建就行。

Gloom 默认从系统取 Material You 动态色，但你也可以在 Theme.kt 里写死一套配色覆盖（不推荐，会失去 Material You 的意义）。

源码结构：

建议阅读 MateriiApps 仓库 README 和 CONTRIBUTING.md 了解代码结构。

最常见的原因：

JDK 版本不对：Android Studio 设置 → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK 选 11
Android SDK 版本缺失：Android Studio → SDK Manager 安装所有可用的 SDK Platform（至少 Android 12+）
网络下载慢/断：Gradle 需要从 Google Maven 仓库下载依赖，网络慢时容易超时。配置代理或换网络

Kotlin 版本报错 → Android Studio 会提示推荐的 Kotlin 版本，按提示更新 Gradle 插件版本
Compose 版本冲突 → 确保 Gradle 插件版本和 Compose Compiler 版本匹配（MateriiApps 的 build.gradle 里已固定好，别乱改）
API Level 报错 → build.gradle 里的 compileSdk 和 minSdk 需要对应你安装的 SDK 版本