想自己编译 NekoAnime：构建环境与步骤指南
开源应用的一项特权：不满足于官方安装包的话，你可以自己从源码编译——装最新开发分支的代码、改点自己的小定制、或者纯粹为了学习这个项目的架构。这一页整理仓库公布的构建要求与实操路径。
官方公布的构建环境
README 里明确列了三项，它们不是随手写的，是仓库实际运行的配置：
| 项目 | 要求 | 说明 |
|---|---|---|
| IDE | Android Studio Koala（2024.1.1 Patch 2） | 官方安卓 IDE，装这个版本或更新的 |
| 编译目标 | compileSdk 35 | 对应 Android 15 的 SDK |
| JDK | Gradle JDK 17 | Java 开发工具包 17，Java 8/11 不行 |
环境准备的标准路径：装 Android Studio → 在 IDE 内的 SDK Manager 里确认装了 compileSdk 35 对应的 SDK Platform → 在项目设置里把 Gradle JDK 指到 17。三者齐了，构建环境就绪。
拿代码与构建步骤
- 克隆仓库：源码托管在 GitHub 的 xioneko/neko-anime 仓库，git clone 或直接下载源码压缩包都行；
- 分支选择：main 是主干，最新的开发代码在 dev 分支（README 原话：「最新的代码可在 dev 分支上查看」）——想尝鲜未发布的功能切 dev，想编译和发布版一致的代码用 main 对应 tag；
- 用 Android Studio 打开项目：IDE 会自动完成 Gradle 同步（首次同步要下载依赖，需要顺畅的网络）；
- 连设备运行：插上开了 USB 调试的安卓手机，或启动模拟器，点运行即可安装到设备。
自己编译能干什么
- 体验开发分支：官方发布以月计，dev 分支的修复可能早就进去了——等不及就自己编；
- 本地化定制：改改主题、调调默认设置之类的个人化修改，编译出独一无二的版本；
- 学习项目本身：它是「现代安卓架构」的完整实例——三层分离、Compose UI、离线优先数据层（技术细节见技术栈一览），边跑边读源码是最高效的学习路径。
三个提醒
- 自编译版本没有官方签名：与官方发布的 APK 签名不同，覆盖安装官方版会冲突——测试机单独装，或先卸载官方版（卸载丢数据，老规矩）；
- 别分发闭源魔改版：GPL-3.0 要求衍生版本同样开源（见开源属性），这是协议红线；
- 数据源相关代码要谨慎改动：源站解析逻辑与版本强耦合，随手改动可能引发 v0.5.2 那类播放故障——看不懂的部分先别动。
编译遇到环境问题，优先看仓库 Issues 区——构建类的坑前辈们基本都踩过，反馈方法见问题反馈。