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 delega la generazione e la firma degli APK a Google Play.

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

La maggior parte dei progetti di app non richiederà molto impegno per creare app bundle che supportino la pubblicazione di APK ottimizzati. Se organizzi già il codice e le risorse della tua app in base alle convenzioni stabilite, crea Android App Bundle firmati utilizzando Android Studio o la riga di comando, caricali su Google Play e la pubblicazione di APK ottimizzati diventerà un vantaggio automatico.

Quando utilizzi il formato app bundle per pubblicare la tua app, puoi anche usufruire di Play Feature Delivery, che ti consente di aggiungere moduli di funzionalità al tuo progetto di app. Questi moduli contengono funzionalità e risorse che vengono incluse nell'app solo in base alle condizioni che specifichi o sono disponibili in un secondo momento in fase di runtime per il download utilizzando la libreria di base Play.

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

Guarda il seguente video per una panoramica dei motivi per cui dovresti pubblicare la tua app utilizzando Android App Bundle.

Limitazione delle dimensioni di download compresse

La pubblicazione con Android App Bundle aiuta gli utenti a installare la tua app con i download più piccoli possibili e aumenta le dimensioni di download compresse. Ciò significa che, quando un utente scarica la tua app, le dimensioni totali degli APK compressi necessari per installare l'app (ad esempio, l'APK di base + gli APK di configurazione) non devono superare i 4 GB. Anche i download successivi, ad esempio il download on demand di un modulo della funzionalità (e dei relativi APK di configurazione), devono rispettare questa limitazione delle dimensioni di download compresse. I pacchetti di asset non contribuiscono a questo limite di dimensioni, ma hanno altre limitazioni di dimensioni.

Se Play Console rileva che uno dei possibili download della tua app o delle sue funzionalità on demand supera i limiti di dimensioni massime, riceverai un errore.

Tieni presente che Android App Bundle non supporta i file di espansione APK (*.obb). Pertanto, se riscontri questo errore durante la pubblicazione dell'app bundle, utilizza 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 scaricano solo il codice e le risorse di cui hanno bisogno per eseguire l'app sul proprio dispositivo.
  • Assicurati di ridurre le dimensioni dell'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 l'app può scaricare in un secondo momento, on demand. Tieni presente che questa operazione potrebbe richiedere un refactoring dell'app, quindi prova prima gli altri suggerimenti descritti.

Altre considerazioni

Di seguito sono riportati i problemi noti durante la creazione o la pubblicazione dell'app con Android App Bundle. Se riscontri problemi non ancora descritti qui, segnala un bug.

  • Le installazioni parziali di app sideloaded, ovvero app non installate utilizzando il Google Play Store e a cui mancano uno o più APK split obbligatori, non riescono su tutti i dispositivi certificati da Google e sui dispositivi con Android 10 (livello API 29) o versioni successive. Quando scarichi l'app tramite il Google Play Store, Google si assicura che tutti i componenti obbligatori dell'app siano installati.

  • Se utilizzi strumenti che modificano dinamicamente le tabelle delle risorse, gli APK generati dagli app bundle potrebbero comportarsi in modo imprevisto. Pertanto, quando crei un app bundle, ti consigliamo di disattivare questi strumenti.

  • È possibile configurare le proprietà nella configurazione di compilazione di un modulo della funzionalità che sono in conflitto con quelle dei moduli di base (o di altri moduli). 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 di runtime. Tieni presente che, per impostazione predefinita, i moduli di funzionalità ereditano alcune configurazioni di build dal modulo di base. Pertanto, assicurati di comprendere quali configurazioni devi mantenere, e quali devi omettere nella configurazione di compilazione del modulo di funzionalità.

Risorse aggiuntive

Per saperne di più su Android App Bundle, consulta le seguenti risorse.

Post del blog

Video