GKI 1.0: تست سازگاری

این صفحه نحوه به دست آوردن تصاویر بوت با مصنوعات ساخت هسته برای آزمایش سازگاری را شرح می دهد.

دریافت تصاویر بوت

در AOSP، می توانید تصاویر بوت از پیش ساخته شده را از ci.android.com دریافت کنید. تصاویر بوت در آرشیو aosp_arm64-img-*.zip در هدف ساخت aosp_arm64 به شرح زیر قرار دارند:

شرکا می توانند تصاویر بوت بدون امضا یا امضا را به شرح زیر دریافت کنند:

  • تصاویر بوت بدون امضا را بر اساس android12-5.4 از شعبه aosp-main در ci.android.com دریافت کنید (به هدف ساخت aosp_arm64 نگاه کنید). این تصاویر بوت شامل یک ramdisk ساخته شده از شاخه main AOSP است. از تصاویر boot-debug استفاده نکنید. آنها فقط برای دستگاه های قبل از GKI در نظر گرفته شده اند.
  • تصاویر بوت امضا شده بر اساس android11-5.4 را از partner.android.com دریافت کنید. این تصاویر بوت حاوی یک ramdisk هستند که از شاخه r-fs-release ساخته شده است. امضای boot.img همان فرآیند امضای GSI را دنبال می کند.

هر دو تصویر بوت امضا شده و بدون امضا در گزینه های فشرده سازی هسته زیر ارائه می شوند:

  • 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 ختم می‌شوند.

آرتیفکت های ساخت هسته را بدست آورید

هنگام اشکال زدایی مشکلات در یک فایل GKI boot.img ، داشتن مصنوعات ساخت مرتبط با هسته در آن فایل نیز مفید است. به عنوان مثال، می توانید از vmlinux unstripped برای اشکال زدایی و مانیفست برای بازتولید هسته GKI به صورت محلی استفاده کنید. برای به دست آوردن مصنوعات ساخت:

  1. شماره ساخت هسته از پیش ساخته شده برای ایجاد GKI boot.img پیدا کنید. شماره ساخت در انتهای نسخه کرنل ظاهر می شود که قبل از آن حروف ab وجود دارد. مثال زیر شماره ساخت را به صورت پررنگ نشان می دهد:

    [ 0.000000] Linux version 5.4.49-00947-g9d21bcd4897b-ab 6638796

    همچنین می توانید شماره ساخت هسته را با استفاده از grep برای یافتن یک تصویر بوت حاوی یک هسته فشرده نشده تعیین کنید:

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

  2. بیلد از پیش ساخته شده هسته را با استفاده از شماره ساخت در آدرس زیر باز کنید: 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 جایگزین کنید.