大変

taiHEN هو إطار عمل للبرامج الثابتة المخصصة (CFW) لجهاز PS Vita™. عند تحميله مع استغلال نواة (kernel exploit)، يعمل كبنية أساسية مشتركة لترقيع النظام. يوفّر taiHEN ثلاث ميزات رئيسية:

1. يعطّل فحوصات توقيع الكود للسماح بتنفيذ الملفات التنفيذية غير الموقّعة.
2. يكشف لتطبيقات المستخدم استدعاءات نظام (syscalls) من نوع kernel peek/poke، ويسمح بتحميل وحدات النواة.
3. والأهم من ذلك، يوفّر واجهة برمجة (API) لربط الدوال واستبدالها بالاستناد إلى substitute.

النقطة الأخيرة تعني أن المطوّرين يمكنهم إضافة ترقيعات مخصصة إلى النواة وتطبيقات النظام والألعاب على حد سواء.

البناء

للبناء، تحتاج إلى أحدث إصدار من سلسلة الأدوات (toolchain) مع دعم النواة. بعد ذلك، فقط استخدم CMake للبناء.

$ mkdir build && cd build
$ cmake ../
$ make

التثبيت

يتطلب taiHEN استغلال نواة منفصلًا لكي يعمل. بمجرد أن يحمّل الاستغلال taihen.skprx إلى النواة، سيتولى taiHEN الباقي. يُرجى الرجوع إلى وثائق الاستغلال لمزيد من المعلومات.

الإضافات

تُحمَّل الإضافات إما في النواة بعد تحميل taiHEN أو عند الطلب عند تشغيل تطبيق. يقرأ taiHEN ملف الإعدادات في ux0:tai/config.txt.

الإعدادات التي تحدّد الإضافات المراد تحميلها وترتيب التحميل توجد في ux0:tai/config.txt. الصيغة بسيطة جدًا وواضحة بذاتها.

# ignored line starting with #
# Kernel plugins are started with taiHEN and are in this section
*KERNEL
ux0:app/MLCL00001/henkaku.skprx
ux0:path/to/another.skprx
ux0:tai/plugin3.skprx
ux0:data/tai/plugin4.skprx
ux0:data/tai/plugin5.skprx
# titleid for SceSettings
*NPXS10015
ux0:app/MLCL00001/henkaku.suprx
ux0:data/tai/some_settings_plugin.suprx
# titleid for Package Installer
*NPXS10031
ux0:path/to/some_pkg_installer_plgin.suprx
# titleid for SceShell is special (does not follow the XXXXYYYYY format)
*main
ux0:app/MLCL00001/henkaku.skprx
ux0:data/tai/shell_plgin.skprx

النقاط الرئيسية التي يجب ملاحظتها هي:

1. يبدأ # تعليقًا، ويبدأ * قسمًا، وأي حرف آخر يبدأ مسارًا.
2. KERNEL هو اسم قسم خاص يدل على تحميل إضافة نواة عند بدء تشغيل taiHEN. جميع أسماء الأقسام الأخرى هي معرّف العنوان (title id) للتطبيق/اللعبة التي سيتم تحميل الإضافة فيها عند بدء التشغيل. لاحظ أن SceShell له معرّف عنوان خاص وهو main.
3. في كل قسم، توجد قائمة بمسارات الإضافات التي سيتم تحميلها بالترتيب. يمكن أن تكون المسارات في أي مكان، لكن يُنصح بأن تكون الإضافات في ux0:tai أو ux0:data/tai. يجوز أن توجد إضافة واحدة في أقسام متعددة، لكن يجب على المطوّر التأكد من أن الإضافة تعرف التطبيق الذي حُمِّلت فيه إذا كانت بحاجة إلى القيام بأمور مختلفة.

واجهة البرمجة (API)

يصدّر taiHEN واجهة برمجية (API) لكل من النواة والمستخدم. توجد هذه الواجهة في [صفحات التوثيق](@ref taihen). يجب عليك أيضًا قراءة دليل الاستخدام لمزيد من التفاصيل. يمكنك إما تنزيل الإصدار الجاهز أو بناء taiHEN بنفسك. بعد ذلك، يمكنك تضمين taihen.h في مشروعك والربط مع libtaihen_stub.a (لوحدات المستخدم) أو libtaihen_kernel_stub.a (لوحدات النواة).