Общие образы системы

Общий образ системы (GSI) — это образ системы с настроенными конфигурациями для устройств Android. Он считается чистой реализацией Android с немодифицированным кодом Android Open Source Project (AOSP), который может успешно работать на любом устройстве Android под управлением Android 9 или более поздней версии.

GSI используются для запуска тестов VTS и CTS-on-GSI. Образ системы Android-устройства заменяется GSI, а затем тестируется с помощью Vendor Test Suite (VTS) и Compatibility Test Suite (CTS) , чтобы убедиться, что устройство правильно реализует интерфейсы поставщиков с последней версией Android.

Чтобы приступить к работе с GSI, ознакомьтесь со следующими разделами для получения подробной информации о конфигурациях (и допустимых отклонениях) и типах GSI. Когда вы будете готовы использовать GSI, загрузите и создайте GSI для вашего целевого устройства, а затем прошейте GSI на устройстве Android.

Конфигурация и отличия GSI

Текущий Android GSI имеет следующую конфигурацию:

Текущий GSI для Android включает следующие основные отличия:

  • Архитектура процессора. Поддержка различных инструкций ЦП (ARM, x86 и т. д.) и разрядности ЦП (32-битная или 64-битная).

Цели GSI для испытаний на соответствие требованиям Treble

GSI, используемый для проверки соответствия, определяется версией Android, с которой запускается устройство.

Тип устройства Создать цель
Устройства, запускаемые с Android 12 gsi_$arch-user (подписано)
Устройства, запускаемые с Android 11 gsi_$arch-user (подписано)
Устройства, запускаемые с Android 10 gsi_$arch-user (подписано)
Устройства, запускаемые с Android 9 gsi_$arch-userdebug

Все GSI создаются на основе кодовой базы Android 12, и каждая архитектура ЦП имеет соответствующий двоичный файл GSI (см. список целей сборки в разделе Создание GSI ).

Изменения GSI в Android 12

Устройства, запускаемые с Android 12 или обновленные до нее, должны использовать GSI Android 12 для тестирования на соответствие требованиям. Это включает в себя следующие основные изменения по сравнению с более ранними GSI:

  • Имя цели. Имя цели GSI для тестов на соответствие изменено на gsi_$arch . GSI с целевым именем aosp_$arch хранится для разработчиков приложений Android. План тестирования CTS-on-GSI также сокращен для тестирования интерфейса поставщика.
  • Устаревший GSI прекращает свое существование. GSI 12 удаляет обходные пути для устройств Android 8.0 или 8.1, которые не полностью Treblized.
  • Пользовательская отладка SEPolicy. GSI gsi_$arch содержит userdebug_plat_sepolicy.cil . При прошивке специфичных для OEM-производителей vendor_boot-debug.img или boot-debug.img /system/bin/init загрузит userdebug_plat_sepolicy.cil из GSI system.img . Подробности см. в разделе Тестирование VTS с отладкой Ramdisk .

Изменения GSI в Android 11

Устройства, запускаемые с Android 11 или обновленные до нее, должны использовать GSI Android 11 для тестирования на соответствие требованиям. Это включает в себя следующие основные изменения по сравнению с более ранними GSI:

  • содержимое system_ext. Android 11 определяет новый раздел system_ext . GSI помещает содержимое системного расширения в папку system/system_ext .
  • АПЕКСы. GSI содержит как сглаженные, так и сжатые APEX. Какой из них использовать, определяется системным свойством ro.apex.updatable в разделе поставщика во время выполнения. Ссылка Настройка системы для поддержки обновлений APEX для подробностей.

Изменения GSI в Android 10

Устройства, запускаемые с Android 10 или обновленные до нее, должны использовать GSI Android 10 для тестирования на соответствие требованиям. Это включает в себя следующие основные изменения по сравнению с более ранними GSI:

  • Пользовательская сборка. GSI имеет пользовательскую сборку из Android 10. В Android 10 пользовательскую сборку GSI можно использовать при тестировании на соответствие CTS-on-GSI/VTS. Подробности см. в разделе Тестирование VTS с отладкой Ramdisk .
  • Неразборный формат. GSI с целевыми объектами aosp_$arch построены в неразборном формате. Вы можете использовать img2simg для преобразования неразрезанного GSI в разреженный формат, если это необходимо.
  • Система от имени root. Устаревшая цель сборки GSI с именем aosp_$arch_a была прекращена. Для устройств, обновленных с Android 8 или 8.1 до Android 10 с RAM-диском и не-системой от имени root, используйте устаревший GSI aosp_$arch_ab . Обновленный init в ramdisk поддерживает OEM system.img с макетом system-as-root.
  • Проверьте загрузку. Используя GSI, вам нужно только разблокировать устройство. Нет необходимости отключать проверку загрузки.

Изменения GSI в Android 9

Устройства, запускаемые с Android 9 или обновленные до нее, должны использовать GSI Android 9 для тестирования на соответствие требованиям. Это включает в себя следующие основные изменения по сравнению с более ранними GSI:

  • Объединяет GSI и эмулятор. GSI строятся из системных образов продуктов эмуляторов, например, aosp_arm64 и aosp_x86 .
  • Система от имени root. В предыдущих версиях Android устройства, не поддерживающие обновления A/B, могли монтировать образ системы в каталоге /system . В Android 9 корень образа системы монтируется как корень устройства.
  • 64-битный интерфейс связующего. В Android 8.x 32-разрядные GSI использовали 32-разрядный интерфейс связывания. Android 9 не поддерживает 32-разрядный интерфейс связывания, поэтому как 32-разрядные, так и 64-разрядные GSI используют 64-разрядный интерфейс связывания.
  • исполнение ВНДК. В Android 8.1 VNDK был необязательным. Начиная с Android 9 VNDK является обязательным, поэтому необходимо установить BOARD_VNDK_VERSION .
  • Совместимое системное свойство. Android 9 включает проверку доступа к совместимому системному свойству ( PRODUCT_COMPATIBLE_PROPERTY_OVERRIDE := true ).

Изменения Keymaster в Android 9

В более ранних версиях Android устройства, реализующие Keymaster 3 или ниже, должны были убедиться, что информация о версии ( ro.build.version.release и ro.build.version.security_patch ), сообщаемая работающей системой, соответствует информации о версии, сообщаемой загрузчиком. Такая информация обычно была получена из заголовка загрузочного образа.

В Android 9 и более поздних версиях это требование изменилось, чтобы поставщики могли загружать GSI. В частности, Keymaster не должен выполнять проверку, поскольку информация о версии, сообщаемая GSI, может не совпадать с информацией о версии, сообщаемой загрузчиком поставщика. Для устройств, реализующих Keymaster 3 или ниже, поставщики должны изменить реализацию Keymaster, чтобы пропустить проверку (или обновиться до Keymaster 4). Дополнительные сведения о Keymaster см. в разделе Хранилище ключей с аппаратной поддержкой .

Загрузка GSI

Готовые GSI можно загрузить с веб-сайта непрерывной интеграции (CI) AOSP по адресу ci.android.com . Если тип GSI для вашей аппаратной платформы недоступен для загрузки, обратитесь к следующему разделу для получения подробной информации о создании GSI для конкретных целей.

Создание GSI

Начиная с Android 9, каждая версия Android имеет ветку GSI с именем DESSERT -gsi в AOSP (например, android12-gsi — это ветка GSI в Android 12). Ветки GSI включают содержимое Android со всеми примененными исправлениями безопасности и исправлениями GSI .

Чтобы создать GSI, настройте исходное дерево Android, загрузив его из ветки GSI и выбрав цель сборки GSI . Используйте приведенные ниже таблицы целей сборки, чтобы определить правильную версию GSI для вашего устройства. После завершения сборки GSI представляет собой образ системы (т. е. system.img ) и появляется в выходной папке out/target/product/ generic_arm64 .

Например, чтобы создать цель сборки GSI gsi_arm64-userdebug в ветке GSI android12-gsi , выполните следующие команды.

$ repo init -u https://android.googlesource.com/platform/manifest -b android12-gsi
$ repo sync -cq
$ source build/envsetup.sh
$ lunch gsi_arm64-userdebug
$ make -j4

Цели сборки Android GSI

Следующие цели сборки GSI предназначены для устройств, запускаемых на Android 9 или выше.

Имя GSI Арка процессора Разрядность интерфейса связующего Система от имени root Создать цель
gsi_arm РУКА 64 Д gsi_arm-user
gsi_arm-userdebug
gsi_arm64 ARM64 64 Д gsi_arm64-user
gsi_arm64-userdebug
gsi_x86 x86 64 Д gsi_x86-user
gsi_x86-userdebug
gsi_x86_64 x86-64 64 Д gsi_x86_64-user
gsi_x86_64-userdebug

Требования к прошивке GSI

Устройства Android могут иметь разный дизайн, поэтому не существует универсальной команды или набора инструкций для прошивки GSI, применимых ко всем устройствам. Обратитесь к производителю Android-устройства за подробными инструкциями по перепрошивке. Используйте следующие шаги в качестве общего руководства:

  1. Убедитесь, что устройство имеет следующее:
    • Треблизированный
    • Способ разблокировки устройств (чтобы их можно было прошить с помощью fastboot )
    • Разблокированное состояние, чтобы его можно было прошивать через fastboot (чтобы убедиться, что у вас установлена ​​последняя версия fastboot , соберите ее из исходного дерева Android).
  2. Сотрите текущий системный раздел, затем прошейте GSI в системный раздел.
  3. Сотрите пользовательские данные и очистите данные с других необходимых разделов (например, пользовательских данных и системных разделов).
  4. Перезагрузите устройство.

Например, чтобы прошить GSI на любом устройстве Pixel:

  1. Загрузитесь в fastboot и разблокируйте загрузчик .
  2. Устройства, поддерживающие fastbootd , также должны загружаться в fastbootd с помощью:
    $ fastboot reboot fastboot
  3. Сотрите и запишите GSI в системный раздел:
    $ fastboot erase system
$ fastboot flash system system.img
  4. Сотрите пользовательские данные и очистите данные с других необходимых разделов (например, пользовательских данных и системных разделов):
    $ fastboot -w
  5. Перезагрузка:
    $ fastboot reboot
На устройствах Android 10 или более поздней версии с меньшими системными разделами при перепрошивке GSI может появиться следующее сообщение об ошибке:
    Resizing 'system_a'    FAILED (remote: 'Not enough space to resize partition')
    fastboot: error: Command failed
Используйте следующую команду, чтобы удалить раздел продукта и освободить место для системного раздела. Это обеспечивает дополнительное пространство для прошивки GSI:
$ fastboot delete-logical-partition product_a
Постфикс _a должен соответствовать идентификатору слота системного раздела, например, system_a в этом примере.

Вклад в GSI

Android приветствует ваш вклад в разработку GSI. Вы можете принять участие и помочь улучшить GSI следующим образом:

  • Создание патча GSI. DESSERT -gsi не является веткой разработки и принимает только вишни из основной ветки AOSP, поэтому для отправки исправления GSI необходимо:
    1. Отправьте патч в master ветку AOSP .
    2. Cherrypick патч для DESSERT -gsi .
    3. Сообщите об ошибке, чтобы получить обзор Cherrypick.
  • Сообщение об ошибках GSI или внесение других предложений. Ознакомьтесь с инструкциями в разделе Сообщения об ошибках , а затем просмотрите или зарегистрируйте ошибки GSI .

Советы

Изменение режима панели навигации с помощью adb

При загрузке с GSI режим панели навигации настраивается переопределением поставщика. Вы можете изменить режим панели навигации, выполнив следующую команду adb во время выполнения.

adb exec-out cmd overlay enable-exclusive com.android.internal.systemui.navbar.mode

Где mode может быть threebutton , twobutton , gestural и так далее.