MetallibSupportPkg

MetallibSupportPkg

Eine Sammlung von Dienstprogrammen zum Patchen von Metal-Bibliotheken ( .metallib ) in macOS, insbesondere mit dem Ziel, die Unterstützung für ältere Hardware (nämlich Metal 3802-basierte GPUs unter macOS Sequoia) wiederherzustellen.

Logik

MetallibSupportPkg beherbergt die Python-Bibliothek metal_libraries , die entwickelt wurde, um das Patchen von Metal Library wie folgt zu optimieren:

1. Programmgesteuertes Abrufen des neuesten macOS Sequoia IPSW.
2. Extrahieren Sie das System-Volume-DMG aus dem IPSW.
3. Wenn das Disk-Image AEA-verschlüsselt ist, entschlüsseln Sie es mit aastuff .
4. Mounten Sie das Disk-Image und extrahieren Sie alle unterstützten .metallib Dateien.
5. Patchen Sie die .metallib Dateien, um Metal 3802-GPUs zu unterstützen.
6. Konvertieren Sie das Verzeichnis in ein macOS Distribution Package (PKG).

Hinweise zum Patchen einzelner .metallib Dateien:

1. Jede .metallib Datei ist eigentlich eine Sammlung von .air Dateien. Sie müssen sie im Zhouwei-Format extrahieren.
   • metallib/patch.py: _unpack_metallib_to_air()
2. Bestimmte .metallib -Dateien sind tatsächlich FAT Mach-O-Dateien. Daher müssen sie manuell verdünnt werden (Apples lipo Dienstprogramm unterstützt nicht die von uns benötigte AIR64-Architektur).
   • metallib/patch.py: _thin_file()
3. .air Dateien müssen als nächstes mit dem Dienstprogramm metal-objdump von Apple in .ll (LLVM IR) dekompiliert werden.
   • metallib/patch.py: _decompile_air_to_ll()
4. Mit der LLVM IR können wir mit dem Patchen der AIR-Version auf v26 (im Vergleich zu Sequoias v27) sowie anderen notwendigen Änderungen beginnen.
   • metallib/patch.py: _patch_ll()
5. Um IR in .air zu kompilieren, verwenden wir metal Dienstprogramm von Apple.
   • metallib/patch.py: _recompile_ll_to_air()
6. Um jede .air in eine .metallib Sammlung zu packen, verwenden wir das metallib Dienstprogramm von Apple.
   • metallib/patch.py: _pack_air_to_metallib()

Sobald sie fertig sind, sollten die resultierenden .metallib Dateien mit Metal 3802-basierten GPUs in macOS Sequoia funktionieren.

Verwendung

MetallibSupportPkg ist nicht für die Verwendung durch allgemeine Benutzer gedacht, das Folgende richtet sich an Entwickler.

Installieren Sie die erforderlichen Abhängigkeiten:

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

IPSW-URL abrufen:

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

Extrahieren Sie das Systemvolumen aus IPSW:

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

Metal-Bibliotheken vom Systemvolume abrufen und nach 15.x- extrahieren:

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

Patch Metal-Bibliotheken:

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

Konvertieren Sie Metal-Bibliotheken in ein macOS-Paket:

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.