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

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

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

  • Более широкое покрытие тестирования на большем количестве реальных устройств.
  • Больше времени на устранение проблем с совместимостью приложений
  • Больше возможностей для устранения проблем совместимости с Android, о которых сообщают разработчики приложений.

Проект GSI является открытым и помогает улучшать экосистему Android, предоставляя больше возможностей для повышения качества приложений и ОС перед каждым выпуском Android.

Поддержка GSI на разных устройствах
Рисунок 1. Образы GSI можно устанавливать на самые разные устройства, в том числе на те, для которых производитель не предоставляет собственные образы системы.

В GSI включены одни и те же основные системные функции для всех устройств, на которые они установлены. Другими словами, в GSI нет изменений, внесенных производителем устройства. Поэтому в следующих ситуациях могут наблюдаться различия в поведении:

  • Взаимодействия с интерфейсом.
  • Рабочие процессы, требующие более новых аппаратных функций

Как проверить соответствие устройства требованиям

GSI могут работать только на устройствах со следующими характеристиками:

  • Загрузчик операционной системы разблокирован.
  • Полностью соответствует требованиям Treble.
  • Устройство должно быть выпущено с Android 9 (уровень API 28) или более поздней версией. Устройства, на которых Android 9 была установлена вместо более ранней версии, могут поддерживать GSI, а могут и не поддерживать.

Чтобы узнать, можно ли использовать на вашем устройстве образ системы и какую версию ОС GSI следует установить, выполните следующие действия:

  1. Чтобы проверить, поддерживается ли Treble, выполните следующую команду:

    adb shell getprop ro.treble.enabled

    Если ответ – false, устройство несовместимо с GSI и продолжать не следует. Если ответ – true, перейдите к следующему шагу.

  2. Чтобы проверить, поддерживается ли эта функция в разных версиях, выполните следующую команду:

    adb shell cat /system/etc/ld.config.version_identifier.txt \
    | grep -A 20 "\[vendor\]"

    В выходных данных найдите раздел [vendor] и проверьте, есть ли в нем запись namespace.default.isolated.

    Если значение этого атрибута – true, устройство полностью поддерживает комплект разработки нативных приложений поставщика (VNDK) и может использовать любую версию ОС GSI, которая новее версии ОС на устройстве. По возможности используйте последнюю доступную версию ОС GSI.

    Если значение атрибута – false, устройство не полностью соответствует требованиям VNDK и может использовать только образ GSI для той же версии ОС, что и на устройстве. Например, устройство с Android 10 (API версии 29), не соответствующее требованиям VNDK, может загрузить только образ GSI для Android 10.

  3. Тип архитектуры ЦП образа GSI должен совпадать с архитектурой ЦП устройства. Чтобы найти подходящую архитектуру ЦП для образа GSI, выполните следующую команду:

    adb shell getprop ro.product.cpu.abi

    Используйте полученные данные, чтобы определить, какой образ GSI использовать при прошивке устройства. Например, на устройстве Pixel 5 в выходных данных будет указано, что архитектура процессора – arm64-v8a, поэтому вам нужно будет использовать образ GSI типа arm64.

Как скачать образы GSI

Получить GSI можно несколькими способами в зависимости от ваших потребностей:

Как установить GSI

Установка GSI зависит от устройства. Информацию о том, какие инструменты и процедуры использовать, можно найти на сайте производителя устройства. На устройствах Google Pixel, например Pixel 3 и более новых моделях, можно установить приложение несколькими способами:

Оставить отзыв

GSI помогают проверять приложения на устройствах Android. Мы будем рады получить от вас отзыв об образах, инструментах и процессе использования GSI на ваших устройствах.

Чтобы сообщить нам об ошибке или запросить добавление функции, используйте компонент системы отслеживания ошибок для поставщиков услуг Google.

Дополнительные ресурсы