Leviidev/Husk

选用指南

AI 根据 README 整理 · 2026/10/14 20:45:36

使用方式

通过添加 APK 或拆分包（如 .xapk、.apkm）到应用库中，点击即可全屏运行，支持备份和恢复游戏存档。

查看 README 依据

Add an APK, tap it, and it opens full-screen. Husk runs it in one of two ways, shown as the two sides of its Library: - **Translation Layer.** The game's own 64-bit Android code runs directly on the iPhone's processor, and Husk stands in for Android around it: the C library, the Java calls the game makes, OpenGL ES (through ANGLE), Vulkan (through MoltenVK), sound, touch and controllers. No Android boots, so a game starts in seconds, and its code is never emulated. See [docs/04-translation-layer.md](docs/04-translation-layer.md).

split bundles (`.xapk`, `.apkm`, `.apks`, or a Play download's separate split APKs and asset packs) can all be added. Apps written only in Java, with no native engine, are not supported on the translation layer; Emulation is the way to run those. One game runs per launch of Husk. To switch, press **Close Husk to Play** on the other game's page; when you open Husk again, that game starts by itself. A game's saves can be backed up to a `.zip` from its page and restored later, on the same iPhone or another. If a game crashes Husk, the next launch shows

部署要求

需要 iOS 16.0 或更高版本，且必须通过 SideStore、AltStore 或 TrollStore 等侧载方式安装。

查看 README 依据

what happened, with a report you can share. ## Installing **SideStore, AltStore and other sideloaders:** add Husk's source, and the sideloader installs Husk and offers each update as it comes out. ``` https://raw.githubusercontent.com/Leviidev/Husk/main/altsource.json ``` In SideStore or AltStore: Sources › + › paste the address above. **Or by hand:** download `Husk.ipa` from [Releases](https://github.com/leviidev/husk/releases) and install it with SideStore, AltStore or TrollStore. It is one IPA for all of them: it carries

Husk's entitlements, which TrollStore keeps, and a sideloader re-signs it with your own. Husk needs iOS 16.0 or later. ## JIT Both the translation layer and Emulation need JIT, which on iOS comes from a debugger. Husk can get it in several ways, and walks you through each one (Settings › JIT & Sideload): - **Built-in StikJIT** (iOS 26 and later): Husk turns JIT on itself, with no second app. On iOS 27 it pairs with your iPhone from Settings, with no computer. See [docs/06-built-in-jit.md](docs/06-built-in-jit.md). - **StikDebug**, installed alongside Husk.

已知限制

翻译层仅支持 64 位（arm64-v8a）原生代码的 APK，纯 Java 应用不支持；模拟方式速度较慢。每次启动只能运行一个游戏。

查看 README 依据

- **Emulation.** A full Android system (LineageOS) boots under QEMU inside Husk, for apps the translation layer cannot run yet and for using Android itself. iOS gives apps no hypervisor, so the processor is emulated, and this is much slower than the translation layer. See [docs/00-architecture.md](docs/00-architecture.md). ## Screenshots ### Games on the Translation Layer <table> <tr> <td align="center"><img src="Screenshots/gta-san-andreas.jpeg" alt="GTA: San Andreas" width="100%"><br>_{<b>GTA: San Andreas</b>}</td>

- Godot 3 and 4 (GLES2, GLES3 and the Compatibility renderer) - SDL2 and SDL3, including LÖVE games - GameActivity (Minecraft) and NativeActivity - Rockstar's own engine (GTA: San Andreas) Games see Google Play services as installed and signed out, so the ones that check for it start normally; Play Games sign-in, cloud saves and purchases are not available. Geometry Dash can load [Geode](https://geode-sdk.org) mods. An APK needs 64-bit (`arm64-v8a`) native code. iPhones cannot run 32-bit ARM code, so an APK that only has 32-bit libraries cannot run here. APKs and

split bundles (`.xapk`, `.apkm`, `.apks`, or a Play download's separate split APKs and asset packs) can all be added. Apps written only in Java, with no native engine, are not supported on the translation layer; Emulation is the way to run those. One game runs per launch of Husk. To switch, press **Close Husk to Play** on the other game's page; when you open Husk again, that game starts by itself. A game's saves can be backed up to a `.zip` from its page and restored later, on the same iPhone or another. If a game crashes Husk, the next launch shows