在 iPhone 和 iPad 上运行 Minecraft Java 版的完整指南：PojavLauncher iOS 启动器教程-迪斯科星球

在 iPhone 和 iPad 上运行 Minecraft Java 版的完整指南：PojavLauncher iOS 启动器教程

【免费下载链接】PojavLauncher_iOSA Minecraft: Java Edition Launcher for Android and iOS based on Boardwalk. Succeeded by https://github.com/AngelAuraMC/Amethyst-iOS项目地址: https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS

PojavLauncher iOS 是一款基于 Boardwalk 开发的 Minecraft Java 版启动器，可在 iPhone、iPad 上运行从早期 beta 到最新快照的几乎全部 Java 版游戏，适合想用手头 Apple 设备玩 Minecraft Java 版、安装 Forge/Fabric 模组的玩家。

解决什么问题

Minecraft Java 版没有 iOS 客户端，官方只在 Windows、macOS 和 Linux 上提供。在 iOS 上跑游戏要跨过两道坎：一是设备上没有 Java 运行环境，二是 App Store 不允许通过侧载安装带完整能力的第三方应用。PojavLauncher iOS 把这两件事一次性解决：应用内自带 iOS 平台的 JRE 和游戏运行环境，配合 TrollStore、AltStore、SideStore 等侧载方式安装后，即可在设备上登录、下载并启动 Java 版游戏。

需要说明的是：该项目已停止维护，README 中明确后继项目为 Amethyst-iOS。如果你正在寻找长期维护的替代方案，可以关注它；本文仍完整覆盖 PojavLauncher 的安装与用法。

一分钟看懂它怎么工作

把 PojavLauncher 想象成一个"自带的电脑"：

安装包里内置了 3 套移植到 iOS 的 Java 运行环境（Java 8、17、21，打包逻辑见根目录 Makefile），不同年代的游戏版本对应不同 JRE，游戏启动时按需选用；
Java 侧的启动器代码（核心入口：JavaApp/src/launcher/）负责读取版本信息、解析库依赖、拼出启动命令并拉起游戏；
图形部分，游戏原本通过 OpenGL 输出画面，iOS 没有桌面 OpenGL，于是项目用 GL4ES、MetalANGLE、MoltenVK 等组件把 OpenGL / Vulkan 调用翻译成 iOS 原生图形 API（源码位于 Natives/ctxbridges/）。

还有一个关键点：JIT（即时编译）。Java 程序直接解释执行会很慢，必须开启 JIT 才能达到可用帧率，而 iOS 只允许被调试中的应用使用 JIT，所以需要借助 TrollStore、调试证书等方式"打开"它——这也是安装方式选择的核心考量，下文会展开。

快速开始

前置条件

设备（iOS 14.0 及以上）：
- 最低支持：iPhone 6s 及以后、iPad 第 5 代及以后、iPad Air 第 2 代及以后、iPad mini 第 4 代及以后、iPad Pro 全型号、iPod touch 第 7 代；
- 官方推荐：iPhone XS 及以后（不含 iPhone XR 和 iPhone SE 第 2 代）、iPad 第 10 代及以后、iPad Air 第 4 代及以后、iPad mini 第 6 代及以后、iPad Pro 全部型号（9.7 英寸除外）。
至少一种可用的侧载安装方式（TrollStore / AltStore / SideStore / 越狱，见下文）。
若使用 iOS 17.x 或 18.x：需要一台电脑，并正确配置 Python 3.11 与 pymobiledevice3（用于开启 JIT）。

最快路径：TrollStore 安装（永久签名）

如果你的 iOS 版本在 TrollStore 支持范围内，这是最省事的方式：应用被永久签名、自动启用 JIT，且内存上限更高。

从项目 Releases 页面下载 PojavLauncher 的 IPA 文件；
通过系统分享菜单把 IPA 发送给 TrollStore 并打开，即完成安装；
启动后登录账号、选择版本即可进入游戏，无需额外开启 JIT。

特殊情况：iOS/iPadOS 17.0 无法直接走 TrollStore，README 建议使用 TrollRestore 降级/恢复方案（17.0 以上版本不支持该方案）。

备选方案一：AltStore / SideStore 侧载

适合无法使用 TrollStore 的设备：

在设备上安装 AltStore（需在本机网络内运行电脑的 AltServer）或 SideStore；
在 Trusted Sources 菜单中添加PojavLauncher Repository；
点击FREE开始安装。

注意：这类方式签发的证书有有效期，到期后需要重新刷新；JIT 的开启方式取决于你用的是 AltStore 还是 SideStore，详见后文对比表。另外，不使用 UDID、走分发证书的签名服务不被支持，PojavLauncher 需要这些能力之外的权限（调试挂载 entitlement）。

备选方案二：从源码自行构建

如果你想要定制版本（比如换 TeamID 重新签名），可以克隆仓库https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS后构建。Linux/macOS 上需要 cmake、JDK 8、ldid、wget、lld（Linux）以及 iPhoneOS 14.0 或更新的 SDK（通过SDKPATH变量指定），常用目标如下：

make all：完整构建整包
make java：只编译 Java 部分
make jre：下载并解压 iOS JRE
make package：打包出 IPA

核心功能详解

版本选择：从 beta 到最新快照

一句话效果：几乎全部 Java 版版本都可选，老版本怀旧和新版本尝鲜都可以。

启动器从官方渠道拉取版本列表并逐版本安装。启动时 Java 侧入口PojavLauncher.launchMinecraft()会读取所选版本的元数据、加载对应 JRE 和库文件后拉起游戏，源码在 JavaApp/src/launcher/net/kdt/pojavlaunch/PojavLauncher.java。多套 JRE 的意义就在这里：1.12 及更早版本走 Java 8 运行时，1.18+ 的新版本走 Java 17 运行时。

模组与整合包安装：Forge、Fabric、OptiFine、Quilt

一句话效果：主流模组加载器都受支持，还能直接装整合包。

Forge 与 Fabric 有独立的安装向导，入口分别在 Natives/installer/ForgeInstallViewController.m 和 Natives/installer/FabricInstallViewController.m；
整合包安装支持 CurseForge 和 Modrinth 两个来源，API 封装在 Natives/installer/modpack/。

输入方式：虚拟按键、手柄与键鼠

一句话效果：触屏虚拟摇杆、外接手柄、蓝牙键盘鼠标都能用。

游戏手柄：基于系统 GameController 框架实现，即插即用，源码见 Natives/input/ControllerInput.m；
自定义屏幕控制：可自由摆放虚拟摇杆、方向键、按钮，工具代码在 Natives/customcontrols/CustomControlsUtils.m，编辑器入口在 Natives/CustomControlsViewController.m；
键盘：键位映射表见 Natives/glfw_keycodes.h，游戏内按键走 GLFW 通道。

登录方式：微软账号与离线试玩

一句话效果：有正版可以登 Microsoft 账号，没有也可以先用离线/试玩模式进入游戏。

认证模块位于 Natives/authenticator/，包含 Microsoft 账号登录（MicrosoftAuthenticator.m）与本地账号（LocalAuthenticator.m）两套实现，启动时按所选手法向 Java 侧提供凭据。

进阶与调优

JIT 开启方式对比

这是 iOS 上最重要的调优项。不同安装方式对 JIT 的支持差异如下（来自项目 README）：

安装方式	需要外部设备	需要 Wi-Fi	自动启用 JIT
AltStore	是	是	是（需本机网络内运行 AltServer）
SideStore	否	是	否
TrollStore	否	否	是
Jitterbug	VPN 不可用时需要	是	否
越狱	否	否	是

结论：追求省心选 TrollStore；只有 AltStore 可用时记得保持 AltServer 在线；越狱设备同样能自动开 JIT，但官方不推荐日常使用。

运行时与内存

JRE 选择：设置中提供运行时管理页面（Natives/LauncherPrefManageJREViewController.m），可以查看 Java 8 / 17 等内置运行时、指定默认运行时或移除额外运行时，选错 JRE 是部分版本闪退的常见原因。
内存上限：TrollStore 与越狱环境可以放宽内存上限；侧载证书签名受系统限制，内存分配要保守。
默认性能设置：启动器在游戏首次启动时会写入一组偏保守的默认值（渲染距离 2、模拟距离 5、粒子效果调低等，见PojavLauncher.java中MCOptionUtils.setDefault），之后可在游戏内按需调高。

故障排查

现象：游戏速度极慢、像幻灯片。可能原因：JIT 未生效，CPU 仍在解释执行 Java 字节码。处理：对照上表确认你安装方式的 JIT 状态，AltStore 用户检查 AltServer 是否在线，SideStore 用户按对应方式手动启用；TrollStore 安装理论上无需处理。
现象：安装后应用消失或打不开。可能原因：侧载证书到期（约 7 天），应用被系统回收。处理：重新刷新签名，或改用 TrollStore/越狱获得永久签名。
现象：某游戏版本闪退。可能原因：该版本需要的 JRE 缺失或选错（旧版本依赖 Java 8，1.18+ 依赖 Java 17）。处理：在运行时管理页确认对应 JRE 存在并设为默认。
现象：iOS 17.x / 18.x 上装好但起不来。可能原因：这两个大版本没有自动 JIT 通道，必须走电脑辅助方案。处理：按要求配置 Python 3.11 与 pymobiledevice3，按官方 Wiki 的方法开启 JIT。
现象：模组装完进游戏报错或无法加载。可能原因：模组版本与游戏版本、加载器版本不匹配。处理：核对 Forge/Fabric 版本号与游戏版本对应关系，重新下载整合包。
现象：签名安装时被拒绝。可能原因：使用了分发证书类签名服务，缺少 PojavLauncher 必需的能力。处理：改用 TrollStore、AltStore、SideStore 或开发证书（开发证书自带调试挂载 entitlement，可开 JIT）。

总结与资源

PojavLauncher iOS 证明了 Minecraft Java 版在 iPhone/iPad 上完整可玩：全版本覆盖、Forge/Fabric/OptiFine/Quilt 模组支持、多种输入方式和登录方式。记住两件事：安装方式决定 JIT 与签名寿命，TrollStore 是目前体验最完整的方案；项目已停止维护，后续需求请看继任者 Amethyst-iOS。

常用入口：

安装与故障排除文档：官方 Wiki（项目 README 的 Getting started 一节有说明）
构建脚本：Makefile（版本 3.0）
Java 启动核心：JavaApp/src/launcher/net/kdt/pojavlaunch/
iOS 原生层：Natives/
签名配置：entitlements.trollstore.xml、entitlements.sideload.xml

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析