IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Nâng cấp lên một hình ảnh thiết bị trên thiết bị.

Tóm tắt

Phương thức công khai

default boolean checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild)

Kiểm tra xem có xảy ra trường hợp chống quay về phiên bản cũ hay không.

abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

Truyền nhanh bản dựng trên thiết bị.

default Set<String> getAdditionalFileFilters()

Nhận bộ lọc cho các cấu phần phần mềm bản dựng bổ sung.

abstract CommandStatus getSystemFlashingStatus()

Truy xuất trạng thái thực thi lệnh để nhấp nháy các phân vùng hệ thống chính.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Cho biết liệu hình ảnh dữ liệu người dùng có được flash, xoá hay giữ lại hay không

abstract void overrideDeviceOptions(ITestDevice device)

Các lựa chọn ghi đè cho một thiết bị.

default void postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Tất cả các thao tác dọn dẹp và kiểm tra phải diễn ra sau khi thực sự nhấp nháy phần quan trọng.

default void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Tất cả các thao tác thiết lập và kiểm tra phải diễn ra trước khi thực sự nhấp nháy phần quan trọng.

abstract void setDataWipeSkipList(Collection<String> dataWipeSkipList)

Đặt danh sách các đường dẫn trong /data để tránh bị xoá khi sử dụng ITestsZipInstaller

Xin lưu ý rằng mức độ chi tiết của danh sách bỏ qua là phần tử con trực tiếp của /data.

default void setExtraMetadata(Map<String, String> metadata)

Cho phép trình nạp phần mềm nhận các lựa chọn siêu dữ liệu bổ sung.

abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Đặt cơ chế mà trình nhấp nháy có thể truy xuất các tệp tài nguyên để nhấp nháy.

abstract void setForceSystemFlash(boolean forceSystemFlash)

Đặt xem hệ thống có luôn được flash hay không, ngay cả khi đang chạy bản dựng hiện tại

default void setRamdiskPartition(String ramdiskPartition)

Đặt phân vùng ramdisk

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

Đặt xem có nên cài đặt một ramdisk bổ sung sau khi cập nhật thiết bị thông qua tệp zip hình ảnh hay không

abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Chuyển đổi xem hình ảnh dữ liệu người dùng có được flash, xoá hay giữ lại hay không

abstract void setWipeTimeout(long timeout)

Đặt thời gian chờ để xoá dữ liệu.

default boolean shouldFlashRamdisk()

Kiểm tra xem trình nhấp nháy có được thiết lập để có thêm ramdisk hay không, cần nhấp nháy sau khi cập nhật thiết bị thông qua tệp zip hình ảnh

default boolean supportsFlashingInFastbootD()

Liệu thiết bị triển khai trình nạp có thể được nạp trong chế độ fastbootd hay không.

default void tearDownFlasher()

Cơ hội cuối cùng để quá trình triển khai trình nhấp nháy tự dọn dẹp

Phương thức công khai

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Kiểm tra xem có xảy ra trường hợp chống quay về phiên bản cũ hay không.

Tham số
device ITestDevice

deviceBuild IDeviceBuildInfo

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Truyền nhanh bản dựng trên thiết bị.

Trả về ngay sau khi quá trình nhấp nháy hoàn tất. Người gọi nên đợi thiết bị trực tuyến và có sẵn trước khi tiếp tục kiểm thử.

Tham số
device ITestDevice: ITestDevice để cài đặt ROM

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo để cài đặt ROM

Gửi
DeviceNotAvailableException nếu thiết bị không phản hồi
TargetSetupError nếu không flash được bản dựng

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

Nhận bộ lọc cho các cấu phần phần mềm bản dựng bổ sung.

Một số trình nạp cần các cấu phần phần mềm nhất định không nằm trong số các cấu phần phần mềm mặc định được dùng. Những người chạy chương trình như vậy nên ghi đè phương thức này, để mọi người dùng công cụ chạy chương trình không cần biết về các tệp này và cung cấp các lựa chọn dòng lệnh.

Xin lưu ý rằng phương thức này được gọi trên một phiên bản tạm thời của IDeviceFlasher, vì vậy, bạn không nên dựa vào trạng thái nào khác ngoài trạng thái được cung cấp trong hàm khởi tạo mặc định.

Các chuỗi trong Tập hợp được diễn giải dưới dạng mẫu tệp và tất cả các tệp khớp với mẫu sẽ được truy xuất.

Theo mặc định, phương thức này trả về một Tập hợp trống.

Giá trị trả về
Set<String>

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Truy xuất trạng thái thực thi lệnh để nhấp nháy các phân vùng hệ thống chính.

Xin lưu ý rằng nếu các phân vùng hệ thống không được flash (hệ thống đã có bản dựng cần flash), thì trạng thái lệnh có thể là null

Giá trị trả về
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Cho biết liệu hình ảnh dữ liệu người dùng có được flash, xoá hay giữ lại hay không

Giá trị trả về
IDeviceFlasher.UserDataFlashOption Có nên xoá, ghi đè hoặc giữ lại hình ảnh dữ liệu người dùng hay không

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Các lựa chọn ghi đè cho một thiết bị. Dùng để ghi đè các giá trị lựa chọn mặc định nếu một thiết bị cụ thể không hỗ trợ các giá trị mặc định.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Tất cả các thao tác dọn dẹp và kiểm tra phải diễn ra sau khi thực sự nhấp nháy phần quan trọng. Không có thao tác nào trong số đó được đưa vào phần quan trọng được kiểm soát đồng thời.

Tham số
device ITestDevice: ITestDevice để cài đặt ROM

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo để cài đặt ROM

Gửi
DeviceNotAvailableException nếu thiết bị không phản hồi
TargetSetupError nếu có bất kỳ chế độ thiết lập nào không thành công

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Tất cả các thao tác thiết lập và kiểm tra phải diễn ra trước khi thực sự nhấp nháy phần quan trọng. Không có thao tác nào trong số đó được đưa vào phần quan trọng được kiểm soát đồng thời.

Tham số
device ITestDevice: ITestDevice để cài đặt ROM

deviceBuild IDeviceBuildInfo: IDeviceBuildInfo để cài đặt ROM

Gửi
DeviceNotAvailableException nếu thiết bị không phản hồi
TargetSetupError nếu có bất kỳ chế độ thiết lập nào không thành công

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

Đặt danh sách các đường dẫn trong /data để tránh bị xoá khi dùng ITestsZipInstaller

Xin lưu ý rằng mức độ chi tiết của danh sách bỏ qua là phần tử con trực tiếp của /data.

Tham số
dataWipeSkipList Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

Cho phép trình nạp phần mềm nhận các lựa chọn siêu dữ liệu bổ sung.

Tham số
metadata Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Đặt cơ chế mà trình nhấp nháy có thể truy xuất các tệp tài nguyên để nhấp nháy.

Tham số
retriever IFlashingResourcesRetriever: IFlashingResourcesRetriever cần sử dụng

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Đặt xem hệ thống có luôn được flash hay không, ngay cả khi đang chạy bản dựng hiện tại

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Đặt phân vùng ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Đặt xem có nên cài đặt một ramdisk bổ sung sau khi cập nhật thiết bị thông qua tệp zip hình ảnh hay không

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Chuyển đổi xem hình ảnh dữ liệu người dùng có được flash, xoá hay giữ lại hay không

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Đặt thời gian chờ để xoá dữ liệu.

Tham số
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Kiểm tra xem trình nhấp nháy có được thiết lập để có thêm ramdisk hay không, cần nhấp nháy sau khi cập nhật thiết bị thông qua tệp zip hình ảnh

Giá trị trả về
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Liệu thiết bị triển khai trình nạp có thể được nạp trong chế độ fastbootd hay không.

Giá trị trả về
boolean

tearDownFlasher

public void tearDownFlasher ()

Cơ hội cuối cùng để quá trình triển khai trình nhấp nháy tự dọn dẹp