MetallibSupportPkg

MetallibSupportPkg

مجموعة من الأدوات المساعدة المتعلقة بتصحيح المكتبات المعدنية ( .metallib ) في نظام التشغيل macOS، وتحديدًا بهدف استعادة الدعم للأجهزة القديمة (تحديدًا وحدات معالجة الرسوميات المستندة إلى Metal 3802 على نظام التشغيل macOS Sequoia).

منطق

يضم MetallibSupportPkg مكتبة metal_libraries python، والتي تم تطويرها لتبسيط عملية تصحيح Metal Library من خلال ما يلي:

1. جلب أحدث إصدار من نظام التشغيل MacOS Sequoia IPSW برمجيًا.
2. قم باستخراج DMG لوحدة تخزين النظام من IPSW.
3. إذا كانت صورة القرص مشفرة بتقنية AEA، فقم بفك تشفيرها باستخدام aastuff .
4. قم بتحميل صورة القرص، واستخرج جميع ملفات .metallib المدعومة.
5. قم بتصحيح ملفات .metallib لدعم وحدات معالجة الرسوميات Metal 3802.
6. قم بتحويل الدليل إلى حزمة توزيع macOS (PKG).

ملاحظات بخصوص تصحيح ملفات .metallib الفردية:

1. كل ملف .metallib هو في الواقع مجموعة من ملفات .air . تحتاج إلى استخراجها باستخدام تنسيق zhouwei.
   • metallib/patch.py: _unpack_metallib_to_air()
2. بعض ملفات .metallib هي في الواقع ملفات FAT Mach-O. وبالتالي، يجب تخفيفها يدويًا (لا تدعم أداة lipo من Apple بنية AIR64 التي نحتاجها).
   • metallib/patch.py: _thin_file()
3. تحتاج ملفات .air إلى أن يتم فك ترجمتها بعد ذلك إلى .ll (LLVM IR) باستخدام الأداة المساعدة metal-objdump من Apple.
   • metallib/patch.py: _decompile_air_to_ll()
4. باستخدام LLVM IR، يمكننا البدء في تصحيح إصدار AIR إلى الإصدار 26 (مقارنة بإصدار Sequoia's v27) بالإضافة إلى التغييرات الضرورية الأخرى.
   • metallib/patch.py: _patch_ll()
5. لتجميع IR إلى .air ، نستخدم الأداة metal من Apple.
   • metallib/patch.py: _recompile_ll_to_air()
6. لتعبئة كل .air في مجموعة .metallib ، نستخدم الأداة المساعدة metallib من Apple.
   • metallib/patch.py: _pack_air_to_metallib()

بمجرد الانتهاء، يجب أن تعمل ملفات .metallib الناتجة مع وحدات معالجة الرسوميات المستندة إلى Metal 3802 في نظام التشغيل macOS Sequoia.

الاستخدام

MetallibSupportPkg ليس مخصصًا للاستخدام من قبل المستخدمين العاديين، ما يلي مخصص للمطورين.

تثبيت التبعيات المطلوبة:

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

جلب عنوان URL الخاص بـ IPSW:

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

سيتم استخراج مكتبات جلب المعادن من وحدة تخزين النظام إلى 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 >

تحويل المكتبات المعدنية إلى حزمة 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.