آماده‌ساز فلش دستگاه GkiDevice

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

شیء جاوا
↳ com.android.tradefed.targetprep.BaseTargetPreparer
↳ com.android.tradefed.targetprep.GkiDeviceFlashPreparer

یک آماده‌ساز هدف که دستگاه را با ایمیج عمومی کرنل رایج اندروید فلش می‌کند. برای جزئیات بیشتر لطفاً به 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)

اگر آرشیو system_dlkm ارائه شده باشد، تصویر GKI system_dlkm را بسازید.

File extractSystemDlkmTarGzip (File systemDlkmArchive)

فایل tar gzip مربوط به system_dlkm را در پوشه system_dlkm_staging استخراج می‌کند.

void flattenSystemDlkm ( ITestDevice device, File systemDlkmStagingDir)

پوشه‌ی مرحله‌بندی system_dlkm را مسطح کنید تا تمام ماژول‌های هسته مستقیماً در /lib/modules قرار گیرند.

String[] getDeviceKernelVersion ( ITestDevice device)

قبل از فلش کردن، نسخه کرنل دستگاه را از دستگاه دریافت کنید.

IHostOptions getHostOptions ()

به IHostOptions ارجاع دهید

String[] getKernelVersionFromImage (File image)

نسخه هسته را از فایل‌های ایمیج boot/vendor_boot/system_dlkm/vendor_dlkm استخراج می‌کند.

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

فایل درخواستی را از فایل منبع (zip یا پوشه) با نام فایل درخواستی دریافت کنید.

IRunUtil getRunUtil ()

نمونه IRunUtil را برای استفاده دریافت کنید.

String[] parseKernelVersion (String source, String kernelVersionString)
void validateGkiBootImg ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

اعتبارسنجی تصویر بوت GKI مورد انتظار است.

void validateKernelCompatibility (String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)
void validateKernelVersion ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

انتظار می‌رود نسخه‌های کرنل موجود در تصاویر اعتبارسنجی شوند.

سازندگان عمومی

آماده‌ساز فلش دستگاه GkiDevice 

public GkiDeviceFlashPreparer ()

روش‌های عمومی

راه‌اندازی 

public void setUp (TestInformation testInfo)

تنظیمات هدف را برای آزمایش انجام دهید.

پارامترها
testInfo TestInformation : TestInformation مربوط به فراخوانی.

پرتاب‌ها
BuildError
DeviceNotAvailableException
TargetSetupError

اعتبارسنجیGkiBootImg 

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

اعتبارسنجی تصویر بوت GKI مورد انتظار است. (منسوخ شده. لطفاً با tmpDir ارائه شده تماس بگیرید)

پارامترها
device ITestDevice : ITestDevice

buildInfo IBuildInfo : اطلاعات ساخت در IBuildInfo

پرتاب‌ها
TargetSetupError اگر فایل gki boot.img معتبری وجود نداشته باشد

روش‌های محافظت‌شده

اضافه کردن هش‌فوتر 

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

اعتبارسنجی تصویر بوت GKI مورد انتظار است. در صورت عدم وجود boot.img معتبر، استثنا ایجاد می‌شود.

پارامترها
device ITestDevice : ITestDevice

buildInfo IBuildInfo : اطلاعات ساخت در IBuildInfo

tmpDir File : دایرکتوری موقت File

پرتاب‌ها
TargetSetupError اگر فایل gki boot.img معتبری وجود نداشته باشد
DeviceNotAvailableException

buildGkiSystemDlkmImg 

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

اگر آرشیو system_dlkm ارائه شده باشد، تصویر GKI system_dlkm را بسازید.

پارامترها
device ITestDevice : ITestDevice

buildInfo IBuildInfo : اطلاعات ساخت در IBuildInfo

tmpDir File : دایرکتوری موقت File

پرتاب‌ها
TargetSetupError اگر در ساخت فایل تصویر خطایی رخ داد.

استخراج سیستمDlkmTarGzip 

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

فایل فشرده‌ی system_dlkm tar gzip را در پوشه‌ی system_dlkm_staging استخراج می‌کند. این تابع، پوششی پیرامون ERROR(/TarUtil.extractTarGzipToTemp) است تا untarring را برای تست واحد، حذف کند.

پارامترها
systemDlkmArchive File : فایل tar gzip مربوط به system_dlkm که حاوی ماژول‌های GKI است.

بازگشت‌ها
File فایلی که حاوی محتویات tar gzip مربوط به system_dlkm است.

پرتاب‌ها
استثنای java.io.IO
IOException

flattenSystemDlkm 

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

پوشه‌ی مرحله‌بندی system_dlkm را مسطح کنید تا تمام ماژول‌های هسته مستقیماً در /lib/modules قرار گیرند. این کار برای مطابقت با طرح‌بندی فایل system_dlkm مورد انتظار برای ساخت پلتفرم ضروری است.

پارامترها
device ITestDevice : ITestDevice

systemDlkmStagingDir File : دایرکتوری مرحله‌بندی File

پرتاب‌ها
IOException یا TargetSetupError اگر خطایی در مسطح کردن system_dlkm وجود داشته باشد.
TargetSetupError

دریافت نسخه هسته دستگاه 

protected String[] getDeviceKernelVersion (ITestDevice device)

قبل از فلش کردن، نسخه کرنل دستگاه را از دستگاه دریافت کنید.

پارامترها
device ITestDevice : ITestDevice قرار است نسخه کرنل را از آن دریافت کنیم.

بازگشت‌ها
String[] یک ERROR(/String[]) حاوی اطلاعات نسخه هسته تجزیه شده: [kernelVersion, patchLevel, pageSize]. اگر رشته نسخه قابل تجزیه نباشد، مقدار null را برمی‌گرداند.2

پرتاب‌ها
DeviceNotAvailableException

گزینه‌های میزبان 

protected IHostOptions getHostOptions ()

به IHostOptions ارجاع دهید

بازگشت‌ها
IHostOptions IHostOptions برای استفاده

دریافت نسخه کرنل از تصویر 

protected String[] getKernelVersionFromImage (File image)

نسخه هسته را از فایل‌های تصویری boot/vendor_boot/system_dlkm/vendor_dlkm استخراج می‌کند. این روش فایل تصویری boot/vendor_boot/system_dlkm/vendor_dlkm را می‌خواند و به دنبال الگوی خاصی در رشته‌های نسخه هسته اندروید می‌گردد. سپس رشته یافت شده را تجزیه می‌کند تا نسخه هسته را در قالبی استاندارد استخراج کند.

پارامترها
image File : File مربوط به فایل ایمیج بوت (مثلاً boot.img).

بازگشت‌ها
String[] یک ERROR(/String[]) حاوی اطلاعات نسخه هسته تجزیه شده: [kernelVersion, patchLevel, pageSize]. اگر رشته نسخه قابل تجزیه نباشد، مقدار null را برمی‌گرداند.

دریافت فایل درخواستی 

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

فایل درخواستی را از فایل منبع (zip یا پوشه) با نام فایل درخواستی دریافت کنید.

فایل منبع ارائه شده می‌تواند یک فایل زیپ باشد. این متد آن را در یک دایرکتوری موقت از حالت زیپ خارج کرده و فایل درخواستی را با نام فایل ارائه شده پیدا می‌کند.

فایل منبع ارائه شده می‌تواند یک پوشه فایل باشد. این متد فایل درخواست شده را با نام فایل ارائه شده پیدا می‌کند.

پارامترها
device ITestDevice : ITestDevice

requestedFileName String : نام فایل درخواستی رشته

sourceFile File : فایل منبع

tmpDir File

بازگشت‌ها
File فایلی که با نام فایل درخواستی مشخص شده است

پرتاب‌ها
خطای com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

دریافت RunUtil 

protected IRunUtil getRunUtil ()

نمونه IRunUtil را برای استفاده دریافت کنید.

بازگشت‌ها
IRunUtil IRunUtil برای استفاده

تجزیه نسخه هسته 

protected String[] parseKernelVersion (String source, 
                String kernelVersionString)

پارامترها
source String

kernelVersionString String

بازگشت‌ها
String[]

اعتبارسنجیGkiBootImg 

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

اعتبارسنجی تصویر بوت GKI مورد انتظار است. در صورت عدم وجود boot.img معتبر، استثنا ایجاد می‌شود.

پارامترها
device ITestDevice : ITestDevice

buildInfo IBuildInfo : اطلاعات ساخت در IBuildInfo

tmpDir File : دایرکتوری موقت File

پرتاب‌ها
TargetSetupError اگر فایل gki boot.img معتبری وجود نداشته باشد

اعتبارسنجی سازگاری هسته 

protected void validateKernelCompatibility (String imageName, 
                String[] imageVersion, 
                String[] bootVersion, 
                ITestDevice device)

پارامترها
imageName String

imageVersion String

bootVersion String

device ITestDevice

پرتاب‌ها
TargetSetupError

اعتبارسنجی نسخه هسته 

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

نسخه‌های کرنل موجود در ایمیج‌ها را اعتبارسنجی کنید. در صورت عدم اعتبار، استثنا ایجاد کنید.

پارامترها
device ITestDevice : ITestDevice

buildInfo IBuildInfo : اطلاعات ساخت در IBuildInfo

tmpDir File : دایرکتوری موقت File

پرتاب‌ها
TargetSetupError اگر فایل gki boot.img معتبری وجود نداشته باشد
DeviceNotAvailableException