اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

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

‫CompanionTestAppInstallSetup وSuiteApkInstaller

CompanionTestAppInstallSetup	`ITargetPreparer` يثبّت تطبيقًا واحدًا أو أكثر من مجلد `IDeviceBuildInfo.getTestsDir()` على جهاز مصاحب مخصّص.
SuiteApkInstaller	تثبيت حِزم APK المحدّدة لإعداد Suite: إما من المتغيّر $ANDROID_TARGET_OUT_TESTCASES أو ROOT_DIR في معلومات الإصدار

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

InstallApexModuleTargetPreparer، ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

ITargetPreparer يثبّت تطبيقًا واحدًا أو أكثر من مجلد IDeviceBuildInfo.getTestsDir() على الجهاز

سيبحث هذا المحضِّر في أدلة بديلة إذا لم يكن ملف zip الخاص بالاختبارات متوفّرًا أو لم يكن يحتوي على حزمة APK المطلوبة. سيتم البحث بالترتيب من آخر دليل بديل تم تحديده إلى أول دليل.

ملخّص

الحقول
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

الإنشاءات العامة
`TestAppInstallSetup()`

الطُرق العامة
`void`	`addInstallArg(String arg)` تضيف هذه السمة وسيطة واحدة لتثبيت حزمة APK سيتم استخدامها.
`void`	`addSplitApkFileNames(String fileNames)` تضيف هذه السمة مجموعة من أسماء الملفات مفصولة بفاصلة (,) في سلسلة ليتم تثبيتها كحِزم APK مقسّمة
`void`	`addTestFile(File file)` تضيف هذه السمة ملفًا أو دليلاً إلى قائمة حِزم APK التي سيتم تثبيتها.
`void`	`addTestFileName(String fileName)` تضيف هذه السمة اسم ملف إلى قائمة حِزم APK التي سيتم تثبيتها.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` تعرِض هذه السمة الجهاز الذي يجب أن ينطبق عليه المُعدّ.
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` تعرض هذه السمة نسخة من قائمة أسماء حِزم APK المحدّدة للاختبار.
`boolean`	`isCleanUpEnabled()` تعرِض هذه السمة القيمة True إذا كان سيتم تنظيف حِزم APK أثناء عملية الإيقاف.
`final boolean`	`isInstantMode()` تعرِض هذه السمة ما إذا كان قد تم تفعيل عملية تثبيت التطبيقات الفورية.
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` يضبط هذا الخيار إصدار أداة AAPT لتحليل حِزم APK.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` اضبط دليلًا بديلاً.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` ضبط سلوكيات دليل بديل
`void`	`setCleanApk(boolean shouldClean)` تُحدّد ما إذا كان يجب محو حزمة APK المثبَّتة عند إيقاف الاختبار.
`void`	`setForceQueryable(boolean forceQueryable)` القيمة التلقائية لـ force queryable هي "صحيح".
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` تحديد ما إذا كان سيتم تفعيل الإعداد التدريجي على أدوات الإعداد في TradeFed.
`final void`	`setInstantMode(boolean mode)` تحدِّد ما إذا كان يجب استخدام الخيار ‎--instant عند تثبيت حزمة APK.
`void`	`setShouldGrantPermission(boolean shouldGrant)` في حال توفير userId، يمكن ضبط grantPermission لتثبيت حزمة APK.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` تم إيقاف هذه الطريقة نهائيًا. معاودة الاتصال المؤقتة المتوافقة مع الإصدارات القديمة
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` إذا كان من المفترض تثبيت حزمة APK لمستخدم معيّن، يتم ضبط معرّف المستخدم الذي سيتم التثبيت له.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

الطُرق المحمية
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` حلّ مسار حزمة APK الفعلي استنادًا إلى معلومات عنصر الاختبار داخل معلومات الإصدار
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` محاولة تثبيت حزمة أو حزمة مقسّمة على الجهاز
`String`	`parsePackageName(File testAppFile)` احصل على اسم الحزمة من تطبيق الاختبار.
	`resolveApkFiles(TestInformation testInfo, apkFiles)` أداة مساعدة لحلّ بعض حزم APK إلى ملفاتها وحزمها
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` محاولة إزالة الحزمة من الجهاز

الحقول

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

الإنشاءات العامة

TestAppInstallSetup

public TestAppInstallSetup ()

الطُرق العامة

addInstallArg

public void addInstallArg (String arg)

تضيف هذه السمة وسيطة واحدة لتثبيت حزمة APK سيتم استخدامها.

المعلمات
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

تضيف هذه السمة مجموعة من أسماء الملفات مفصولة بفاصلة (,) في سلسلة ليتم تثبيتها كحِزم APK مقسّمة

المعلمات
`fileNames`	‫`String`: سلسلة من أسماء الملفات مفصولة بفاصلة (,)

addTestFile

public void addTestFile (File file)

تضيف هذه السمة ملفًا أو دليلاً إلى قائمة حِزم APK التي سيتم تثبيتها.

المعلمات
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

تضيف هذه السمة اسم ملف إلى قائمة حِزم APK المطلوب تثبيتها.

المعلمات
`fileName`	`String`

getAbi

public IAbi getAbi ()

المرتجعات
`IAbi`

getDevice

public ITestDevice getDevice ()

تعرِض هذه السمة الجهاز الذي يجب أن ينطبق عليه المُعدّ.

المرتجعات
`ITestDevice`

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

getTestInfo

public TestInformation getTestInfo ()

المرتجعات
`TestInformation`

getTestsFileName

public  getTestsFileName ()

تعرض هذه السمة نسخة من قائمة أسماء حِزم APK المحدّدة للاختبار.

المرتجعات

isCleanUpEnabled

public boolean isCleanUpEnabled ()

تعرِض هذه السمة القيمة True إذا كان سيتم تنظيف حِزم APK أثناء عملية الإيقاف.

المرتجعات
`boolean`

isInstantMode

public final boolean isInstantMode ()

تعرِض هذه السمة ما إذا كان قد تم تفعيل عملية تثبيت التطبيقات الفورية.

المرتجعات
`boolean`

reportDependencies

public  reportDependencies ()

المرتجعات

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

يضبط هذا الخيار إصدار أداة AAPT لتحليل حِزم APK.

المعلمات
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

المعلمات
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

اضبط دليلًا بديلاً.

المعلمات
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

ضبط سلوكيات دليل بديل

المعلمات
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

تُحدّد ما إذا كان يجب محو حزمة APK المثبَّتة عند إيقاف الاختبار.

المعلمات
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

القيمة التلقائية لـ force queryable هي "صحيح". اضبط القيمة على false إذا كان يجب ألا يكون حزمة APK المطلوب تثبيتها قابلة للاستعلام.

المعلمات
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

تحديد ما إذا كان سيتم تفعيل الإعداد التدريجي على أدوات الإعداد في TradeFed.

المعلمات
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

تحدِّد ما إذا كان يجب استخدام الخيار ‎--instant عند تثبيت حزمة APK. لن يكون لهذا الإعداد أي تأثير في حال ضبط force-install-mode.

المعلمات
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

في حال توفير userId، يمكن ضبط grantPermission لتثبيت حزمة APK.

المعلمات
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

تم إيقاف استخدام هذه الطريقة نهائيًا.
معاودة اتصال مؤقتة متوافقة مع الإصدارات القديمة.

المعلمات
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

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

setUp

public void setUp (TestInformation testInfo)

المعلمات
`testInfo`	`TestInformation`

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

setUserId

public void setUserId (int userId)

إذا كان من المفترض تثبيت حزمة APK لمستخدم معيّن، يتم ضبط معرّف المستخدم الذي سيتم التثبيت له.

المعلمات
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

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

الرميات
`DeviceNotAvailableException`

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

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

حلّ مسار حزمة APK الفعلي استنادًا إلى معلومات عنصر الاختبار داخل معلومات الإصدار

المعلمات
`testInfo`	‫`TestInformation`: `TestInformation` الخاص بالاستدعاء
`apkFileName`	‫`String`: اسم ملف حزمة APK المطلوب تثبيتها

المرتجعات
`File`	`ERROR(/File)` يمثّل ملف APK الفعلي على المضيف أو `null` إذا كان الملف غير متوفّر.

الرميات
`TargetSetupError`

مثبِّت

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

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

المعلمات
`testInfo`	‫`TestInformation`: `TestInformation` للاستدعاء
`appFilesAndPackages`	: حِزم APK وحِزمها المطلوب تثبيتها

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

parsePackageName

protected String parsePackageName (File testAppFile)

احصل على اسم الحزمة من تطبيق الاختبار.

المعلمات
`testAppFile`	`File`

المرتجعات
`String`

الرميات
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

أداة مساعدة لحلّ بعض حزم APK إلى ملفاتها وحزمها

المعلمات
`testInfo`	`TestInformation`
`apkFiles`

المرتجعات

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

setTestInformation

protected void setTestInformation (TestInformation testInfo)

المعلمات
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

محاولة إزالة الحزمة من الجهاز

المعلمات
`device`	`ITestDevice`
`packageName`	`String`

الرميات
`DeviceNotAvailableException`