MetallibSupportPkg

MetallibSupportPkg

macOS での Metal ライブラリ ( .metallib ) のパッチ適用に関連するユーティリティのコレクション。特に、レガシー ハードウェア (つまり、macOS Sequoia 上の Metal 3802 ベースの GPU) のサポートを回復することを目的としています。

論理

MetallibSupportPkg には、 metal_libraries Python ライブラリが含まれています。これは、以下を通じて Metal ライブラリのパッチ適用を合理化するために開発されました。

1. 最新の macOS Sequoia IPSW をプログラムで取得します。
2. IPSW からシステム ボリューム DMG を抽出します。
3. ディスク イメージが AEA 暗号化されている場合は、 aastuff使用して復号化します。
4. ディスク イメージをマウントし、サポートされているすべての.metallibファイルを抽出します。
5. Metal 3802 GPU をサポートするために.metallibファイルにパッチを適用します。
6. ディレクトリを macOS 配布パッケージ (PKG) に変換します。

個々の.metallibファイルにパッチを適用する場合の注意事項:

1. 各.metallibファイルは、実際には.airファイルのコレクションです。 zhouwei の形式を使用して抽出する必要があります。
   • metallib/patch.py​​: _unpack_metallib_to_air()
2. 特定の.metallibファイルは、実際には FAT Mach-O ファイルです。したがって、手動で薄くする必要があります (Apple のlipoユーティリティは、必要な AIR64 アーキテクチャをサポートしていません)。
   • metallib/patch.py​​: _thin_file()
3. 次に、Apple のmetal-objdumpユーティリティを使用して、 .airファイルを.ll (LLVM IR) に逆コンパイルする必要があります。
   • metallib/patch.py​​: _decompile_air_to_ll()
4. LLVM IR を使用すると、AIR バージョンの v26 (Sequoia の v27 と比較) やその他の必要な変更のパッチ適用を開始できます。
   • metallib/patch.py​​: _patch_ll()
5. IR を.airにコンパイルするには、Apple のmetalユーティリティを使用します。
   • metallib/patch.py​​: _recompile_ll_to_air()
6. 各.airを.metallibコレクションにパックするには、Apple のmetallibユーティリティを使用します。
   • metallib/patch.py​​: _pack_air_to_metallib()

完了すると、結果の.metallibファイルは macOS Sequoia の Metal 3802 ベースの GPU で動作するはずです。

使用法

MetallibSupportPkg は一般ユーザーによる使用を意図していません。以下は開発者向けです。

必要な依存関係をインストールします。

python3 -m pip install -r requirements.txt
# Note Xcode is required to be installed for the `metal` and `metal-objdump` utilities

IPSW URL を取得します。

python3 metallib.py -d
# Example result: UniversalMac_15.0_24A5279h_Restore.ipsw

IPSW からシステム ボリュームを抽出します。

python3 metallib.py -e < path_to_ipsw >
# Example result: 090-49684-056.dmg

システム ボリュームから Metal ライブラリをフェッチし、 15.x-に抽出します。

python3 metallib.py -f < path_to_system_volume >
# Example result: 15.0-24A5279h

パッチメタルライブラリ:

 # Directory containing the Metal libraries
python3 metallib.py -p < path_to_metallib_dir >
# Individual Metal library
python3 metallib.py -p < path_to_metallib >

Metal ライブラリを macOS パッケージに変換します。

python3 metallib.py -z < path_to_metallib_dir >
# Example result: MetallibSupportPkg-15.0-24A5279h.pkg 

---

 usage: metallib.py [-h] [-d] [-e EXTRACT] [-f FETCH] [-p PATCH] [-b BUILD_SYS_PATCH] [-z BUILD_PKG] [-c]

Download, extract, fetch, and patch Metal libraries.

options:
  -h, --help            show this help message and exit
  -d, --download        Download the latest IPSW.
  -e EXTRACT, --extract EXTRACT
                        Extract the system volume from an IPSW.
  -f FETCH, --fetch FETCH
                        Fetch Metal libraries from the system volume.
  -p PATCH, --patch PATCH
                        Patch Metal libraries.
  -b BUILD_SYS_PATCH, --build-sys-patch BUILD_SYS_PATCH
                        Build a system patch dictionary.
  -z BUILD_PKG, --build-pkg BUILD_PKG
                        Build a macOS package.
  -c, --continuous-integration
                        Run in continuous integration mode.