botdevice/rom/gsi/README.md

BotOS GSI - Generic System Image

O que é GSI?

GSI (Generic System Image) é uma imagem Android pura que funciona em qualquer dispositivo com Project Treble (Android 8.0+).

Com GSI você pode:

• Substituir COMPLETAMENTE o sistema do fabricante
• Ter Android puro + BotOS
• Zero bloatware Samsung/Huawei/Xiaomi
• Controle total da inicialização

Requisitos do Dispositivo

1. Project Treble - Verificar com:

   adb shell getprop ro.treble.enabled
   # Deve retornar "true"
   

2. Bootloader desbloqueado

3. Partição system tipo A/B ou A-only:

   adb shell getprop ro.build.ab_update
   # "true" = A/B, vazio = A-only
   

Opções de GSI Base

Opção 1: Usar GSI existente + BotOS Magisk Module

Mais simples. Use uma GSI pronta e instale o módulo BotOS:

1. Baixe GSI de: https://github.com/nicograph/nicograph-gsi
2. Flash via fastboot
3. Instale Magisk
4. Instale botos-magisk.zip

Opção 2: Compilar AOSP com BotOS integrado

Para controle total, compile o AOSP do zero.

Compilando AOSP com BotOS

Requisitos de Build

# Ubuntu 20.04+ recomendado
# ~300GB de espaço em disco
# 16GB+ RAM
# CPU com muitos cores (compilação leva horas)

# Instalar dependências
sudo apt install -y git-core gnupg flex bison build-essential \
    zip curl zlib1g-dev libc6-dev-i386 libncurses5 \
    x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev \
    libxml2-utils xsltproc unzip fontconfig python3

Estrutura do Projeto

aosp/
├── .repo/                    # Repo tool metadata
├── build/                    # Build system
├── device/
│   └── pragmatismo/
│       └── botos/            # Device config para BotOS
├── packages/
│   └── apps/
│       └── BotOS/            # App BotOS como system app
├── vendor/
│   └── pragmatismo/
│       └── botos/            # Vendor customizations
└── out/                      # Build output

Passo 1: Inicializar Repo

mkdir aosp && cd aosp

# Inicializar com Android 14 (ou versão desejada)
repo init -u https://android.googlesource.com/platform/manifest -b android-14.0.0_r1

# Sync (demora muito!)
repo sync -c -j$(nproc) --no-tags

Passo 2: Criar Device Tree BotOS

O device tree define configurações específicas do BotOS.

Veja os arquivos em device/pragmatismo/botos/ neste repositório.

Passo 3: Compilar

source build/envsetup.sh
lunch botos_arm64-userdebug
make -j$(nproc)

Passo 4: Flash

# Entrar em fastboot mode
adb reboot fastboot

# Flash GSI
fastboot flash system out/target/product/botos/system.img
fastboot flash vendor out/target/product/botos/vendor.img
fastboot flash boot out/target/product/botos/boot.img

# Limpar dados (necessário para GSI)
fastboot -w

# Reboot
fastboot reboot

Arquivos de Configuração

Os arquivos necessários estão em:

• device/ - Device tree
• vendor/ - Vendor customizations
• packages/apps/BotOS/ - App BotOS

Alternativa: phh-treble GSI

Para uma abordagem mais rápida, modifique o phh-treble GSI:

git clone https://github.com/nicograph/nicograph-gsi
cd nicograph-gsi

# Adicionar BotOS como system app
mkdir -p nicograph-files/system/priv-app/BotOS
cp /path/to/BotOS.apk nicograph-files/system/priv-app/BotOS/

# Adicionar boot animation
cp /path/to/bootanimation.zip nicograph-files/system/media/

# Rebuild
./build.sh

Notas de Segurança

⚠️ AVISO: Modificar system images pode:

• Invalidar garantia do dispositivo
• Causar brick se feito incorretamente
• Desabilitar recursos de segurança (SafetyNet, etc)

Sempre tenha backup completo antes de qualquer modificação!