Để 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 năm 2026. Để tạo và đóng góp cho AOSP, hãy sử dụng android-latest-release. 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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SettingsUtil

public class SettingsUtil
extends Object

java.lang.Object
↳	com.google.android.tradefed.device.SettingsUtil

Một lớp tiện ích có thể thay đổi chế độ cài đặt của thiết bị.

Lớp này tạm thời nằm trong vendor/google vì lớp này dựa vào một cơ chế nguồn mở chưa sẵn sàng để thay đổi các chế độ cài đặt bảo mật. Sau khi có một phương thức nguồn mở an toàn để thay đổi các chế độ cài đặt bảo mật khả dụng, lớp này sẽ được di chuyển sang dự án tradefed cốt lõi

Tóm tắt

Hàm khởi tạo công khai
`SettingsUtil(ITestDevice device)` Hàm khởi tạo mặc định cho SettingsUtil – cung cấp khả năng định cấu hình các chế độ cài đặt phía thiết bị.
`SettingsUtil(ITestDevice device, File settingApk)` Hàm khởi tạo cho phép ghi đè apk mặc định dùng để định cấu hình các chế độ cài đặt thiết bị.

Phương thức công khai
`void`	`changeGlobalSetting(String name, String value)` Thay đổi chế độ cài đặt chung trên thiết bị
`void`	`changeGooglePartnerSetting(String name, String value)` Thay đổi chế độ cài đặt đối tác của Google trên thiết bị
`void`	`changeSecureSetting(String name, String value)` Thay đổi chế độ cài đặt bảo mật trên thiết bị
`void`	`changeSetting(String name, String value)` Thay đổi chế độ cài đặt trên thiết bị
`void`	`installSettingCmdApk()` Cài đặt apk lệnh cài đặt trên thiết bị.
`void`	`overrideGServices(String name, String value)` Ghi đè giá trị gservices trên thiết bị.
`void`	`uninstallSettingCmd()` Gỡ cài đặt apk lệnh cài đặt khỏi thiết bị.

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

SettingsUtil

public SettingsUtil (ITestDevice device)

Hàm khởi tạo mặc định cho SettingsUtil – cung cấp khả năng định cấu hình các chế độ cài đặt phía thiết bị. Một apk mặc định được dùng để định cấu hình các chế độ cài đặt thiết bị và sẽ được chọn dựa trên chữ ký bản dựng của thiết bị.

Tham số
`device`	`ITestDevice`: Thiết bị đang kiểm thử

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

SettingsUtil

public SettingsUtil (ITestDevice device, 
                File settingApk)

Hàm khởi tạo cho phép ghi đè apk mặc định dùng để định cấu hình các chế độ cài đặt thiết bị.

Tham số
`device`	`ITestDevice`: Thiết bị đang kiểm thử
`settingApk`	`File`: Đối tượng tệp tham chiếu đến đường dẫn nơi SettingCmd.apk được lưu trữ. Nếu là giá trị null, sử dụng apk mặc định, được chọn dựa trên chữ ký bản dựng của thiết bị.

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

Phương thức công khai

changeGlobalSetting

public void changeGlobalSetting (String name, 
                String value)

Thay đổi chế độ cài đặt chung trên thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeGooglePartnerSetting

public void changeGooglePartnerSetting (String name, 
                String value)

Thay đổi chế độ cài đặt đối tác của Google trên thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeSecureSetting

public void changeSecureSetting (String name, 
                String value)

Thay đổi chế độ cài đặt bảo mật trên thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

changeSetting

public void changeSetting (String name, 
                String value)

Thay đổi chế độ cài đặt trên thiết bị

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

installSettingCmdApk

public void installSettingCmdApk ()

Cài đặt apk lệnh cài đặt trên thiết bị. Phải thực thi trước khi thực hiện bất kỳ lệnh gọi thay đổi chế độ cài đặt nào được thực hiện.

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

overrideGServices

public void overrideGServices (String name, 
                String value)

Ghi đè giá trị gservices trên thiết bị.

Xin lưu ý rằng thao tác này là không đồng bộ: không có gì đảm bảo rằng giá trị gservices được đặt khi phương thức này trả về.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

uninstallSettingCmd

public void uninstallSettingCmd ()

Gỡ cài đặt apk lệnh cài đặt khỏi thiết bị.

Gửi
`DeviceNotAvailableException`