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

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

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

ملخّص

الحقول
`protected static final String`	`APEX_SUFFIX`
`protected static final String`	`APK_SUFFIX`
`protected static final String`	`SPLIT_APKS_SUFFIX`

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

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

الطرق المحمية
`void`	`addApksToTestFiles()`
	`collectApexInfoFromApexModules( testAppFileNames, TestInformation testInfo)` يجمع معلومات Apex من وحدات Apex للتحقّق من التفعيل.
`boolean`	`containsPersistentApk( testAppFileNames, TestInformation testInfo)` للتحقّق مما إذا كانت ملفات الإدخال تحتوي على أي حِزم apk دائمة.
	`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, String[] extraArgs)` محاولات تثبيت قطار رئيسي يحتوي على قمة على الجهاز
`void`	`installUsingBundleTool(TestInformation testInfo, testAppFileNames)` محاولات تثبيت وحدات الإصدار الرئيسي باستخدام bundletool
`void`	`installer(TestInformation testInfo, testAppFileNames)` محاولة تثبيت حزمة أو حزمة مجزأة على الجهاز
`boolean`	`isPersistentApk(File filename, TestInformation testInfo)` للتحقّق مما إذا كان ملف apk ملف apk دائمًا
`ITestDevice.ApexInfo`	`retrieveApexInfo(File testApexFile, DeviceDescriptor deviceDescriptor)` يسترجع ApexInfo الذي يحتوي على packageName وversionCode من ملف apex المحدَّد.

الحقول

APEX_SUFFIX

protected static final String APEX_SUFFIX

APK_SUFFIX

protected static final String APK_SUFFIX

SPLIT_APKS_SUFFIX

protected static final String SPLIT_APKS_SUFFIX

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

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`

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

addApksToTestFiles

protected void addApksToTestFiles ()

collectApexInfoFromApexModules

protected  collectApexInfoFromApexModules ( testAppFileNames, 
                TestInformation testInfo)

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

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

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

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

containsPersistentApk

protected boolean containsPersistentApk ( testAppFileNames, 
                TestInformation testInfo)

للتحقّق مما إذا كانت ملفات الإدخال تحتوي على أي حِزم apk دائمة.

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

المرتجعات
`boolean`	`true` إذا كانت ملفات الإدخال تحتوي على وحدة apk دائمة.

عمليات الرمي
`DeviceNotAvailableException`
`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, 
                String[] extraArgs)

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

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

عمليات الرمي
`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`

isPersistentApk

protected boolean isPersistentApk (File filename, 
                TestInformation testInfo)

للتحقّق مما إذا كان ملف apk ملف apk دائمًا

المعلمات
`filename`	`File`: ملف وحدة apk المطلوب التحقّق منه
`testInfo`	`TestInformation`: `TestInformation`

المرتجعات
`boolean`	‫`true` إذا كانت هذه وحدة 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 تحليل الملف