اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.GkiDeviceFlashPreparer

أداة إعداد الوجهة التي تُفلش الجهاز باستخدام صورة نواة Android العامة يُرجى الاطّلاع على https://source.android.com/devices/architecture/kernel/android-common للحصول على التفاصيل.

ملخّص

وظائف الإنشاء العامة
`GkiDeviceFlashPreparer()`

الطرق العامة
`void`	`setUp(TestInformation testInfo)` نفِّذ عملية إعداد الاستهداف للاختبار.
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo)` تأكَّد من أنّ صورة تشغيل GKI متوقّعة.

الطرق المحمية
`void`	`addHashFooter(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` تأكَّد من أنّ صورة تشغيل GKI متوقّعة.
`void`	`buildGkiSystemDlkmImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` أنشئ صورة GKI system_dlkm إذا تم توفير أرشيف system_dlkm.
`File`	`extractSystemDlkmTarGzip(File systemDlkmArchive)` استخراج ملف system_dlkm tar gzip في مجلد system_dlkm_staging
`void`	`flattenSystemDlkm(ITestDevice device, File systemDlkmStagingDir)` اجعل الدليل المؤقت system_dlkm مسطّحًا لكي تكون جميع وحدات kernel مباشرةً ضمن ‎/lib/modules.
`IHostOptions`	`getHostOptions()` الحصول على مرجع إلى `IHostOptions`
`File`	`getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)` الحصول على الملف المطلوب من الملف المصدر (ملف zip أو مجلد) حسب اسم الملف المطلوب
`IRunUtil`	`getRunUtil()` احصل على نسخة `IRunUtil` لاستخدامها.
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` تأكَّد من أنّ صورة تشغيل GKI متوقّعة.

وظائف الإنشاء العامة

GkiDeviceFlashPreparer

public GkiDeviceFlashPreparer ()

الطرق العامة

setUp

public void setUp (TestInformation testInfo)

نفِّذ عملية إعداد الاستهداف للاختبار.

المعلمات
`testInfo`	‫`TestInformation`: `TestInformation` الاستدعاء

عمليات الرمي
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

validateGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

تأكَّد من أنّ صورة تشغيل GKI متوقّعة. (متوقف نهائيًا. يُرجى الاتصال باستخدام tmpDir المقدَّم)

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`buildInfo`	`IBuildInfo`: `IBuildInfo` معلومات الإصدار

عمليات الرمي
`TargetSetupError`	في حال عدم توفّر ملف boot.img صالح

الطرق المحمية

addHashFooter

protected void addHashFooter (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

تأكَّد من أنّ صورة تشغيل GKI متوقّعة. يجب طرح استثناء في حال عدم توفّر ملف boot.img صالح.

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`buildInfo`	`IBuildInfo`: `IBuildInfo` معلومات الإصدار
`tmpDir`	`File`: الدليل المؤقت `ERROR(/File)`

عمليات الرمي
`TargetSetupError`	في حال عدم توفّر ملف boot.img صالح
`DeviceNotAvailableException`

buildGkiSystemDlkmImg

protected void buildGkiSystemDlkmImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

أنشئ صورة GKI system_dlkm إذا تم توفير أرشيف system_dlkm.

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`buildInfo`	`IBuildInfo`: `IBuildInfo` معلومات الإصدار
`tmpDir`	`File`: الدليل المؤقت `ERROR(/File)`

عمليات الرمي
`TargetSetupError`	إذا حدث خطأ أثناء إنشاء ملف الصورة

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

استخراج ملف system_dlkm tar gzip في مجلد system_dlkm_staging هذه الدالة هي غلاف حول ERROR(/TarUtil.extractTarGzipToTemp) من أجل إيقاف عملية فك الحزمة من أجل اختبار الوحدة.

المعلمات
`systemDlkmArchive`	`File`: ملف system_dlkm tar gzip الذي يحتوي على وحدات GKI

المرتجعات
`File`	ملف يحتوي على محتوى system_dlkm tar gzip

عمليات الرمي
	IOException

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

اجعل الدليل المؤقت system_dlkm مسطّحًا لكي تكون جميع وحدات kernel مباشرةً ضمن ‎/lib/modules. هذا الإجراء ضروري لمطابقة تنسيق ملف system_dlkm المتوقّع لإصدارات منصّة.

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`systemDlkmStagingDir`	`File`: دليل النشر system_dlkm `ERROR(/File)`

عمليات الرمي
	أو TargetSetupError في حال حدوث خطأ في تسطيح system_dlkm.
`TargetSetupError`

getHostOptions

protected IHostOptions getHostOptions ()

الحصول على مرجع إلى IHostOptions

المرتجعات
`IHostOptions`	`IHostOptions` لاستخدام

getRequestedFile

protected File getRequestedFile (ITestDevice device, 
                String requestedFileName, 
                File sourceFile, 
                File tmpDir)

الحصول على الملف المطلوب من الملف المصدر (ملف zip أو مجلد) حسب اسم الملف المطلوب

يمكن أن يكون الملف المصدر المقدَّم ملفًا بتنسيق zip. ستفكّ الطريقة ضغط الملف إلى الدليل المؤقت وتبحث عن الملف المطلوب باستخدام اسم الملف المقدَّم.

يمكن أن يكون الملف المصدر المقدَّم مجلدًا للملفات. ستعثر الطريقة على الملف المطلوب باستخدام اسم الملف المقدَّم.

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`requestedFileName`	`String`: سلسلة اسم الملف المطلوب
`sourceFile`	`File`: ملف المصدر
`tmpDir`	`File`

المرتجعات
`File`	الملف المحدّد باسم الملف المطلوب

عمليات الرمي
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

احصل على نسخة IRunUtil لاستخدامها.

المرتجعات
`IRunUtil`	`IRunUtil` لاستخدام

validateGkiBootImg

protected void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

تأكَّد من أنّ صورة تشغيل GKI متوقّعة. يجب طرح استثناء في حال عدم توفّر ملف boot.img صالح.

المعلمات
`device`	`ITestDevice`: `ITestDevice`
`buildInfo`	`IBuildInfo`: `IBuildInfo` معلومات الإصدار
`tmpDir`	`File`: الدليل المؤقت `ERROR(/File)`

عمليات الرمي
`TargetSetupError`	في حال عدم توفّر ملف boot.img صالح