Podstawowe obrazy systemu (GSI)

Generic System Image (GSI) to implementacja czystego Androida z niezmienionym kodem z Android Open Source Project (AOSP), która może działać na różnych urządzeniach z Androidem.

Deweloperzy aplikacji mogą instalować i uruchamiać najnowsze obrazy systemu Android GSI, aby testować aplikacje na różnych istniejących urządzeniach z Androidem. Mogą też korzystać z obrazów GSI z różnych etapów wydania systemu Android, w tym wersji dla deweloperów i wersji beta. Dodanie GSI do procesów weryfikacji i testowania może przynieść dodatkowe korzyści:

• szersze pokrycie testów na większej liczbie rzeczywistych urządzeń,
• więcej czasu na rozwiązanie problemów ze zgodnością aplikacji,
• więcej możliwości rozwiązywania problemów ze zgodnością na Androidzie zgłoszonych przez deweloperów aplikacji;

Projekt GSI jest otwartym kodem źródłowym i pomaga ulepszać ekosystem Androida, zapewniając więcej sposobów na poprawę jakości aplikacji i systemu operacyjnego przed każdą wersją Androida.

Rysunek 1.: obrazy GSI można instalować na wielu urządzeniach, a czasem nawet na tych z Androidem, dla których producent nie udostępnia własnego obrazu systemu.

GSI obejmują te same podstawowe funkcje systemowe na wszystkich urządzeniach, na których są zainstalowane. Inaczej mówiąc, GSI nie obejmuje personalizacji producenta urządzenia. Z tego powodu możesz zauważyć różnice w zachowaniu w tych sytuacjach:

• Interakcje z interfejsem
• Przepływy pracy, które wymagają nowszych funkcji sprzętowych

Sprawdzanie zgodności urządzenia

GSI mogą działać tylko na urządzeniach o tych cechach:

• Program rozruchowy jest odblokowany.
• Pełna zgodność z rekomendacjami Treble.
• Uruchomiona na Androidzie 9 (poziom API 28) lub nowszym. Urządzenia z Androidem 9, które zostały uaktualnione z wersji wcześniejszej, mogą obsługiwać GSI, ale nie muszą.

Ostrzeżenie: próba przeprowadzenia aktualizacji obrazu GSI na urządzeniu niezgodnym może spowodować, że urządzenie nie będzie się uruchamiać. Przed rozpoczęciem procesu flashowania zawsze upewnij się, że urządzenie jest zgodne, i postępuj zgodnie z instrukcjami producenta. GSI nie obsługuje cofania zmian, więc aby wrócić do oryginalnego systemu, musisz użyć metody odzyskiwania i oryginalnej pamięci ROM.

Aby sprawdzić, czy Twoje urządzenie może korzystać z GSI i którą wersję systemu GSI należy zainstalować:

1. Sprawdź obsługę Treble, uruchamiając to polecenie:

   adb shell getprop ro.treble.enabled

   Jeśli odpowiedź to false, urządzenie jest niezgodne z Google Service Identity, więc nie należy kontynuować. Jeśli odpowiedź to true, przejdź do następnego kroku.

2. Aby sprawdzić obsługę wersji, uruchom to polecenie:

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

   Uwaga: w zależności od platformy plik konfiguracji w poprzednim poleceniu może zawierać lub nie zawierać identyfikatora wersji.

   W wynikach odszukaj sekcję [vendor], w której znajduje się namespace.default.isolated.

   Jeśli wartość tego atrybutu to true, urządzenie w pełni obsługuje pakiet do tworzenia oprogramowania w języku natywnym (VNDK) dostawcy i może używać dowolnej wersji systemu operacyjnego GSI, która jest nowsza od wersji systemu operacyjnego na urządzeniu. W miarę możliwości używaj najnowszej dostępnej wersji GSI.

   Jeśli wartość atrybutu to false, urządzenie nie jest w pełni zgodne z VNDK i może używać tylko GSI dla tej samej wersji systemu operacyjnego na urządzeniu. Na przykład urządzenie z Androidem 10 (poziom interfejsu API 29), które nie jest zgodne z VNDK, może wczytywać tylko obraz GSI Androida 10.

3. Typ architektury procesora GSI musi być zgodny z architekturą procesora urządzenia. Aby znaleźć odpowiednią architekturę procesora dla obrazu GSI, uruchom to polecenie:

   adb shell getprop ro.product.cpu.abi

   Na podstawie danych wyjściowych określ, którego obrazu GSI użyć do zaflashowania urządzenia. Na przykład w przypadku Pixela 5 dane wyjściowe wskazują, że architektura procesora to arm64-v8a, więc należy użyć typu GSI arm64.

Pobieranie GSI

W zależności od potrzeb związanych z tworzeniem aplikacji możesz uzyskać GSI na kilka sposobów:

• Aby pobrać obrazy GSI z Androidem w wersji podglądowej i z GMS, przejdź na stronę wersji GSI.

• Aby pobrać gotowe obrazy GSI bez aplikacji GMS, wejdź na stronę CI AOSP:

  • Android 10 (poziom API 29)
  • Android 11 (poziom API 30)
  • Android 12 (poziom API 31)
  • Android 13 (poziom API 33)

• Aby skompilować GSI na Androida bez GMS, pobierz kod źródłowy z AOSP i skompiluj GSI.

Ważne: producenci urządzeń nie powinni używać tych wersji GSI do przeprowadzania i przesyłania testów zgodności. Producenci urządzeń powinni nadal korzystać z dotychczasowych kanałów komunikacji, takich jak techniczni menedżerowie kont, w przypadku działań związanych z testami zgodności.

Instalowanie GSI

Uwaga: jeśli na urządzeniu jest włączona funkcja Android Verified Boot (AVB), pobierz i zainstaluj ten obraz, aby wyłączyć AVB, zanim zainstalujesz GSI: vbmeta.img

Instalowanie GSI zależy od urządzenia. Szczegółowe informacje o narzędziach i procedurach znajdziesz na stronie producenta urządzenia. W przypadku urządzeń Google Pixel, takich jak Pixel 3 i nowsze, możesz zainstalować aplikację na kilka sposobów:

• Ręczne flashowanie obrazów GSI: Wymagania dotyczące flashowania obrazów GSI
• Korzystanie z dynamicznej aktualizacji systemu (DSU) na urządzeniach z Androidem 10 lub nowszym: zobacz stronę Dynamiczne aktualizacje systemu.

Prześlij opinię

GSI mają ułatwiać weryfikację aplikacji na Androida. Dziękujemy za opinie na temat obrazów, narzędzi i procesu korzystania z globalnych usług internetowych na urządzeniach.

Aby powiadomić nas o błędach lub prośbach o dodanie funkcji, użyj specjalnego komponentu narzędzia do śledzenia problemów w przypadku usług GSI.

Dodatkowe materiały

• Znajomość wpływu obrazów systemu typu Generic System Image (GSI) (Android Dev Summit '18)