GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

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

Программа для подготовки целевого устройства, которая прошивает устройство стандартным образом ядра Android. Подробности см. на странице https://source.android.com/devices/architecture/kernel/android-common.

Краткое содержание

Государственные строители

GkiDeviceFlashPreparer ()

Общедоступные методы

void setUp ( TestInformation testInfo)

Выполните настройку целевой системы для тестирования.

void validateGkiBootImg ( ITestDevice device, IBuildInfo buildInfo)

Требуется проверка загрузочного образа GKI.

Защищенные методы

void addHashFooter ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

Требуется проверка загрузочного образа GKI.

void buildGkiSystemDlkmImg ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

Создайте образ GKI system_dlkm, если предоставлен архив system_dlkm.

File extractSystemDlkmTarGzip (File systemDlkmArchive)

Распаковывает архив system_dlkm tar gzip в папку system_dlkm_staging.

void flattenSystemDlkm ( ITestDevice device, File systemDlkmStagingDir)

Сведите к минимуму размер каталога system_dlkm staging, чтобы все модули ядра находились непосредственно в /lib/modules.

String[] getDeviceKernelVersion ( ITestDevice device)

Перед прошивкой получите версию ядра устройства.

IHostOptions getHostOptions ()

Получите ссылку на IHostOptions

String[] getKernelVersionFromImage (File image)

Извлекает версию ядра из файлов образа boot/vendor_boot/system_dlkm/vendor_dlkm.

File getRequestedFile ( ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)

Получите запрошенный файл из исходного файла (zip-архива или папки) по имени запрошенного файла.

IRunUtil getRunUtil ()

Получите экземпляр IRunUtil для использования.

String[] parseKernelVersion (String source, String kernelVersionString)
void validateGkiBootImg ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

Требуется проверка загрузочного образа GKI.

void validateKernelCompatibility (String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)
void validateKernelVersion ( ITestDevice device, IBuildInfo buildInfo, File tmpDir)

Ожидается проверка версий ядра в образах.

Государственные строители

GkiDeviceFlashPreparer 

public GkiDeviceFlashPreparer ()

Общедоступные методы

настраивать 

public void setUp (TestInformation testInfo)

Выполните настройку целевой системы для тестирования.

Параметры
testInfo TestInformation : TestInformation полученная в результате вызова.

Броски
BuildError
DeviceNotAvailableException
TargetSetupError

validateGkiBootImg 

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

Требуется проверка загрузочного образа GKI. (Устарело. Пожалуйста, вызовите функцию, указав tmpDir)

Параметры
device ITestDevice : ITestDevice

buildInfo IBuildInfo : информация о сборке IBuildInfo

Броски
TargetSetupError если отсутствует действительный файл gki boot.img

Защищенные методы

addHashFooter 

protected void addHashFooter (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Ожидается проверка загрузочного образа GKI. В случае отсутствия действительного файла boot.img генерируется исключение.

Параметры
device ITestDevice : ITestDevice

buildInfo IBuildInfo : информация о сборке IBuildInfo

tmpDir File : временный каталог File

Броски
TargetSetupError если отсутствует действительный файл gki boot.img
DeviceNotAvailableException

buildGkiSystemDlkmImg 

protected void buildGkiSystemDlkmImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Создайте образ GKI system_dlkm, если предоставлен архив system_dlkm.

Параметры
device ITestDevice : ITestDevice

buildInfo IBuildInfo : информация о сборке IBuildInfo

tmpDir File : временный каталог File

Броски
TargetSetupError если при создании файла образа возникнет ошибка.

extractSystemDlkmTarGzip 

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

Извлекает архив system_dlkm tar gzip в папку system_dlkm_staging. Эта функция является оберткой над ERROR(/TarUtil.extractTarGzipToTemp) , чтобы имитировать распаковку архива для модульного тестирования.

Параметры
systemDlkmArchive File : архив system_dlkm tar gzip, содержащий модули GKI.

Возвраты
File Файл, содержащий содержимое архива system_dlkm tar gzip.

Броски
java.io.IOException
IOException

flattenSystemDlkm 

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

Сведите структуру каталога system_dlkm staging таким образом, чтобы все модули ядра находились непосредственно в /lib/modules. Это необходимо для соответствия ожидаемой структуре файлов system_dlkm для сборок платформы.

Параметры
device ITestDevice : ITestDevice

systemDlkmStagingDir File : каталог подготовки system_dlkm File

Броски
IOException или TargetSetupError, если произошла ошибка при сглаживании system_dlkm.
TargetSetupError

getDeviceKernelVersion 

protected String[] getDeviceKernelVersion (ITestDevice device)

Перед прошивкой получите версию ядра устройства.

Параметры
device ITestDevice : Объект ITestDevice , с которого нужно получить версию ядра.

Возвраты
String[] ERROR(/String[]) , содержащая разобранную информацию о версии ядра: [kernelVersion, patchLevel, pageSize]. Возвращает null, если строку версии не удается разобрать.2

Броски
DeviceNotAvailableException

getHostOptions 

protected IHostOptions getHostOptions ()

Получите ссылку на IHostOptions

Возвраты
IHostOptions используемые параметры IHostOptions

getKernelVersionFromImage 

protected String[] getKernelVersionFromImage (File image)

Извлекает версию ядра из файлов образа boot/vendor_boot/system_dlkm/vendor_dlkm. Этот метод считывает файл образа boot/vendor_boot/system_dlkm/vendor_dlkm и ищет определенный шаблон в строках, содержащих версию ядра Android. Затем он анализирует найденную строку для извлечения версии ядра в стандартизированном формате.

Параметры
image File : File , содержащий образ загрузки (например, boot.img).

Возвраты
String[] ERROR(/String[]) , содержащая разобранную информацию о версии ядра: [kernelVersion, patchLevel, pageSize]. Возвращает null, если строку версии не удается разобрать.

getRequestedFile 

protected File getRequestedFile (ITestDevice device, 
                String requestedFileName, 
                File sourceFile, 
                File tmpDir)

Получите запрошенный файл из исходного файла (zip-архива или папки) по имени запрошенного файла.

В качестве исходного файла может быть предоставлен ZIP-архив. Метод распакует его во временную директорию и найдет запрошенный файл по указанному имени.

В качестве исходного файла может быть указана папка. Метод найдет запрошенный файл по указанному имени.

Параметры
device ITestDevice : ITestDevice

requestedFileName String : имя запрашиваемого файла.

sourceFile File : исходный файл

tmpDir File

Возвраты
File файл, указанный в запрошенном имени файла.

Броски
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

getRunUtil 

protected IRunUtil getRunUtil ()

Получите экземпляр IRunUtil для использования.

Возвраты
IRunUtil IRunUtil для использования

parseKernelVersion 

protected String[] parseKernelVersion (String source, 
                String kernelVersionString)

Параметры
source String

kernelVersionString String

Возвраты
String[]

validateGkiBootImg 

protected void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Ожидается проверка загрузочного образа GKI. В случае отсутствия действительного файла boot.img генерируется исключение.

Параметры
device ITestDevice : ITestDevice

buildInfo IBuildInfo : информация о сборке IBuildInfo

tmpDir File : временный каталог File

Броски
TargetSetupError если отсутствует действительный файл gki boot.img

validateKernelCompatibility 

protected void validateKernelCompatibility (String imageName, 
                String[] imageVersion, 
                String[] bootVersion, 
                ITestDevice device)

Параметры
imageName String

imageVersion String

bootVersion String

device ITestDevice

Броски
TargetSetupError

validateKernelVersion 

protected void validateKernelVersion (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Убедитесь, что версии ядра в образах соответствуют ожидаемым. В случае несоответствия выдайте исключение.

Параметры
device ITestDevice : ITestDevice

buildInfo IBuildInfo : информация о сборке IBuildInfo

tmpDir File : временный каталог File

Броски
TargetSetupError если отсутствует действительный файл gki boot.img
DeviceNotAvailableException