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

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

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 المحدّدة لإعداد "مجموعة التطبيقات": إمّا من المتغيّر $ANDROID_TARGET_OUT_TESTCASES أو ROOT_DIR في معلومات الإنشاء

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

InstallApexModuleTargetPreparer وModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

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

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

ملخّص

الحقول
`protected IncrementalInstallSession`	`incrementalInstallSession`
`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 المثبَّتة عند tearDown
`void`	`setForceQueryable(boolean forceQueryable)` القيمة التلقائية لسمة force queryable هي true.
`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)`

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

الحقول

incrementalInstallSession

protected IncrementalInstallSession incrementalInstallSession

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 المثبَّتة عند tearDown

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

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

القيمة التلقائية لسمة force queryable هي true. عدِّل هذا الخيار إلى false إذا كان لا يجب أن يكون apk الذي سيتم تثبيته قابلاً للبحث.

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

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

حدِّد ما إذا كنت تريد تفعيل الإعداد المتزايد في إعدادات مستخدمي TradeFed.

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

setInstantMode

public final void setInstantMode (boolean mode)

لتحديد ما إذا كان يجب استخدام الخيار --instant أم لا عند تثبيت حزمة apk. لن يكون له أي تأثير في حال تم ضبط وضع التثبيت الإجباري.

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

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

getIncrementalInstallSessionBuilder

protected IncrementalInstallSession.Builder getIncrementalInstallSessionBuilder ()

يمكنك بدء أداة إنشاء الجلسات لتثبيت تطبيق اختباري بشكل تدريجي.

المرتجعات
`IncrementalInstallSession.Builder`

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

حلّ مسار apk الفعلي استنادًا إلى معلومات اختبار العناصر داخل معلومات الإنشاء

المعلمات
`testInfo`	‫`TestInformation`: `TestInformation` للطلب
`apkFileName`	`String`: اسم ملف APK المطلوب تثبيته

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

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

installPackageIncrementally

protected void installPackageIncrementally (IncrementalInstallSession.Builder builder)

ابدأ جلسة التثبيت المتزايد لتطبيق تجريبي.

المعلمات
`builder`	`IncrementalInstallSession.Builder`: عنصر Builder لجلسة التثبيت المتزايد.

عمليات الرمي
	com.android.tradefed.targetprep.TargetSetupError
`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`