企业官网建设流程全解析

如何自己构建ZalithLauncher2？Android Studio + Gradle开发环境搭建完全指南

【免费下载链接】ZalithLauncher2A Minecraft: Java Edition Launcher for Android项目地址: https://gitcode.com/gh_mirrors/za/ZalithLauncher2

ZalithLauncher2（Zalith Launcher 2）是一款面向Android 设备的Minecraft: Java Edition 启动器，采用 Jetpack Compose 与 Material Design 3 打造现代化界面。想自己编译、修改或打包这个启动器吗？本指南带你用Android Studio + Gradle从零搭建完整的Android 开发环境，几分钟内即可完成第一次构建。

一、环境要求清单

在开始之前，先对照下表准备你的开发环境 🛠️：

💡 项目使用 Gradle 版本目录（Version Catalog）统一管理依赖版本，所有版本号都集中在 gradle/libs.versions.toml 中，比如 Kotlin 2.4.20、AGP 9.3.0、Compose BOM 等，升级依赖时改这一个文件即可。

二、获取项目源码

使用 Git 克隆仓库到本地（需要已安装 Git）：

git clone https://gitcode.com/gh_mirrors/za/ZalithLauncher2

克隆完成后进入目录，你会看到清晰的模块划分（详见 settings.gradle.kts）：

• ZalithLauncher：主应用模块（UI、游戏逻辑、JNI 原生代码都在这里）
• LWJGL：LWJGL 3.3.3 / 3.4.1 适配模块，用于在 Android 上运行 Java 版 Minecraft
• LayerController：手柄按键自定义面板
• ColorPicker、CardGrid、Guide、InputMap、Terracotta：各功能组件库

三、Android Studio 中打开项目并完成 Sync

1. 打开 Android Studio，选择File → Open，选中项目根目录；
2. 首次打开会提示配置 SDK，点击Finish或按提示在SDK Manager中安装缺少的组件；
3. 等待右上角的Gradle Sync进度条完成——第一次 Sync 会下载 Gradle 9.5.0、Kotlin、KSP、Hilt 等插件与全部依赖，耗时较长属正常现象；
4. Sync 成功后，左侧 Project 面板即可看到各模块结构。

项目级的 JVM 内存已配置为 4 GB（见 gradle.properties 中的org.gradle.jvmargs），如果你的机器内存充足，可以适当调大以加快构建。

四、了解关键构建配置

构建前花一分钟了解几个关键文件，遇到问题时可快速定位：

• ZalithLauncher/build.gradle.kts：应用构建脚本。定义了签名配置、ABI 拆分、NDK 编译路径（src/main/jni/Android.mk）以及 Compose 等构建特性；
• ZalithLauncher/gradle.properties：启动器名称、版本号，以及可选的 OAuth / CurseForge 密钥占位项；
• README.md：项目说明文档，其中"构建方式"章节对开发者最友好。

几个值得注意的配置：

五、一键构建：生成你的第一个 APK

环境就绪后，构建非常简单：

1. 连接你的 Android 设备（开启 USB 调试）或启动模拟器；
2. 点击工具栏🐞 Run（或按Shift + F10）；

或者使用命令行构建 Debug 包：

./gradlew :ZalithLauncher:assembleDebug

构建产物位于ZalithLauncher/build/outputs/apk/debug/目录，按 build.gradle.kts 中的命名规则，APK 文件名形如ZalithLauncher-Debug-x.x.x.apk，可直接安装到设备上运行。

六、进阶构建参数

构建脚本提供了不少"隐藏旋钮"，按需使用即可：

• 按架构瘦身打包：通过arch参数只编译指定架构（arm/arm64/x86/x86_64），脚本会自动清理其他架构的 JRE 与 LWJGL 原生库，显著减小 APK 体积，例如：

  ./gradlew :ZalithLauncher:assembleRelease -Darch=arm64

• 自定义应用名称：修改 ZalithLauncher/gradle.properties 中的launcher_app_name，重新构建即可（GPLv3 附加条款要求修改版需注明"非官方修改版"）；

• Release 签名：正式签名密码从环境变量STORE_PASSWORD/KEY_PASSWORD（或根目录下的.store_password.txt/.key_password.txt文件）读取；

• 第三方 API 密钥：OAuth 客户端 ID、CurseForge API Key 均为可选，未设置时相关功能降级但不影响编译。

七、常见问题速查（FAQ）

Q1：Gradle Sync 失败？确认 Android Studio 版本较新（AGP 9.x 要求新版 Android Studio），并在 SDK Manager 中确认 API 37 平台已安装；仍失败可查看gradlew :ZalithLauncher:assembleDebug --stacktrace的完整日志。

Q2：NDK 编译报错？SDK Manager 中安装NDK (Side by side) 25.2.9519653，或在 SDK Tools 中勾选对应版本后重试。

Q3：构建慢 / 内存不足？适当调大 gradle.properties 中的org.gradle.jvmargs，并确保网络良好以便下载依赖。

总结

到这里，你的ZalithLauncher2 构建环境已完全就绪：克隆源码 → Android Studio 打开并 Sync → Run 即可安装到设备。后续无论是修改 UI、调整启动逻辑，还是研究 LWJGL 适配层 如何让 Minecraft 跑在手机上，都可以在这套环境里自由探索。祝构建顺利 🚀

【免费下载链接】ZalithLauncher2A Minecraft: Java Edition Launcher for Android项目地址: https://gitcode.com/gh_mirrors/za/ZalithLauncher2