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.