InstallApexModuleTargetPreparer

public class InstallApexModuleTargetPreparer
extends SuiteApkInstaller

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.TestAppInstallSetup
		↳	com.android.tradefed.targetprep.suite.SuiteApkInstaller
			↳	com.android.tradefed.targetprep.InstallApexModuleTargetPreparer

الفئات الفرعية المباشرة المعروفة ModuleOemTargetPreparer ModuleOemTargetPreparer

---

ملخّص

الحقول
protected static final String	APEX_OPTION
protected static final String	APEX_SUFFIX
protected static final String	APK_SUFFIX
protected static final String	APK_ZIP_OPTION
protected static final String	CHILD_SESSION_CREATION_CMD
protected static final String	PARENT_SESSION_CREATION_CMD
public static final String	ROLLBACK_STATE_COMMITTED
public static final String	ROLLBACK_STATE_UNKNOWN
protected static final String	SPLIT_APKS_SUFFIX
protected File	mTrainFolderPath

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

الطرق العامة
	getModulesToInstall(TestInformation testInfo) تحصل على الوحدات التي يجب تثبيتها على القطار، استنادًا إلى الوحدات المحمَّلة مسبقًا على الجهاز.
void	setIgnoreIfNotPreloaded(boolean skip)
void	setSkipApexTearDown(boolean skip)
void	setUp(TestInformation testInfo)
void	tearDown(TestInformation testInfo, Throwable e)

الطرق المحمية
void	addApksToTestFiles()
void	addStagedReadyTimeoutForAdb( cmd)
void	addTimeoutMillisForBundletool( extraArgs)
void	checkApexActivation(ITestDevice device) تأكَّد من تفعيل جميع قمم الهرم.
	collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo) يجمع معلومات Apex من وحدات Apex للتحقّق من التفعيل.
	getApkInstalled()
String	getBundletoolFileName()
BundletoolUtil	getBundletoolUtil()
String	getModuleKeywordFromApexPackageName(String packageName) تحصل على الكلمة الرئيسية (مثل tzdata لـ com.android.tzdata.apex) من اسم حزمة apex.
	getModulesFailToActivate( activatedApexes) الحصول على الوحدات التي تعذّر تفعيلها
	getSplitsForApks(TestInformation testInfo, File moduleFile) استخراج عمليات التقسيم وإرجاعها لحِزم APK المحدّدة
void	initBundletoolUtil(TestInformation testInfo) يبدأ أداة bundletool لهذه الفئة.
void	installTrain(TestInformation testInfo, moduleFilenames) محاولات تثبيت قطار رئيسي يحتوي على قمة على الجهاز
void	installUsingBundleTool(TestInformation testInfo, testAppFileNames) محاولات تثبيت وحدات الإصدار الرئيسي باستخدام bundletool
void	installer(TestInformation testInfo, testAppFileNames) محاولة تثبيت حزمة أو حزمة مجزأة على الجهاز
ITestDevice.ApexInfo	retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor) يسترجع ApexInfo الذي يحتوي على packageName وversionCode من ملف apex المحدَّد.

الحقول

APEX_OPTION

protected static final String APEX_OPTION

APEX_SUFFIX

protected static final String APEX_SUFFIX

APK_SUFFIX

protected static final String APK_SUFFIX

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

mTrainFolderPath

protected File mTrainFolderPath

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

InstallApexModuleTargetPreparer

public InstallApexModuleTargetPreparer ()

الطرق العامة

getModulesToInstall

public  getModulesToInstall (TestInformation testInfo)

تحصل على الوحدات التي يجب تثبيتها على القطار، استنادًا إلى الوحدات المحمَّلة مسبقًا على الجهاز. لن يتم تثبيت الوحدات التي لم يتم تحميلها مسبقًا.

المعلمات
testInfo	TestInformation: TestInformation

المرتجعات
	قائمة بالوحدات التي يجب تثبيتها على الجهاز

عمليات الرمي
DeviceNotAvailableException	عندما لا يكون الجهاز متاحًا
TargetSetupError	عندما لا تكون الوحدات الإلزامية مثبّتة أو لا يمكن تثبيت الوحدات

setIgnoreIfNotPreloaded

public void setIgnoreIfNotPreloaded (boolean skip)

المعلمات
skip	boolean

setSkipApexTearDown

public void setSkipApexTearDown (boolean skip)

المعلمات
skip	boolean

setUp

public void setUp (TestInformation testInfo)

المعلمات
testInfo	TestInformation

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

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

المعلمات
testInfo	TestInformation
e	Throwable

عمليات الرمي
DeviceNotAvailableException
DeviceRuntimeException

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

addApksToTestFiles

protected void addApksToTestFiles ()

addStagedReadyTimeoutForAdb

protected void addStagedReadyTimeoutForAdb ( cmd)

المعلمات
cmd

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool ( extraArgs)

المعلمات
extraArgs

checkApexActivation

protected void checkApexActivation (ITestDevice device)

تأكَّد من تفعيل جميع قمم الهرم.

المعلمات
device	‫ITestDevice: قيد الاختبار

عمليات الرمي
TargetSetupError	إذا تعذّر التفعيل
DeviceNotAvailableException

collectApexInfoFromApexModules

protected  collectApexInfoFromApexModules ( testAppFileNames, 
                TestInformation testInfo)

يجمع معلومات Apex من وحدات Apex للتحقّق من التفعيل.

المعلمات
testAppFileNames	: قائمة بأسماء ملفات الوحدات المطلوب تثبيتها
testInfo	TestInformation: TestInformation

المرتجعات
	قائمة تحتوي على apexinfo لوحدات apex في قوائم ملفات الإدخال

عمليات الرمي
TargetSetupError

getApkInstalled

protected  getApkInstalled ()

المرتجعات

getBundletoolFileName

protected String getBundletoolFileName ()

المرتجعات
String

getBundletoolUtil

protected BundletoolUtil getBundletoolUtil ()

المرتجعات
BundletoolUtil

getModuleKeywordFromApexPackageName

protected String getModuleKeywordFromApexPackageName (String packageName)

تحصل على الكلمة الرئيسية (مثل tzdata لـ com.android.tzdata.apex) من اسم حزمة apex.

المعلمات
packageName	String: اسم حزمة ملف Apex

المرتجعات
String	سلسلة: الكلمة الرئيسية لاسم حزمة القمة

getModulesFailToActivate

protected  getModulesFailToActivate ( activatedApexes)

الحصول على الوحدات التي تعذّر تفعيلها

المعلمات
activatedApexes	: مجموعة القمم النشطة على الجهاز

المرتجعات
	قائمة تحتوي على apexinfo لوحدات apex التي تُدخل البيانات والتي تعذّر تفعيلها

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

getSplitsForApks

protected  getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

استخراج عمليات التقسيم وإرجاعها لحِزم APK المحدّدة

المعلمات
testInfo	TestInformation: TestInformation
moduleFile	‫File: ملف الوحدة لاستخراج الأقسام منه

المرتجعات
	ملف [] يحتوي على الأقسام

عمليات الرمي
TargetSetupError	إذا تعذّر العثور على أداة bundletool أو تعذّر إنشاء ملف مواصفات الجهاز

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

يبدأ أداة bundletool لهذه الفئة.

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

عمليات الرمي
TargetSetupError	إذا تعذّر العثور على أداة bundletool

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames)

محاولات تثبيت قطار رئيسي يحتوي على قمة على الجهاز

المعلمات
testInfo	TestInformation: TestInformation
moduleFilenames	‫: قائمة بسلسلة. قائمة بأسماء ملفات الوحدات الرئيسية التي يجب تثبيتها

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

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                 testAppFileNames)

محاولات تثبيت وحدات الإصدار الرئيسي باستخدام bundletool

المعلمات
testInfo	TestInformation: TestInformation
testAppFileNames	‫: أسماء ملفات الوحدات المحمَّلة مسبقًا المطلوب تثبيتها

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

مثبِّت

protected void installer (TestInformation testInfo, 
                 testAppFileNames)

محاولة تثبيت حزمة أو حزمة مجزأة على الجهاز

المعلمات
testInfo	‫TestInformation: TestInformation للاستدعاء
testAppFileNames	‫: حِزم apk التي سيتم تثبيتها

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

retrieveApexInfo

protected ITestDevice.ApexInfo retrieveApexInfo (File testApexFile, 
                DeviceDescriptor deviceDescriptor)

يسترجع ApexInfo الذي يحتوي على packageName وversionCode من ملف apex المحدَّد.

المعلمات
testApexFile	File: ملف القمة الذي نستلِم المعلومات منه
deviceDescriptor	DeviceDescriptor

المرتجعات
ITestDevice.ApexInfo	ApexInfo يحتوي على packageName وversionCode للملف المحدّد

عمليات الرمي
TargetSetupError	إذا تعذّر على منظِّم تحليل aapt تحليل الملف