원문 Leviidev/Husk 저장소 메타(2026-10-10 gh api 확인): GPL-2.0, 주 언어 C, 2026-09-12 생성, Stars 약 1,100, 최신 릴리스 1.1.0(2026-10-09).

한 줄 요약

APK를 넣고 누르면 iPhone에서 전체 화면으로 열린다. Husk는 두 방식으로 Android 앱을 돌린다. 게임의 64비트 네이티브 코드를 iPhone CPU에서 그대로 실행하고 주변의 Android만 흉내 내는 번역 계층, 그리고 QEMU 위에서 LineageOS 전체를 부팅하는 에뮬레이션이다.

두 가지 실행 방식

번역 계층(Translation Layer)에뮬레이션(Emulation)
방식게임의 arm64 코드를 직접 실행하고, C 라이브러리·Java 호출·그래픽·사운드·입력만 Husk가 대신 제공QEMU로 LineageOS 전체를 부팅, CPU까지 에뮬레이션
그래픽OpenGL ES는 ANGLE, Vulkan은 MoltenVK로 Metal에 연결virglrenderer
속도Android가 부팅되지 않아 수 초 만에 시작iOS가 하이퍼바이저를 주지 않아 훨씬 느림
대상지원 엔진으로 만든 게임번역 계층이 아직 못 돌리는 앱, Android 자체 사용

번역 계층이 지원하는 엔진은 Unity, Unreal Engine 4(Vulkan), cocos2d-x, Godot 3·4, SDL2·SDL3(LÖVE 포함), GameActivity(Minecraft)·NativeActivity, GTA: San Andreas의 Rockstar 엔진이다.

제약

  • APK에 64비트(arm64-v8a) 네이티브 코드가 있어야 한다. iPhone은 32비트 ARM 코드를 못 돌린다. 네이티브 엔진 없이 Java로만 된 앱은 번역 계층에서 안 되고 에뮬레이션으로 돌려야 한다.
  • 게임에는 Google Play 서비스가 “설치됨, 로그아웃 상태”로 보인다. Play 게임 로그인·클라우드 저장·결제는 안 된다.
  • 한 번 실행에 게임 하나만 돈다. 바꾸려면 Husk를 닫고 다시 열어야 한다.
  • 두 방식 모두 JIT가 필요하다. iOS에서 JIT는 디버거가 붙어야 얻는다. iOS 26 이상은 내장 StikJIT, StikDebug, iOS 26 미만은 TrollStore·Dopamine 탈옥으로 얻는다.
  • iOS 16.0 이상. SideStore·AltStore 소스(altsource.json)나 TrollStore로 설치한다.

App Store에 못 올라가는 이유

Husk는 GPLv2인 QEMU를 링크하므로 배포 바이너리 전체가 GPLv2 결합 저작물이 되고, 전체 소스를 공개한다. 게다가 get-task-allow 권한과 런타임 디버거 부착이 필요하다. 이 두 가지 때문에 App Store 배포는 불가능하다고 README가 밝힌다.

빌드

Mac과 Xcode에서 ./scripts/ci_build.sh 하나로 QEMU, ANGLE, virglrenderer, MoltenVK, 온디바이스 페어링 라이브러리를 교차 컴파일하고 build/Husk.ipa를 만든다. 첫 빌드는 두어 시간 걸린다. tools/regress/run.sh는 Mac에서 번역 계층으로 게임을 돌려 기준 스크린샷과 비교하는 회귀 테스트다.

Husk 3.0 — PS4 게임 지원 (2026-10-18)

@qwerty__cs가 전한 3.0 업데이트 내용이다(중국어 소개 글, 저장소 릴리스 노트로 재확인 필요).

  • PS4: PKG 가져오기와 일괄 설치, 이미 풀어 둔 게임 디렉터리를 지원한다. 게임 업데이트와 셰이더 캐시도 지원.
  • Android: 공식 발표 기준 실행 가능한 게임이 366개 늘었다. Godot 4, OBB 리소스 다운로드, 키보드 입력 지원 추가.
  • 기타: 홈 화면과 게임 라이브러리를 새로 만들고 TrollStore JIT를 다듬었다.
  • 개발자가 시험한 PS4 게임은 《블러드본》, 《마인크래프트 PS4판》, 《소닉 매니아》. 《블러드본》은 실행은 되지만 성능이 아직 매우 나쁘다.
  • 설치는 여전히 IPA 사이드로드 + JIT 활성화가 필요하며 AltStore·SideStore·TrollStore를 지원한다.

관련