Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

TestAppInstallSetup

public class TestAppInstallSetup
extends BaseTargetPreparer implements IAbiReceiver, IDiscoverDependencies, IIncrementalSetup

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

Các lớp con trực tiếp đã biết

CompanionTestAppInstallSetup, SuiteApkInstaller

CompanionTestAppInstallSetup	Một `ITargetPreparer` cài đặt một hoặc nhiều ứng dụng từ thư mục `IDeviceBuildInfo.getTestsDir()` vào một thiết bị đồng hành được phân bổ.
SuiteApkInstaller	Cài đặt các APK được chỉ định cho cấu hình Suite: từ biến $ANDROID_TARGET_OUT_TESTCASES hoặc ROOT_DIR trong thông tin bản dựng.

Các lớp con gián tiếp đã biết

InstallApexModuleTargetPreparer, ModuleOemTargetPreparer

InstallApexModuleTargetPreparer
ModuleOemTargetPreparer

Một ITargetPreparer cài đặt một hoặc nhiều ứng dụng từ thư mục IDeviceBuildInfo.getTestsDir() vào thiết bị.

Trình chuẩn bị này sẽ tìm trong các thư mục thay thế nếu tệp zip kiểm thử không tồn tại hoặc không chứa tệp apk bắt buộc. Quá trình tìm kiếm sẽ diễn ra theo thứ tự từ thư mục thay thế cuối cùng được chỉ định đến thư mục đầu tiên.

Tóm tắt

Trường
`protected double`	`mBlockFilterPercentage`
`protected int`	`mIncrementalInstallTimeout`
`protected boolean`	`mIncrementalInstallation`

Hàm khởi tạo công khai
`TestAppInstallSetup()`

Phương thức công khai
`void`	`addInstallArg(String arg)` Thêm một đối số cài đặt apk sẽ được dùng.
`void`	`addSplitApkFileNames(String fileNames)` Thêm một nhóm tên tệp được phân chia bằng dấu "," trong một chuỗi sẽ được cài đặt dưới dạng các APK tách
`void`	`addTestFile(File file)` Thêm một tệp hoặc thư mục vào danh sách các apk cần cài đặt.
`void`	`addTestFileName(String fileName)` Thêm tên tệp vào danh sách apk cần cài đặt.
`IAbi`	`getAbi()`
`ITestDevice`	`getDevice()` Trả về thiết bị mà trình chuẩn bị sẽ áp dụng.
`TestInformation`	`getTestInfo()`
	`getTestsFileName()` Trả về bản sao của danh sách tên tệp APK kiểm thử đã chỉ định.
`boolean`	`isCleanUpEnabled()` Trả về True nếu các APK sẽ được dọn dẹp trong quá trình tháo gỡ.
`final boolean`	`isInstantMode()` Trả về trạng thái bật hay tắt chế độ cài đặt tức thì.
	`reportDependencies()`
`void`	`setAaptVersion(AaptParser.AaptVersion aaptVersion)` Đặt phiên bản AAPT để phân tích cú pháp APK.
`void`	`setAbi(IAbi abi)`
`void`	`setAltDir(File altDir)` Đặt một thư mục thay thế.
`void`	`setAltDirBehavior(AltDirBehavior altDirBehavior)` Đặt hành vi thư mục thay thế.
`void`	`setCleanApk(boolean shouldClean)` Đặt xem có nên dọn dẹp apk đã cài đặt trên tearDown hay không
`void`	`setForceQueryable(boolean forceQueryable)` Giá trị mặc định của force queryable là true.
`void`	`setIncrementalSetupEnabled(boolean shouldEnable)` Đặt xem có bật chế độ thiết lập gia tăng trên trình chuẩn bị TradeFed hay không.
`final void`	`setInstantMode(boolean mode)` Đặt xem có nên dùng --instant khi cài đặt apk hay không.
`void`	`setShouldGrantPermission(boolean shouldGrant)` Nếu bạn cung cấp userId, thì bạn có thể đặt grantPermission cho quá trình cài đặt apk.
`void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` Phương thức này không được dùng nữa. Lệnh gọi lại tạm thời có khả năng tương thích ngược.
`void`	`setUp(TestInformation testInfo)`
`void`	`setUserId(int userId)` Nếu cần cài đặt apk cho một người dùng cụ thể, hãy đặt mã nhận dạng của người dùng cần cài đặt.
`void`	`tearDown(TestInformation testInfo, Throwable e)`

Phương thức được bảo vệ
`File`	`getLocalPathForFilename(TestInformation testInfo, String apkFileName)` Phân giải đường dẫn thực tế của tệp apk dựa trên thông tin về cấu phần phần mềm kiểm thử trong thông tin bản dựng.
`void`	`installer(TestInformation testInfo, appFilesAndPackages)` Thử cài đặt một gói hoặc gói chia tách trên thiết bị.
`String`	`parsePackageName(File testAppFile)` Lấy tên gói từ ứng dụng kiểm thử.
	`resolveApkFiles(TestInformation testInfo, apkFiles)` Trợ lý giúp phân giải một số apk thành Tệp và Gói tương ứng.
`void`	`setTestInformation(TestInformation testInfo)`
`void`	`uninstallPackage(ITestDevice device, String packageName)` Tìm cách tháo gói này ra khỏi thiết bị.

Trường

mBlockFilterPercentage

protected double mBlockFilterPercentage

mIncrementalInstallTimeout

protected int mIncrementalInstallTimeout

mIncrementalInstallation

protected boolean mIncrementalInstallation

Hàm khởi tạo công khai

TestAppInstallSetup

public TestAppInstallSetup ()

Phương thức công khai

addInstallArg

public void addInstallArg (String arg)

Thêm một đối số cài đặt apk sẽ được dùng.

Tham số
`arg`	`String`

addSplitApkFileNames

public void addSplitApkFileNames (String fileNames)

Thêm một nhóm tên tệp được phân chia bằng dấu "," trong một chuỗi sẽ được cài đặt dưới dạng các APK tách

Tham số
`fileNames`	`String`: một chuỗi tên tệp được phân chia bằng dấu ","

addTestFile

public void addTestFile (File file)

Thêm một tệp hoặc thư mục vào danh sách các apk cần cài đặt.

Tham số
`file`	`File`

addTestFileName

public void addTestFileName (String fileName)

Thêm tên tệp vào danh sách apk cần cài đặt.

Tham số
`fileName`	`String`

getAbi

public IAbi getAbi ()

Giá trị trả về
`IAbi`

getDevice

public ITestDevice getDevice ()

Trả về thiết bị mà trình chuẩn bị sẽ áp dụng.

Giá trị trả về
`ITestDevice`

Gửi
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getTestInfo

public TestInformation getTestInfo ()

Giá trị trả về
`TestInformation`

getTestsFileName

public  getTestsFileName ()

Trả về bản sao của danh sách tên tệp APK kiểm thử đã chỉ định.

Giá trị trả về

isCleanUpEnabled

public boolean isCleanUpEnabled ()

Trả về True nếu các APK sẽ được dọn dẹp trong quá trình tháo gỡ.

Giá trị trả về
`boolean`

isInstantMode

public final boolean isInstantMode ()

Trả về trạng thái bật hay tắt chế độ cài đặt tức thì.

Giá trị trả về
`boolean`

reportDependencies

public  reportDependencies ()

Giá trị trả về

setAaptVersion

public void setAaptVersion (AaptParser.AaptVersion aaptVersion)

Đặt phiên bản AAPT để phân tích cú pháp APK.

Tham số
`aaptVersion`	`AaptParser.AaptVersion`

setAbi

public void setAbi (IAbi abi)

Tham số
`abi`	`IAbi`

setAltDir

public void setAltDir (File altDir)

Đặt một thư mục thay thế.

Tham số
`altDir`	`File`

setAltDirBehavior

public void setAltDirBehavior (AltDirBehavior altDirBehavior)

Đặt hành vi thư mục thay thế.

Tham số
`altDirBehavior`	`AltDirBehavior`

setCleanApk

public void setCleanApk (boolean shouldClean)

Đặt xem có nên dọn dẹp apk đã cài đặt trên tearDown hay không

Tham số
`shouldClean`	`boolean`

setForceQueryable

public void setForceQueryable (boolean forceQueryable)

Giá trị mặc định của force queryable là true. Cập nhật thành false nếu không truy vấn được apk cần cài đặt.

Tham số
`forceQueryable`	`boolean`

setIncrementalSetupEnabled

public void setIncrementalSetupEnabled (boolean shouldEnable)

Đặt xem có bật chế độ thiết lập gia tăng trên trình chuẩn bị TradeFed hay không.

Tham số
`shouldEnable`	`boolean`

setInstantMode

public final void setInstantMode (boolean mode)

Đặt xem có nên dùng --instant khi cài đặt apk hay không. Sẽ không có hiệu lực nếu bạn đặt force-install-mode.

Tham số
`mode`	`boolean`

setShouldGrantPermission

public void setShouldGrantPermission (boolean shouldGrant)

Nếu bạn cung cấp userId, thì bạn có thể đặt grantPermission cho quá trình cài đặt apk.

Tham số
`shouldGrant`	`boolean`

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Phương thức này không được dùng nữa.
Lệnh gọi lại tạm thời có khả năng tương thích ngược.

Tham số
`device`	`ITestDevice`
`buildInfo`	`IBuildInfo`

Gửi
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUp

public void setUp (TestInformation testInfo)

Tham số
`testInfo`	`TestInformation`

Gửi
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUserId

public void setUserId (int userId)

Nếu cần cài đặt apk cho một người dùng cụ thể, hãy đặt mã nhận dạng của người dùng cần cài đặt.

Tham số
`userId`	`int`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Tham số
`testInfo`	`TestInformation`
`e`	`Throwable`

Gửi
`DeviceNotAvailableException`

Phương thức được bảo vệ

getLocalPathForFilename

protected File getLocalPathForFilename (TestInformation testInfo, 
                String apkFileName)

Phân giải đường dẫn thực tế của tệp apk dựa trên thông tin về cấu phần phần mềm kiểm thử trong thông tin bản dựng.

Tham số
`testInfo`	`TestInformation`: `TestInformation` cho lệnh gọi.
`apkFileName`	`String`: tên tệp của apk cần cài đặt

Giá trị trả về
`File`	`ERROR(/File)` đại diện cho tệp apk thực trên máy chủ lưu trữ hoặc `null` nếu tệp không tồn tại.

Gửi
`TargetSetupError`

trình cài đặt

protected void installer (TestInformation testInfo, 
                 appFilesAndPackages)

Thử cài đặt một gói hoặc gói chia tách trên thiết bị.

Tham số
`testInfo`	`TestInformation`: `TestInformation` cho lệnh gọi
`appFilesAndPackages`	: Các tệp APK và gói cần cài đặt.

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

parsePackageName

protected String parsePackageName (File testAppFile)

Lấy tên gói từ ứng dụng kiểm thử.

Tham số
`testAppFile`	`File`

Giá trị trả về
`String`

Gửi
`TargetSetupError`

resolveApkFiles

protected  resolveApkFiles (TestInformation testInfo, 
                 apkFiles)

Trợ lý giúp phân giải một số apk thành Tệp và Gói tương ứng.

Tham số
`testInfo`	`TestInformation`
`apkFiles`

Giá trị trả về

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

setTestInformation

protected void setTestInformation (TestInformation testInfo)

Tham số
`testInfo`	`TestInformation`

uninstallPackage

protected void uninstallPackage (ITestDevice device, 
                String packageName)

Tìm cách tháo gói này ra khỏi thiết bị.

Tham số
`device`	`ITestDevice`
`packageName`	`String`

Gửi
`DeviceNotAvailableException`