HackiOS: Android ハードウェアでの iOS 16.5 実行プロジェクト

HackiOS は、Android 製スマートフォンのハードウェア上で Apple のオープンソース XNU カーネル（バージョン xnu-8796.121.2、iOS 16.5）を実行し、その上に 未変更の iOS 16.5 ユーザーランドを動作させる研究プロジェクトです。

プロジェクト概要

このシステムを実現するために利用されている主要コンポーネントは以下の通りです：

• 自作 EFI ローダー: ブートプロセスを担う。
• 閉鎖的ドライバーの代替品: Apple 公式ドライバーに代わる実装。
• UEFI ポート: システム起動環境の移植版。
• Linux Wi-Fi ドライバー: 互換性レイヤー上で動作するネットワークスタック。

システムは以下の 2 つの環境で動作します：

• POCO X5 Pro 5G (redwood, Snapdragon 778G)
  • フラッシュ（書き込み）作業は一切不要。
  • UEFI は

    fastboot boot

    コマンドで起動され、システム全体は RAM 上で動作します。
  • リブート後、スマートフォンは Android に戻ります。
• QEMU (virt, aarch64)
  • Linux コンピュータ上での動作であり、実際のスマートフォンは必要ありません。

リポジトリ構成

本プロジェクトは以下の 2 つのリポジトリで構成されます：

init

⚠️ 免責事項: どちらのリポジトリにも Apple ファイルは含まれていません。

ios165/fetch.sh

により、iOS 16.5 の IPSW が Apple の自 CDN からダウンロードされ、必要な要素があなたのマシン上で抽出されます。
HackiOS は OOSEX GANG による独立した研究プロジェクトであり、Apple Inc. との関連性はありません。承認・推奨も行っておりません。

動作状況一覧

hackios-xnu-userland/docs/air.md

cpus=8

gpu=1

var_store=1

ufs_write=1

dpkg

apt

⚠️ 研究用ベンチマーク: 本システムは ROM ではありません。セッションは特定の時間だけ続き、その後カーネルはローダーに戻り、ログを渡します。

素早く始める：QEMU（カーネルビルド不要）

prebuilt/

環境要件

• OS: Linux x86-64
• 空きディスク: 約 12GB
• 空き RAM: 4GB

インストール（パッケージ）

Arch Linux:

sudo pacman -S --needed git python 7zip lz4 gcc qemu-system-aarch64 qemu-ui-gtk edk2-aarch64

Debian/Ubuntu:

sudo apt install git python3 7zip liblz4-dev gcc qemu-system-arm qemu-efi-aarch64

📝 注意: 7-Zip はバージョン 23 以上である必要があります（APFS の読み込みに必須）。

クイックスタート手順

# リポジトリクローン
git clone https://github.com/oosexgang/hackios-xnu-kernel.git hackios
cd hackios

# セットアップ (hackios-xnu-userland を同一ツリーに持ち込み、ホスト環境を確認)
common/setup.sh

# ダウンロードと抽出 (Apple の CDN から 7.4GB, 約 5〜15 分)
ios165/fetch.sh

# APFS イメージビルド (ツールチェーンがあればカーネルもビルド)
common/build.sh qemu-virt

# QEMU ウィンドウ内でのセッション開始 (約 20 分間)
common/run.sh qemu-virt

🕒 動作確認: ロック画面は起動後 2〜3 分で表示されます。

オペレーションガイド

マウス操作:

• 左ボタン押し込み: フィンガー（タップ）
• 解除・アプリ退出: 画面最下縁から上スワイプ
• 戻る: 画面左端から右へスワイプ

キーボード割り当て:

H

L

↑ / ↓

F11

スクリプトからの操作:

# スワイプ (x=0.5, y=0.985, ...)
./qemu/touch.py swipe 0.5 0.985 0.5 0.3 250

# タップ
./qemu/touch.py tap 0.615 0.71

# キー入力
./qemu/touch.py key home

# スクリーンショット
./qemu/screendump.sh shot.png

⏳ 重要: SpringBoard が表示された直後はシステムがアプリを登録し続けています。30〜40 秒待つ必要があります。

Debian/Ubuntu UEFI ファームウェア: 起動スクリプトに以下の環境変数を追加してください：

QEMU_EFI=/usr/share/AAVMF/AAVMF_CODE.fd QEMU_VARS=/usr/share/AAVMF/AAVMF_VARS.fd

スマートフォン上での動作 (POCO X5 Pro 5G)

**POCO X5 Pro 5G (redwood)**の場合、ブートローダがロックされていない状態、adb と fastboot、および上記のイメージが必要です。ストレージへの書き込みは行われず、ファームウェア自体もリポジトリには含まれません。

ファームウェア抽出

以下のコマンドを実行して、GPU、Wi-Fi、サウンド用のファームウェアをワークスペースに移動します：

# GPU (gpu=1)
adb pull /vendor/firmware/a660_{gmu.bin,sqe.fw,zap.mdt,zap.b00,zap.b01,zap.b02} fw-gpu/

# Wi-Fi (wifi=1)
adb pull /vendor/firmware_mnt/image/wpss.{mdt,b02,b03,b04,b05,b06,b07} fw-wifi/

# サウンド (adsp=1)
adb pull /vendor/firmware_mnt/image/adsp.{mdt,b02,...,b36} fw-audio/

# ハプティクス
adb pull /vendor/firmware/aw8697_haptic.bin fw-haptic/

📝 Wi-Fi の場合:

fw-wifi/mac

(ラジオアドレス) と

fw-wifi/network

(SSID/PW) も必要です。

userland/build.sh

が使用したファームウェアを表示します。

システム起動

方法 1: イメージビルドを使用

# イメージビルド (GL=1 は GPU アクセラレーションを有効化)
common/build.sh redwood GL=1

# セッション開始 (ローダーとシステムイメージを RAM に読み込み、約 15 分間のセッション)
common/run.sh redwood 900

方法 2: xl ツールを使用（段階的な実行）

./xl enter                  # Android -> fastboot -> RAM 上のローダー (fastboot boot); USB リンク確立
./xl ramdisk                # システムイメージを RAM にアップロード (約 2.5GB, 80 秒)

# メインセッション実行
XL_SECS=900 \
XL_CMDLINE="touchscreen=1 cpufreq=1 bootcpu=7 cpus=8 gpu=1 wifi=1 adsp=1" \
./xl run

./xl screenshot shot.png    # スクリーンショット
./xl reboot                 # Android にリブート

📝

./xl

に引数を指定しない場合は、ログや録画、カメラフレーム停止などのすべてのコマンドを一覧表示します。

プリビルトのブートイメージ

リリース版には

hackios-redwood-boot.img

fastboot boot

ソースからビルド

# 指定したデバイス向けにすべてをビルド
common/build.sh <device>

構成要素のビルド詳細

• カーネル:

  ~/theos

  (

  cctools

  ,

  iPhoneOS16.5.sdk

  ) および clang, lld が必要。

  cd xnu
  ./apply.sh && cd ../xnu-deps && ./setup.sh && cd ..
  ./xnu-build.sh -j8 -k
  

• ローダー:

  xnuloader/build.sh

  (clang + lld-link、EDK2 不使用)。
• イメージ:

  REST=1 userland/build.sh

  （変数はファイル上部に定義）。
• UEFI:

  uefi/README.md

  (Project Silicium ポート)。ビルド済みは

  prebuilt/uefi

  。

他のデバイスへの移植

common/new-device.sh <codename> path/to/device.dtb

その後、

docs/PORTING.md

仕組みとアーキテクチャ

システム起動フローは以下の通りです：

graph TD
    Fastboot[fastboot boot] --> UEFI[UEFI (Mu-Silicium)]
    UEFI --> Loader[xnuloader (EFI アプリケーション)]
    
    subgraph XNU Components
        direction TB
        GICv3[GICv3]
        Timer[タイマー]
        Console[ビデオコンソール]
        APFS[APFS (RAM 上のイメージ、フラッシュ上の iOS ボリューム)]
        Ramfs[Ramfs (/private/var, /tmp)]
        Crypto[minicrypto の使用 (corecrypto 代替)]
        AMFI[AMFI とサンドボックスの代替品 (MAC ポリシー)]
        Drivers[ドライバー代替品: IOSurface, IOMobileFramebuffer...]
        Input[/dev/redwood-touch ← Goodix GT9916 / virtio-input]
        GPU[GPU: Adreno 642L]
        WiFi[Wi-Fi: WCN6750 (ath11k via LinuxKPI)]
        Sound[サウンド: ADSP / virtio-sound]
    end
    
    UEFI --> XNU[XNU (BCM2837 構成ベース + プラットフォーム対応)]
    
    XNU --> GICv3
    XNU --> Timer
    XNU --> Console
    XNU --> APFS
    XNU --> Ramfs
    XNU --> Crypto
    XNU --> AMFI
    XNU --> Drivers
    XNU --> Input
    XNU --> GPU
    XNU --> WiFi
    XNU --> Sound
    
    XNU --> iOSApps[iOS 16.5 launchd → logd, notifyd... → SpringBoard]
    
    subgraph Injection Points
        direction TB
        Libraries[我々のライブラリ: backboardd, SpringBoard...]
        HID[(仮想 HID サービス)]
        ObjC[(ObjC メソッド交換 — メモリ上のみ)]
        Audio[(mediaserverd への CoreAudio 出力: RedwoodAudio.driver)]
    end
    
    iOSApps --> Libraries
    Libraries --> HID
    Libraries --> ObjC
    Libraries --> Audio

💡 重要: iOS のプログラム、フレームワーク、dyld シェアドキャッシュはバイト単位に変更されていません。不足している機能は **カーネル（ドライバー代替品）**か、

DYLD_INSERT_LIBRARIES

で注入するライブラリ (

kern.exec_inject

) によって補完されています。

ディレクトリ構成

common/

xl/

xnuloader/

xnu/

xnu-deps/

xnu-build.sh

uefi/

wifi/lx/

qemu/

tools/

prebuilt/

docs/

デバッグとスクリーンショット

ログの確認:

• セッションログ: QEMU の stdout または

  logs/HHMMSS-run.log

  (スマートフォンから)。
• userabort: ログに

  abort()

  を呼んだプロセスのスタックが表示されます。
• usertrap: (

  systrace=1

  ) クラッシュ時の診断用。
• ライブスタック (QEMU):

  qemu/touch.py stacks NAME

  ->

  qemu/symstack.py LOG NAME

  (IPSW の必要あり)。

チェック項目: チェックが嘘をつく場合は

docs/checks.md

スクリーンショット取得: スマートフォンの画面からのセッションでは、以下の環境変数が必要です：

• GL=1

  (GPU アクセラレーション)

• REST=1

  (必要なリソースを確保)

• gpu=1

ライセンス情報

本リポジトリ全体は Apple Public Source License 2.0 でライセンスされています。

• 我々のコード: XNU の派生作品（APSL 2.0）およびローダー、スクリプトも同ライセンス。
• サードパーティのコード:

  • xnu/

    : APSL 2.0
  • ath11k: BSD-3-Clause-Clear
  • FreeBSD LinuxKPI: BSD-2-Clause
  • libzbitmap (libdeflate): MIT / Corellium LLC
  • mkbootimg.py: Apache-2.0 (AOSP)
  • UEFI ドライバー: Project Silicium の配布方法に従う。

チーム（OOSEX GANG）

• @oodze (創設者)
• @netusd, @wannqn, @hxfuxyyXD

最新情報: t.me/oosexgangdevs