Leviidev/Husk

项目介绍

Husk 的目标是让 Android 应用和游戏跑在 iPhone 上。它的主要路径是翻译层：游戏自身的 64 位 Android 代码直接在设备上运行，Husk 在外围提供 Android 兼容的 C 库、Java、GL、Vulkan、音频和输入接口。由于不需要启动完整 Android 系统，游戏可以在数秒内进入。翻译层无法运行的应用，则回退到 QEMU 下的完整 LineageOS 虚拟机。iOS 17.4 及以上还支持加载伪造的 PS4 包和游戏文件夹。

它适合希望不借助 Android 设备玩 Android 游戏的 iPhone 用户，也适合愿意从源码构建 IPA 的开发者。兼容性因应用而异，具体标题能否运行应先查看兼容性列表。

安装

Husk 要求 iOS 15.5 或更高版本。预期安装方式是用 SideStore、AltStore 或 TrollStore 侧载。在 SideStore 或 AltStore 中打开 Sources 并添加：

https://itslevii.dev/repo.json

该源同时列出 AetherPS4、Utsuro、Podium 和 Fathom 等配套项目。也可以从 Releases 下载 Husk.ipa 后直接侧载。完整步骤见安装文档。

安装完成后，添加 APK 并点击即可全屏启动。游戏需要 JIT，可通过 JIT 配置或无 JIT 运行流程解决；后者需要先导入安装 Husk 时使用的证书。

从源码构建

构建需要一台装有 Xcode 的 Mac，以及 meson、ninja、pkg-config、python3、xcodegen、qemu-img，和带 aarch64-apple-ios target 的 Rust 工具链。在仓库根目录运行：

./scripts/ci_build.sh

产物为 build/Husk.ipa。后续仅重新打包应用时，运行 ./scripts/package_ipa.sh，输出到 ~/Desktop/Husk.ipa。

使用约束与许可

侧载和 JIT 是 iOS 平台带来的限制，并非可选项：没有 JIT，或没有走无 JIT 证书方案，Android 游戏无法运行。项目使用 GPL-2.0-or-later 许可；由于 Husk 链接了 GPLv2 的 QEMU，分发出去的二进制被视为 GPLv2 组合作品，不能上架 App Store，具体理由见许可文档。

二进制通过第三方源和 GitHub Releases 分发，而非 App Store，用户应将其视为未签名的侧载产物，安装前核对来源与项目的关系。

HotRepo 点评

在 2026-11-12 记录的 Java 语言月榜中，Husk 为 3,242 星、240 fork，当月新增 1,803 星，最好名次为第 10。目前只有这一条月榜快照，它能说明该周期内的榜单位置较强，但不足以判断增长的持续性或留存。考虑到这是一个围绕 JVM 与 C 组件构建的 iOS 模拟/翻译应用，Java 榜的位置更多反映其工具链的一部分，而非用户构成。对关注 iOS 跨平台游戏兼容性的人来说值得观察，但兼容性差异和只能侧载这两点，直接决定了它是否适合具体用户。