החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

מחלקות משנה ישירות ידועות

‫CompanionTestAppInstallSetup, ‏ CompatTargetPreparer, ‏ SuiteApkInstaller

CompanionTestAppInstallSetup	`ITargetPreparer` שמתקין אפליקציה אחת או יותר מתיקייה `IDeviceBuildInfo.getTestsDir()` במכשיר נלווה שהוקצה.
CompatTargetPreparer	`ITargetPreparer` שמכין את המכשיר להרצת בדיקות תאימות.
SuiteApkInstaller	מתקין חבילות APK שצוינו להגדרת החבילה: מתוך המשתנה ‎ $ANDROID_TARGET_OUT_TESTCASES או מתוך ROOT_DIR בפרטי הבנייה.

מחלקות משנה לא ישירות מוכרות

‫InstallApexModuleTargetPreparer, ‏ ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

ITargetPreparer שמתקין אפליקציה אחת או יותר מתיקייה IDeviceBuildInfo.getTestsDir() במכשיר.

הכלי הזה יחפש בספריות חלופיות אם קובץ ה-ZIP של הבדיקות לא קיים או לא מכיל את קובץ ה-APK הנדרש. החיפוש יתבצע לפי הסדר, מהספרייה החלופית האחרונה שצוינה לספרייה הראשונה.

סיכום

ערכים קבועים
`String`	`INSTALLED_PACKAGES_KEY` המפתח של מאפיין `TestInformation` שמכיל רשימה מופרדת בפסיקים של שמות חבילות של קובצי APK מותקנים.

שדות
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

‫constructors ציבוריים
`TestAppInstallSetup()`

‫methods ציבוריים
`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()` הפונקציה מחזירה את הערך true אם ההתקנה במצב מיידי הופעלה, אחרת היא מחזירה את הערך false.
`Set<String>`	`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 preparers.
`final void`	`setInstantMode(boolean mode)` מגדיר אם להשתמש באפשרות ‎--instant כשמתקינים את ה-APK.
`void`	`setShouldGrantPermission(boolean shouldGrant)` אם מסופק userId, אפשר להגדיר את grantPermission להתקנת ה-APK.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` השיטה הזו הוצאה משימוש. קריאה חוזרת (callback) זמנית שתואמת לדורות קודמים.
`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

‫constructors ציבוריים

TestAppInstallSetup

public TestAppInstallSetup ()

‫methods ציבוריים

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`

הקפצת הודעות שגיאה (throw)
	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 ()

הפונקציה מחזירה את הערך true אם ההתקנה במצב מיידי הופעלה, אחרת היא מחזירה את הערך false.

החזרות
`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 המותקן במהלך tearDown

פרמטרים
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

ערך ברירת המחדל של force queryable הוא true. אם לא רוצים שאפשר יהיה לשלוח שאילתות לגבי קובץ ה-APK שרוצים להתקין, צריך לעדכן את הערך ל-false.

פרמטרים
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

הגדרה של הפעלה או השבתה של הגדרה מצטברת ב-TradeFed preparers.

פרמטרים
`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`

הקפצת הודעות שגיאה (throw)
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

פרמטרים
`testInfo`	`TestInformation`

הקפצת הודעות שגיאה (throw)
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

אם קובץ ה-APK צריך להיות מותקן עבור משתמש מסוים, צריך להגדיר את מזהה המשתמש שרוצים להתקין עבורו.

פרמטרים
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

פרמטרים
`testInfo`	`TestInformation`
`e`	`Throwable`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

שיטות מוגנות

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

פתרון נתיב ה-APK בפועל על סמך מידע על ארטיפקט הבדיקה בתוך פרטי הבנייה.

פרמטרים
`testInfo`	‫`TestInformation`: ה-`TestInformation` של הקריאה.
`apkFileName`	‫`String`: שם הקובץ של ה-APK להתקנה

החזרות
`File`	‫`File` שמייצג את קובץ ה-APK הפיזי במארח, או `null` אם הקובץ לא קיים.

הקפצת הודעות שגיאה (throw)
`TargetSetupError`

מתקין

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

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

פרמטרים
`testInfo`	‫`TestInformation`: ה-`TestInformation` של הקריאה
`appFilesAndPackages`	‫`Map`: קובצי ה-APK והחבילה שלהם שרוצים להתקין.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

מקבלים את שם החבילה מאפליקציית הבדיקה.

פרמטרים
`testAppFile`	`File`

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`TargetSetupError`

resolveApkFiles

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

כלי עזר לפתרון בעיות שקשורות לקובץ ולחבילה של apk.

פרמטרים
`testInfo`	`TestInformation`
`apkFiles`	`List`

החזרות
`Map<File, String>`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

פרמטרים
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

מנסים להסיר את החבילה מהמכשיר.

פרמטרים
`device`	`ITestDevice`
`packageName`	`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`