Informazioni sugli Android App Bundle

Un Android App Bundle è un formato di pubblicazione che include tutto il codice e le risorse compilati della tua app e che definisce la generazione degli APK e l'accesso a Google Play.

Google Play utilizza l'app bundle per generare e pubblicare APK ottimizzati per ogni configurazione del dispositivo, in modo che solo il codice e le risorse necessari per un dispositivo specifico vengano scaricati per eseguire la tua app. Non devi più creare, firmare e gestire più APK per ottimizzare il supporto per diversi dispositivi e gli utenti ricevono download più piccoli e più ottimizzati.

La maggior parte dei progetti di app non richiederà molto impegno per creare app bundle che supportano APK ottimizzati per la pubblicazione. Ad esempio, se organizzi già il codice e le risorse della tua app secondo le convenzioni stabilite, crea semplicemente Android App Bundle firmati utilizzando Android Studio o utilizzando la riga di comando, quindi caricali su Google Play. La pubblicazione ottimizzata degli APK diventa quindi un vantaggio automatico.

Quando utilizzi il formato app bundle per pubblicare l'app, puoi anche sfruttare la funzionalità Play Feature Delivery, che ti consente di aggiungere moduli delle funzionalità al progetto dell'app. Questi moduli contengono funzionalità e risorse incluse nella tua app solo in base alle condizioni da te specificate o che sono disponibili in un secondo momento in fase di runtime per il download dell'articolo Utilizzare la libreria di base di Play.

Gli sviluppatori di giochi che pubblicano le proprie app con gli app bundle possono utilizzare Play Asset Delivery, la soluzione di Google Play per fornire grandi quantità di risorse di gioco che offre agli sviluppatori metodi di pubblicazione flessibili e prestazioni elevate.

Guarda il video che segue per avere una panoramica del motivo per cui dovresti pubblicare la tua app utilizzando Android App Bundle.

Limitazione delle dimensioni di download compresse

La pubblicazione con Android App Bundle consente agli utenti di installare la tua app con il minor numero di download possibili e aumenta il limite delle dimensioni di download compresse a 200 MB. In altre parole, quando un utente scarica la tua app, le dimensioni totali degli APK compressi necessari per installare l'app (ad esempio, l'APK di base e gli APK di configurazione) non devono superare i 200 MB. Anche tutti i download successivi, come il download on demand di un modulo delle funzionalità (e dei relativi APK di configurazione), devono rispettare questa limitazione delle dimensioni di download compressa. I pacchetti di asset non contribuiscono a questo limite di dimensioni, ma hanno altri limiti di dimensione.

Quando carichi l'app bundle, se Play Console rileva che i possibili download dell'app o delle sue funzionalità on demand sono superiori a 200 MB, ricevi un errore.

Tieni presente che Android App Bundle non supporta i file di espansione APK (*.obb). Di conseguenza, se si verifica questo errore durante la pubblicazione dell'app bundle, usa una delle seguenti risorse per ridurre le dimensioni di download degli APK compressi:

  • Assicurati di attivare tutti gli APK di configurazione impostando enableSplit = true per ogni tipo di APK di configurazione. In questo modo, gli utenti possono scaricare solo il codice e le risorse necessarie per eseguire l'app sul proprio dispositivo.
  • Assicurati di restringere l'app rimuovendo il codice e le risorse inutilizzati.
  • Segui le best practice per ridurre ulteriormente le dimensioni dell'app.
  • Valuta la possibilità di convertire le funzionalità utilizzate solo da alcuni utenti in moduli di funzionalità che la tua app potrà scaricare in un secondo momento, on demand. Tieni presente che questa operazione potrebbe richiedere il refactoring della tua app, quindi assicurati di provare prima gli altri suggerimenti descritti sopra.

Altre considerazioni

Di seguito sono riportati i problemi attualmente noti che si verificano durante la creazione o la pubblicazione della tua app con Android App Bundle. Se riscontri problemi non descritti di seguito, segnala un bug.

  • Le installazioni parziali di app installate tramite sideload, ossia app che non vengono installate utilizzando il Google Play Store e a cui mancano uno o più APK divisi obbligatori, non riescono su tutti i dispositivi certificati da Google e su tutti i dispositivi con Android 10 (livello API 29) o versioni successive. Quando scarichi la tua app tramite il Google Play Store, Google garantisce che tutti i componenti necessari dell'app siano installati.
  • Se usi strumenti che modificano dinamicamente le tabelle delle risorse, gli APK generati dagli app bundle potrebbero comportarsi in modo imprevisto. Di conseguenza, quando crei un app bundle, ti consigliamo di disabilitare questi strumenti.
  • Al momento è possibile configurare proprietà nella configurazione della build di un modulo delle funzionalità che sono in conflitto con quelle dei moduli di base (o di altro tipo). Ad esempio, puoi impostare buildTypes.release.debuggable = true nel modulo di base e impostarlo su false in un modulo della funzionalità. Questi conflitti potrebbero causare problemi di build e runtime. Tieni presente che, per impostazione predefinita, i moduli funzionalità ereditano alcune configurazioni di build dal modulo di base. Assicurati quindi di comprendere quali configurazioni devi mantenere e quali omettere nella configurazione della build dei moduli delle funzionalità.

Risorse aggiuntive

Per scoprire di più sugli Android App Bundle, consulta le risorse che seguono.

Post del blog

Video