如何自己构建ZalithLauncher2Android Studio Gradle开发环境搭建完全指南【免费下载链接】ZalithLauncher2A Minecraft: Java Edition Launcher for Android项目地址: https://gitcode.com/gh_mirrors/za/ZalithLauncher2ZalithLauncher2Zalith Launcher 2是一款面向Android 设备的Minecraft: Java Edition 启动器采用 Jetpack Compose 与 Material Design 3 打造现代化界面。想自己编译、修改或打包这个启动器吗本指南带你用Android Studio Gradle从零搭建完整的Android 开发环境几分钟内即可完成第一次构建。一、环境要求清单在开始之前先对照下表准备你的开发环境 ️组件版本要求说明Android StudioBumblebee 或更高版本建议直接安装最新版Hedgehog 及以上JDK17 及以上Android Studio 自带 JBR一般无需单独安装Android SDK编译 API 37 / 目标 API 34首次打开项目时 SDK Manager 会自动提示下载NDK25.2.9519653项目含 JNI 原生代码构建时自动拉取Gradle9.5.0由 Wrapper 自动管理无需手动安装见 gradle/wrapper/gradle-wrapper.properties磁盘空间建议预留 15 GB 以上首次 Sync 会下载大量依赖 项目使用 Gradle 版本目录Version Catalog统一管理依赖版本所有版本号都集中在 gradle/libs.versions.toml 中比如 Kotlin 2.4.20、AGP 9.3.0、Compose BOM 等升级依赖时改这一个文件即可。二、获取项目源码使用 Git 克隆仓库到本地需要已安装 Gitgit clone https://gitcode.com/gh_mirrors/za/ZalithLauncher2克隆完成后进入目录你会看到清晰的模块划分详见 settings.gradle.ktsZalithLauncher主应用模块UI、游戏逻辑、JNI 原生代码都在这里LWJGLLWJGL 3.3.3 / 3.4.1 适配模块用于在 Android 上运行 Java 版 MinecraftLayerController手柄按键自定义面板ColorPicker、CardGrid、Guide、InputMap、Terracotta各功能组件库三、Android Studio 中打开项目并完成 Sync打开 Android Studio选择File → Open选中项目根目录首次打开会提示配置 SDK点击Finish或按提示在SDK Manager中安装缺少的组件等待右上角的Gradle Sync进度条完成——第一次 Sync 会下载 Gradle 9.5.0、Kotlin、KSP、Hilt 等插件与全部依赖耗时较长属正常现象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项目说明文档其中构建方式章节对开发者最友好。几个值得注意的配置配置项值含义minSdk26Android 8.0最低支持的系统版本targetSdk34目标系统 API签名配置releaseBuild / debugBuildDebug 包使用内置调试签名开箱即用Java 兼容性17构建需 JDK 17五、一键构建生成你的第一个 APK环境就绪后构建非常简单连接你的 Android 设备开启 USB 调试或启动模拟器点击工具栏 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 -Darcharm64自定义应用名称修改 ZalithLauncher/gradle.properties 中的launcher_app_name重新构建即可GPLv3 附加条款要求修改版需注明非官方修改版Release 签名正式签名密码从环境变量STORE_PASSWORD/KEY_PASSWORD或根目录下的.store_password.txt/.key_password.txt文件读取第三方 API 密钥OAuth 客户端 ID、CurseForge API Key 均为可选未设置时相关功能降级但不影响编译。七、常见问题速查FAQQ1Gradle Sync 失败确认 Android Studio 版本较新AGP 9.x 要求新版 Android Studio并在 SDK Manager 中确认 API 37 平台已安装仍失败可查看gradlew :ZalithLauncher:assembleDebug --stacktrace的完整日志。Q2NDK 编译报错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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
