Metallib支援包

Metallib支援包

與修補 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. 修補.metallib檔案以支援 Metal 3802 GPU。
6. 將目錄轉換為 macOS 分發包 (PKG)。

有關修補各.metallib檔案的注意事項：

1. 每個.metallib檔案其實是.air檔案的集合。需要使用周偉的格式來提取它們。
   • 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.