TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

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

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

ملخّص

الثوابت

String INSTALLED_PACKAGES_KEY

مفتاح لسمة TestInformation تحتوي على قائمة قيم مفصولة بفاصلة تتضمّن أسماء حِزم 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()
List<File> getTestsFileName()

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

boolean isCleanUpEnabled()

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

final boolean isInstantMode()

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

Set<String> reportDependencies()
void setAaptVersion(AaptParser.AaptVersion aaptVersion)

تضبط هذه السمة إصدار "أداة معالجة أصول Android" (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, Map<File, String> appFilesAndPackages)

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

String parsePackageName(File testAppFile)

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

Map<File, String> resolveApkFiles(TestInformation testInfo, List<File> apkFiles)

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

void setTestInformation(TestInformation testInfo)
void uninstallPackage(ITestDevice device, String packageName)

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

الثوابت

INSTALLED_PACKAGES_KEY

public static final String INSTALLED_PACKAGES_KEY

مفتاح لسمة TestInformation تحتوي على قائمة قيم مفصولة بفاصلة تتضمّن أسماء حِزم APK المثبَّتة. يتم استخدام هذا الحقل لإبلاغ معدّي التقارير الآخرين، مثل RunOnSecondaryUserTargetPreparer، بقائمة الحِزم المثبَّتة.

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

الحقول

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 List<File> getTestsFileName ()

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

المرتجعات
List<File>

isCleanUpEnabled

public boolean isCleanUpEnabled ()

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

المرتجعات
boolean

isInstantMode

public final boolean isInstantMode ()

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

المرتجعات
boolean

reportDependencies

public Set<String> reportDependencies ()

المرتجعات
Set<String>

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 File يمثّل ملف APK الفعلي على المضيف أو null إذا كان الملف غير متوفّر.
عمليات الطرح
TargetSetupError

مثبِّت

protected void installer (TestInformation testInfo, 
                Map<File, String> appFilesAndPackages)

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

المعلَمات
testInfo TestInformation: TestInformation الخاص بالاستدعاء
appFilesAndPackages Map: حِزم APK وحِزمها التي سيتم تثبيتها
عمليات الطرح
DeviceNotAvailableException
TargetSetupError

parsePackageName

protected String parsePackageName (File testAppFile)

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

المعلَمات
testAppFile File

القيم المُعادة
String

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

resolveApkFiles

protected Map<File, String> resolveApkFiles (TestInformation testInfo, 
                List<File> apkFiles)

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

المعلَمات
testInfo TestInformation

apkFiles List

القيم المُعادة
Map<File, String>

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

setTestInformation

protected void setTestInformation (TestInformation testInfo)

المعلَمات
testInfo TestInformation

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

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

المعلَمات
device ITestDevice

packageName String

عمليات الطرح
DeviceNotAvailableException