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

---

ملخّص

الثوابت
String	APEX_OPTION
String	APEX_SUFFIX
String	APK_SUFFIX
String	APK_ZIP_OPTION
String	CHILD_SESSION_CREATION_CMD
String	PARENT_SESSION_CREATION_CMD
String	ROLLBACK_STATE_COMMITTED
String	ROLLBACK_STATE_UNKNOWN
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) محاولات تثبيت حزمة APEX تحتوي على قطار رئيسي على الجهاز
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

Constant Value: "--apex"

APEX_SUFFIX

protected static final String APEX_SUFFIX

Constant Value: ".apex"

APK_SUFFIX

protected static final String APK_SUFFIX

القيمة الثابتة: ".apk"

APK_ZIP_OPTION

protected static final String APK_ZIP_OPTION

Constant Value: "--apks-zip"

CHILD_SESSION_CREATION_CMD

protected static final String CHILD_SESSION_CREATION_CMD

Constant Value: "pm install-create"

PARENT_SESSION_CREATION_CMD

protected static final String PARENT_SESSION_CREATION_CMD

القيمة الثابتة: "pm install-create --multi-package"

ROLLBACK_STATE_COMMITTED

public static final String ROLLBACK_STATE_COMMITTED

القيمة الثابتة: "committed"

ROLLBACK_STATE_UNKNOWN

public static final String ROLLBACK_STATE_UNKNOWN

Constant Value: "unknown"

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

القيمة الثابتة: ".apks"

الحقول

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	سلسلة تمثّل الكلمة الرئيسية لاسم حزمة Apex.

getModulesFailToActivate

protected  getModulesFailToActivate ( activatedApexes)

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

المعلمات
activatedApexes	‫: مجموعة حِزم apex النشطة على الجهاز

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

الرميات
DeviceNotAvailableException
TargetSetupError

getSplitsForApks

protected  getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

تستخرِج هذه السمة حِزم APK المقسّمة المحدّدة وتعرضها.

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

المرتجعات
	File[] يحتوي على عمليات التقسيم.

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

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

تهيئة أداة bundletool المساعدة لهذه الفئة

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

الرميات
TargetSetupError	في حال تعذّر العثور على bundletool

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames)

محاولات تثبيت إصدار رئيسي من نظام التشغيل يحتوي على حزمة apex على الجهاز

المعلمات
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: ملف Apex الذي نستردّ المعلومات منه.
deviceDescriptor	DeviceDescriptor

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

الرميات
TargetSetupError	إذا تعذّر على محلّل aapt تحليل الملف.