AAB — ce este, diferența față de APK și principiul de funcționare

Ce este AAB

AAB (Android App Bundle) — este un format de publicare dezvoltat de Google ca înlocuitor pentru APK pentru distribuția prin Google Play. În interiorul AAB se află o arhivă ZIP cu extensia .aab, conținând cod compilat, resurse și metadate. Diferența cheie: AAB nu se instalează direct pe dispozitiv.

Principiul de funcționare

Dezvoltatorul încarcă AAB în Google Play Console. Când utilizatorul încearcă să instaleze aplicația, Google Play analizează configurația dispozitivului: densitatea ecranului (DPI), arhitectura CPU, limba și versiunea Android. Pe baza acestei analize se generează un APK minim, conținând doar componentele necesare.

Istoricul implementării

Google a prezentat AAB în 2018 la conferința I/O. Din august 2021, formatul a devenit obligatoriu pentru toate aplicațiile noi din Google Play. Aplicațiile existente pot continua să utilizeze APK, dar cele noi trebuie publicate doar în format AAB.

Cu ce se deosebește AAB de APK

Diferența dintre AAB și APK este fundamentală: APK este un fișier de instalare complet, gata de instalare. AAB este un container cu componente sursă care necesită procesare.

APK este potrivit pentru distribuția în afara Google Play — prin site-uri web, e-mail sau sisteme MDM corporative. AAB este legat de infrastructura Google Play și nu se instalează direct. Pentru testarea AAB se utilizează instrumentul bundletool, care emulează generarea APK pe mașina locală.

Structura fișierului AAB

Structura internă a AAB este similară cu APK, dar conține directoare și fișiere suplimentare pentru descrierea modulelor și a dependențelor lor.

Modulul de bază (base)

Modulul base — este o componentă obligatorie a AAB. Acesta conține codul principal, resursele și manifestul aplicației. Fără modulul base, aplicația nu poate fi construită. Toate celelalte module sunt opționale și se conectează prin Dynamic Delivery.

Formatul protobuf

Configurația AAB utilizează Protocol Buffers (protobuf) în loc de XML. Fișierele .pb sunt mai compacte și sunt parsate mai rapid de infrastructura server Google. Instrumentul bundletool convertește protobuf într-un format lizibil pentru depanare.

Dynamic Delivery și modulele aplicației

Dynamic Delivery — este tehnologia cheie pe care este construit AAB. Aceasta permite livrarea către utilizator doar a acelor părți ale aplicației care corespund dispozitivului și limbii sale, precum și încărcarea modulelor suplimentare la cerere.

Tipuri de module

Modulele Install-time se încarcă împreună cu APK-ul de bază la instalare. Modulele Conditional se livrează doar la îndeplinirea condițiilor — de exemplu, un modul cu materiale pentru ecrane 4K. Modulele On-demand se încarcă la cererea utilizatorului în cadrul aplicației.

Play Asset Delivery (PAD)

Pentru resurse mari (până la 2 GB) se utilizează Play Asset Delivery în locul fișierelor OBB. PAD suportă aceleași trei moduri de livrare: install-time, fast-follow (imediat după instalare) și on-demand.

// Încărcarea modulului on-demand prin SplitInstallManager
val manager = SplitInstallManagerFactory
    .create(context)

val request = SplitInstallRequest
    .newBuilder()
    .addModule("level_pack_3")
    .build()

manager.startInstall(request)
    .addOnSuccessListener {
        Log.d("AAB", "Modul instalat")
    }

Configurarea modulului în Gradle

Fiecare modul dinamic este descris printr-un fișier build.gradle separat cu specificarea tipului de livrare. Modulul poate conține propriile resurse, cod și manifest, independente de aplicația de bază.

Construirea AAB prin Gradle

Construirea AAB se realizează prin Android Gradle Plugin cu sarcina bundleRelease (sau bundleDebug). Rezultatul — un fișier .aab în directorul build/outputs/bundle/.

Configurarea construcției

Pentru construirea AAB nu sunt necesare setări speciale — Android Gradle Plugin suportă pachetele implicit. Este suficient să indicați sarcina bundle în loc de assemble.

// build.gradle.kts — construirea AAB cu semnătură
android {
    bundle {
        language {
            enableSplit = true
        }
        density {
            enableSplit = true
        }
        abi {
            enableSplit = true
        }
    }
}
// Sarcina: ./gradlew bundleRelease

Testarea locală prin bundletool

Google oferă instrumentul bundletool pentru generarea APK-urilor din AAB pe mașina locală. Comanda `bundletool build-apks --bundle=app.aab --output=app.apks` creează un set de APK-uri pentru testare pe diferite configurații de dispozitive.

bundletool poate, de asemenea, să despacheteze AAB, să afișeze configurația acestuia și să verifice integritatea semnăturii înainte de încărcarea în Google Play Console. Pentru depanare se utilizează comanda `bundletool dump manifest --bundle=app.aab`, care afișează manifestul modulului de bază.

Configurarea divizărilor în AAB

Implicit, AAB împarte resursele după trei dimensiuni: limbă (language), densitatea ecranului (density) și arhitectura CPU (abi). Dezvoltatorul poate dezactiva orice divizare în build.gradle — de exemplu, dacă aplicația suportă doar limba engleză. Dezactivarea divizării înseamnă că resursele pentru toate variantele vor ajunge în APK-ul de bază.

Resource optimisation — AAB convertește automat PNG în WebP fără pierdere de calitate, comprimă resursele neutilizate și elimină șirurile duplicate. Aceste optimizări se aplică de partea Google Play la generarea APK-ului final. Ca rezultat, utilizatorul primește un APK cu 15–25% mai mic decât arhiva completă.

Publicarea AAB în Google Play

Procesul de publicare a AAB în Google Play Console diferă de APK doar prin formatul fișierului încărcat. Consola acceptă .aab, verifică structura, semnătura și configurația modulelor, după care generează APK pentru fiecare tip de dispozitiv.

App Signing by Google Play

La încărcarea AAB, Google Play preia gestionarea cheilor de semnătură. Dezvoltatorul încarcă pachetul semnat cu cheia upload, iar Google resemnează APK-urile generate cu propria cheie. Aceasta simplifică rotația cheilor și recuperarea accesului în cazul pierderii keystore-ului.

Testarea înainte de lansare

Google Play Console oferă un test încorporat AAB: se poate descărca APK-ul generat pentru un anumit dispozitiv sau se poate rula testarea internă prin track-urile Internal Testing, Closed Alpha și Open Beta.

Probleme tipice cu AAB și soluționarea lor

Trecerea la AAB poate cauza probleme, în special în proiecte cu un număr mare de module dinamice sau configurație complexă a resurselor.

Erori de configurare a modulelor

Dacă un modul dinamic face referire la resursele modulului de bază cu un nume incorect, Google Play respinge AAB în etapa de verificare. Soluția — utilizarea verificării lint înainte de construire și testarea tuturor modulelor prin bundletool local.

Divizări lingvistice și scăderea performanței

Divizarea pe limbi poate încetini pornirea aplicației dacă resursele pentru localizarea curentă sunt încărcate dinamic. Recomandarea Google — să nu divizați limbile dacă sunt mai puțin de 10 sau să utilizați install-time pentru cele mai populare.

Compatibilitatea cu SDK-urile terțe

Unele SDK-uri (analitică, reclame, hărți) necesită acces la manifestul complet și resurse. Verificarea compatibilității cu AAB este un pas obligatoriu înainte de migrare. Majoritatea SDK-urilor mari (Firebase, Google Ads, Crashlytics) suportă complet AAB din 2022. Pentru verificarea compatibilității se utilizează bundletool cu flagul --validate, care emulează generarea APK pe server.

Versionarea AAB

AAB utilizează versionCode din manifestul modulului de bază. Spre deosebire de APK, AAB suportă, de asemenea, versionCode separat pentru fiecare modul — aceasta permite actualizarea părților individuale ale aplicației fără reinstalare completă. Dynamic Delivery urmărește modulele instalate și livrează doar componentele modificate la actualizarea prin Google Play.

Monitorizarea și analitica AAB

Google Play Console oferă analitică detaliată pentru fiecare AAB: câte APK-uri au fost generate, care divizări au fost solicitate, care este dimensiunea medie de descărcare pe dispozitive. Android Vitals arată metricile de performanță ale APK-urilor generate. Aceste date ajută la optimizarea configurației divizărilor și la reducerea dimensiunii de descărcare pentru diferite categorii de dispozitive.