GKI 1.0: اختبار التوافق

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

الحصول على صور التشغيل

في AOSP، يمكنك الحصول على صور التمهيد المُنشأة مسبقًا من ci.android.com. تتضمّن صور التمهيد أرشيف aosp_arm64-img-*.zip فيهدف الإنشاء aosp_arm64، على النحو التالي:

يمكن للشركاء الحصول على صور تمهيد موقَّعة أو غير موقَّعة، على النحو التالي:

  • الحصول على صور التمهيد غير الموقَّعة استنادًا إلى android12-5.4 من الفرع aosp-main على الرابط ci.android.com (ابحث في استهداف الإنشاء aosp_arm64). تحتوي صور التمهيد هذه على ملف ramdisk تم إنشاؤه من فرع AOSP main. لا تستخدِم صور boot-debug، فهي مخصّصة للأجهزة التي تم إصدارها قبل مبادرة GKI فقط.
  • يمكنك الحصول على صور التمهيد الموقَّعة المستندة إلى الإصدار android11-5.4 من partner.android.com. تحتوي صور التمهيد هذه على قرص RAM تم إنشاؤه من فرع r-fs-release. تتبع عملية توقيع boot.img العملية نفسها المتّبعة في عملية توقيع GSI.

تتوفّر كل من صور التمهيد الموقَّعة وغير الموقَّعة في خيارات ملف kernel المضغوط التالية:

  • boot-5.4.img هو نواة غير مضغوطة.
  • boot-5.4-gz هي نواة مضغوط ببرنامج gzip.
  • ‫boot-5.4-lz4 هي نواة مضغوطة بتنسيق lz4.
لاختبار التوافق، استخدِم صور التمهيد التي تحتوي على نواة تُصدِّر فقط الرموز التي تظهر في قائمة رموز KMI (الرموز هي trimmed).

لأغراض التطوير، يمكنك استخدام الإصدارات المُعدّة مسبقًا من الإصدارات الأساسية وصور التمهيد GKI التي تُصدِر جميع الرموز في الإصدار الأساسي (الرموز هي untrimmed). يتم إنشاء الإصدارات المُعدّة مسبقًا من الإصدارات الأساسية غير المُقتطعة في الوجهة kernel_debug_aarch64 لإصدار أساسي معيّن على ci.android.com. يتم إنشاء صور التمهيد GKI غير المُقتطعة في إصدارات userdebug إلى جانب صور التمهيد GKI العادية المُقتطعة، ويكون لملفاتها أسماء تنتهي بـ -allsyms.img.

الحصول على عناصر إنشاء النواة

عند تصحيح أخطاء في ملف boot.img GKI، من المفيد أيضًا توفُّر عناصر التصميم المرتبطة بالنواة في هذا الملف. على سبيل المثال، يمكنك استخدام vmlinux غير المُعرَّى لتصحيح الأخطاء والبيان لإعادة إنشاء ملف أرشيف نواة GKI محليًا. للحصول على عناصر الإنشاء:

  1. حدِّد رقم الإصدار للنواة المُنشأة مسبقًا والتي تم استخدامها لإنشاء GKI boot.img. يظهر رقم الإصدار في نهاية إصدار النواة، ويسبقه الحرفab. يعرض المثال التالي رقم الإصدار بخط عريض:

    [ 0.000000] Linux version 5.4.49-00947-g9d21bcd4897b-ab6638796

    يمكنك أيضًا تحديد رقم الإصدار للنواة باستخدام grep للعثور على صورة تمهيد تحتوي على نواة غير مضغوطة:

    grep -a "Linux version " boot-5.4.img

  2. افتح الإصدار المُعدّ مسبقًا من kernel باستخدام رقم الإصدار في العنوان التالي URL: https://ci.android.com/builds/submitted/<number>/kernel_aarch64/latest

    على سبيل المثال، باستخدام رقم الإصدار من الخطوة 1، يكون عنوان URL على النحو التالي: https://ci.android.com/builds/submitted/6638796/kernel_aarch64/latest

    عند استخدام إصدار غير مُقتطع، استبدِل kernel_aarch64 في الرابط بـ kernel_debug_aarch64.