GSI in AOSP: A Comprehensive Guide

In the Android Open Source Project (AOSP), a Generic System Image (GSI) is a system image built entirely from pure AOSP code, without any device-specific or vendor-specific customizations. It plays a crucial role in Android’s Project Treble, which aims to make Android updates faster and easier for device manufacturers.

Purpose of GSI

GSIs are designed to:

• Validate vendor implementations against the latest Android release.
• Run on any device that is Treble-compliant (starting from Android 8.0).
• Serve as a reference system image for testing and development.
• Enable CTS-on-GSI and VTS-on-GSI testing.

Key Characteristics

• Built from AOSP: No OEM or carrier customizations.
• Architecture-specific: Available for ARM, ARM64, x86, x86_64.
• System-as-root: System partition is mounted as root.
• Supports Verified Boot: Can be flashed with vbmeta.img to disable verification.
• User or Userdebug builds: User debug builds allow root access for testing.

Use Cases

1. Compliance Testing: Ensures that vendor implementations meet Android compatibility standards.
2. Development & Debugging: Developers can test new features or debug issues on a clean AOSP environment.
3. Custom ROM Base: Some custom ROMs use GSI as a base for development.

How to Get or Build a GSI

• Download Prebuilt GSIs: From Android CI.
• Build Your Own:

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

Flashing a GSI

To flash a GSI on a Treble-compliant device:

fastboot erase system
fastboot flash system system.img
fastboot --disable-verity --disable-verification flash vbmeta vbmeta.img
fastboot reboot

Thanks & Regards, Sairamkrishna Mammahe, https://www.linkedin.com/in/sairamkrishna-mammahe/