Generic System Image ( GSI ) — это чистая реализация Android с неизмененным кодом Android Open Source Project (AOSP), которая может работать на различных устройствах Android.
Разработчики приложений могут устанавливать и запускать новейшие GSI-файлы для Android, чтобы проводить тестирование приложений на различных существующих устройствах Android, используя GSI-файлы из разных этапов выпуска Android OS, включая сборки Developer Preview и Beta. Добавление GSI-файлов в процессы проверки и тестирования может предоставить вам ряд дополнительных преимуществ:
- Более широкое тестирование на большем количестве реальных устройств.
- Больше времени на устранение проблем совместимости приложения.
- Появляются новые возможности для исправления проблем совместимости в Android, о которых сообщают разработчики приложений.
Проект GSI является проектом с открытым исходным кодом и помогает улучшить экосистему Android, предоставляя больше возможностей для повышения качества приложений и операционной системы перед каждым релизом Android.
GSI-пакеты содержат одни и те же основные системные функции для всех устройств, на которые они устанавливаются. Другими словами, GSI-пакет не включает в себя настройки, внесенные производителем устройства. Из-за этого вы можете столкнуться с различиями в поведении в следующих ситуациях:
- Взаимодействия, затрагивающие пользовательский интерфейс.
- Рабочие процессы, требующие новых функций оборудования.
Проверьте соответствие устройства требованиям.
GSI-модули могут функционировать только на устройствах со следующими характеристиками:
- Загрузчик разблокирован.
- Полностью соответствует требованиям Treble.
- Запущено с Android 9 (уровень API 28) или выше. Устройства, обновленные до Android 9 с более ранней версии, могут поддерживать или не поддерживать GSI.
Чтобы определить, поддерживает ли ваше устройство GSI и какую версию GSI OS следует установить, выполните следующие действия:
Проверить наличие поддержки Treble можно, выполнив следующую команду:
adb shell getprop ro.treble.enabled
Если ответ
false, устройство несовместимо с GSI, и вам не следует продолжать. Если ответtrue, перейдите к следующему шагу.Проверьте наличие поддержки разных версий, выполнив следующую команду:
adb shell cat /system/etc/ld.config.version_identifier.txt \ | grep -A 20 "\[vendor\]"
В выходных данных найдите в разделе
[vendor]namespace.default.isolated.Если значение этого атрибута равно
true, то устройство полностью поддерживает Vendor Native Development Kit (VNDK) и может использовать любую версию операционной системы GSI, которая новее, чем версия ОС на устройстве. По возможности используйте последнюю доступную версию ОС GSI.Если значение атрибута равно
false, то устройство не полностью соответствует стандарту VNDK и может использовать только GSI-образ для той же версии ОС, что и на устройстве. Например, устройство Android 10 (версия API 29), не соответствующее стандарту VNDK, может загрузить только GSI-образ Android 10.Тип архитектуры ЦП GSI должен соответствовать архитектуре ЦП устройства. Чтобы определить правильную архитектуру ЦП для образа GSI, выполните следующую команду:
adb shell getprop ro.product.cpu.abi
Используйте полученные данные, чтобы определить, какой образ GSI использовать при прошивке устройства. Например, на Pixel 5 выходные данные покажут, что архитектура процессора —
arm64-v8a, поэтому следует использовать GSI типаarm64.
Скачать GSI-файлы
Существует несколько способов получения GSI-файлов, в зависимости от ваших потребностей в разработке:
- Для предварительного просмотра GSI-образов для Android и GSI-образов для Android с GMS загрузите образы со страницы выпуска GSI-образов .
Для получения предварительно собранных образов GSI без приложений GMS загрузите образы с сайта AOSP CI:
Чтобы собрать Android GSI-файлы без GMS, загрузите исходный код с AOSP и соберите свои GSI-файлы.
Установите GSI
Установка GSI зависит от устройства. Для получения точных инструментов и инструкций обратитесь к производителю вашего устройства. Для устройств Google Pixel, таких как Pixel 3 и более новые модели, существует несколько способов установки:
- Ручная прошивка образов GSI: см. Требования к прошивке образов GSI.
- Использование динамических системных обновлений (DSU) для устройств, работающих под управлением Android 10 или выше: см. страницу « Динамические системные обновления» .
Оставьте отзыв
GSI-образы предназначены для проверки работоспособности ваших приложений на Android. Мы будем благодарны за ваши отзывы об изображениях, инструментах и процессе использования GSI-образов на ваших устройствах.
Чтобы сообщить нам об ошибках или предложить новые функции, используйте специальный компонент отслеживания проблем для ассистентов системных настройщиков.