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

ملخّص

الثوابت

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()

الإجراءات العامة

List<File> 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(List<String> cmd)
void addTimeoutMillisForBundletool(List<String> extraArgs)
void checkApexActivation(ITestDevice device)

تحقَّق مما إذا كانت جميع حزم APEX مفعَّلة.

List<ITestDevice.ApexInfo> collectApexInfoFromApexModules(Map<File, String> testAppFileNames, TestInformation testInfo)

يجمع معلومات apex من وحدات apex لإجراء عملية التحقّق من التفعيل.

List<String> getApkInstalled()
String getBundletoolFileName()
BundletoolUtil getBundletoolUtil()
String getModuleKeywordFromApexPackageName(String packageName)

يحصل على الكلمة الرئيسية (مثل tzdata لـ com.android.tzdata.apex) من اسم حزمة APEX.

List<ITestDevice.ApexInfo> getModulesFailToActivate(Set<ITestDevice.ApexInfo> activatedApexes)

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

List<File> getSplitsForApks(TestInformation testInfo, File moduleFile)

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

void initBundletoolUtil(TestInformation testInfo)

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

void installTrain(TestInformation testInfo, List<File> moduleFilenames)

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

void installUsingBundleTool(TestInformation testInfo, List<File> testAppFileNames)

محاولات تثبيت وحدات رئيسية باستخدام أداة bundletool

void installer(TestInformation testInfo, Map<File, String> 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

Constant Value: ".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 List<File> getModulesToInstall (TestInformation testInfo)

تعرض هذه السمة الوحدات التي يجب تثبيتها على الإصدار التجريبي، استنادًا إلى الوحدات المحمَّلة مسبقًا على الجهاز. لن يتم تثبيت الوحدات التي لم يتم تحميلها مسبقًا.

المعلَمات
testInfo TestInformation: TestInformation
المرتجعات
List<File> قائمة بالوحدات التي يجب تثبيتها على الجهاز.
عمليات الطرح
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 (List<String> cmd)

المعلَمات
cmd List

addTimeoutMillisForBundletool

protected void addTimeoutMillisForBundletool (List<String> extraArgs)

المعلَمات
extraArgs List

checkApexActivation

protected void checkApexActivation (ITestDevice device)

تحقَّق مما إذا كانت جميع حزم APEX مفعَّلة.

المعلَمات
device ‫ITestDevice: قيد الاختبار
عمليات الطرح
TargetSetupError في حال تعذّر إتمام عملية التفعيل
DeviceNotAvailableException

collectApexInfoFromApexModules

protected List<ITestDevice.ApexInfo> collectApexInfoFromApexModules (Map<File, String> testAppFileNames, 
                TestInformation testInfo)

يجمع معلومات apex من وحدات apex لإجراء عملية التحقّق من التفعيل.

المعلَمات
testAppFileNames Map: قائمة بأسماء ملفات الوحدات المطلوب تثبيتها
testInfo TestInformation: TestInformation
المرتجعات
List<ITestDevice.ApexInfo> قائمة تحتوي على apexinfo لوحدات APEX في قوائم الملفات المدخلة
عمليات الطرح
TargetSetupError

getApkInstalled

protected List<String> getApkInstalled ()

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

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 List<ITestDevice.ApexInfo> getModulesFailToActivate (Set<ITestDevice.ApexInfo> activatedApexes)

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

المعلَمات
activatedApexes ‫Set: مجموعة حِزم apex النشطة على الجهاز
المرتجعات
List<ITestDevice.ApexInfo> قائمة تحتوي على معلومات apexinfo الخاصة بوحدات apex التي تعذّر تفعيلها
عمليات الطرح
DeviceNotAvailableException
TargetSetupError

getSplitsForApks

protected List<File> getSplitsForApks (TestInformation testInfo, 
                File moduleFile)

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

المعلَمات
testInfo TestInformation: TestInformation
moduleFile File: ملف الوحدة الذي سيتم استخراج عمليات التقسيم منه
المرتجعات
List<File> File[] يحتوي على عمليات التقسيم.
عمليات الطرح
TargetSetupError في حال تعذُّر العثور على bundletool أو تعذُّر إنشاء ملف مواصفات الجهاز

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

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

المعلَمات
testInfo TestInformation: TestInformation للاستدعاء
عمليات الطرح
TargetSetupError في حال تعذّر العثور على bundletool

installTrain

protected void installTrain (TestInformation testInfo, 
                List<File> moduleFilenames)

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

المعلَمات
testInfo TestInformation: TestInformation
moduleFilenames ‫List: قائمة السلسلة قائمة بأسماء ملفات الوحدات الرئيسية التي سيتم تثبيتها.
عمليات الطرح
DeviceNotAvailableException
TargetSetupError

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                List<File> testAppFileNames)

محاولات تثبيت وحدات رئيسية باستخدام أداة bundletool

المعلَمات
testInfo TestInformation: TestInformation
testAppFileNames List: أسماء ملفات الوحدات التي تم تحميلها مسبقًا لتثبيتها
عمليات الطرح
DeviceNotAvailableException
TargetSetupError

مثبِّت

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

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

المعلَمات
testInfo TestInformation: TestInformation الخاص بالاستدعاء
testAppFileNames Map: حِزم 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 تحليل الملف