החל מ-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 util לכיתה הזו.
`void`	`installTrain(TestInformation testInfo, moduleFilenames, String[] extraArgs)` ניסיון להתקין במכשיר רכבת ראשית שמכילה את apex.
`void`	`installUsingBundleTool(TestInformation testInfo, testAppFileNames)` ניסיון להתקין מודולים של mainline באמצעות 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`: קובץ המודול שממנו רוצים לחלץ את החלוקות.

החזרות
	מערך של קובצי File[] שמכיל את החלוקות.

זריקות
`TargetSetupError`	אם לא ניתן למצוא את bundletool או אם יצירת קובץ מפרט המכשיר נכשלה.

initBundletoolUtil

protected void initBundletoolUtil (TestInformation testInfo)

הפונקציה מאתחלת את ה-bundletool util לכיתה הזו.

פרמטרים
`testInfo`	`TestInformation`: ה-`TestInformation` של הקריאה.

זריקות
`TargetSetupError`	אם לא ניתן למצוא את bundletool.

installTrain

protected void installTrain (TestInformation testInfo, 
                 moduleFilenames, 
                String[] extraArgs)

ניסיון להתקין במכשיר רכבת ראשית שמכילה את apex.

פרמטרים
`testInfo`	`TestInformation`: `TestInformation`
`moduleFilenames`	: רשימה של מחרוזות. רשימת שמות הקבצים של המודולים הראשיים שרוצים להתקין.
`extraArgs`	`String`

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

installUsingBundleTool

protected void installUsingBundleTool (TestInformation testInfo, 
                 testAppFileNames)

ניסיון להתקין מודולים של mainline באמצעות 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`: קובץ ה-apex שממנו אנחנו אוספים מידע.
`deviceDescriptor`	`DeviceDescriptor`

החזרות
`ITestDevice.ApexInfo`	`ApexInfo` שמכיל את packageName ואת versionCode של הקובץ הנתון

זריקות
`TargetSetupError`	אם מנתח aapt נכשל לנתח את הקובץ.