Panoramica di Play Feature Delivery

Il modello di pubblicazione delle app di Google Play utilizza Android App Bundles per generare e pubblicare APK ottimizzati per la configurazione del dispositivo di ciascun utente, in modo che gli utenti scarichino solo il codice e le risorse di cui hanno bisogno per eseguire l'app.

Play Feature Delivery utilizza funzionalità avanzate degli app bundle, consentendo di distribuire determinate funzionalità della tua app in modo condizionale o di scaricare on demand. Per farlo, devi prima separare queste funzionalità dall'app di base in moduli di funzionalità.

Configurazione della build di modulo delle funzionalità

Quando crei un nuovo modulo di funzionalità utilizzando Android Studio, l'IDE applica il seguente plug-in Gradle al file build.gradle del modulo.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

Molte delle proprietà disponibili per il plug-in dell'applicazione standard sono disponibili anche per il modulo delle funzionalità. Le seguenti sezioni descrivono le proprietà che dovresti e non dovresti includere nella configurazione della build del tuo modulo delle funzionalità.

Cosa non includere nella configurazione della build del modulo delle funzionalità

Poiché ogni modulo delle funzionalità dipende dal modulo di base, eredita anche determinate configurazioni. Devi quindi omettere quanto segue nel file build.gradle del modulo delle funzionalità:

  • Configurazioni di firma: gli app bundle vengono firmati utilizzando le configurazioni di firma specificate nel modulo di base.
  • La proprietà minifyEnabled: puoi abilitare la riduzione del codice per l'intero progetto dell'app solo dalla configurazione della build del modulo di base. Dovresti quindi omettere questa proprietà dai moduli delle caratteristiche. Tuttavia, puoi specificare regole ProGuard aggiuntive per ogni modulo delle funzionalità.
  • versionCode e versionName: durante la creazione dell'app bundle, Gradle utilizza le informazioni sulla versione dell'app fornite dal modulo di base. Devi omettere queste proprietà dal file build.gradle del modulo delle funzionalità.

Stabilisci una relazione con il modulo di base

Quando Android Studio crea il modulo delle funzionalità, lo rende visibile al modulo di base aggiungendo la proprietà android.dynamicFeatures al file build.gradle del modulo di base, come mostrato di seguito:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

Inoltre, Android Studio include il modulo di base come dipendenza del modulo delle funzionalità, come mostrato di seguito:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

Specifica regole ProGuard aggiuntive

Anche se solo la configurazione della build del modulo di base può abilitare la riduzione del codice per il progetto della tua app, puoi fornire regole ProGuard personalizzate con ogni modulo della funzionalità utilizzando la proprietà proguardFiles, come mostrato di seguito.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

Tieni presente che queste regole ProGuard vengono unite a quelle di altri moduli (incluso il modulo di base) in fase di creazione. Pertanto, anche se ogni modulo delle funzionalità può specificare un nuovo insieme di regole, queste regole si applicano a tutti i moduli nel progetto dell'app.

Esegui il deployment dell'app

Durante lo sviluppo dell'app che supporta i moduli delle funzionalità, puoi eseguire il deployment dell'app su un dispositivo connesso, come faresti normalmente, selezionando Esegui > Esegui dalla barra dei menu (o facendo clic su Esegui nella barra degli strumenti).

Se il progetto dell'app include uno o più moduli delle funzionalità, puoi scegliere le funzionalità da includere durante il deployment dell'app modificando la configurazione di esecuzione/debug esistente come seguente:

  1. Seleziona Run > Edit Configurations (Esegui > Modifica configurazioni) dalla barra dei menu.
  2. Nel riquadro a sinistra della finestra di dialogo Configurazioni esecuzione/debug, seleziona la configurazione dell'app per Android che preferisci.
  3. In Funzionalità dinamiche di cui eseguire il deployment nella scheda Generale, seleziona la casella accanto a ogni modulo di funzionalità da includere quando esegui il deployment dell'app.
  4. Fai clic su Ok.

Per impostazione predefinita, Android Studio non esegue il deployment dell'app utilizzando app bundle per implementare l'app. Al contrario, l'IDE crea e installa sul tuo dispositivo APK ottimizzati per la velocità di deployment, anziché per le dimensioni degli APK. Per configurare Android Studio in modo da creare e implementare invece APK ed esperienze istantanee da un app bundle, modifica la configurazione di esecuzione/debug.

Utilizza i moduli delle funzionalità per una pubblicazione personalizzata

Un vantaggio esclusivo dei moduli delle funzionalità è la possibilità di personalizzare come e quando funzionalità diverse della tua app vengono scaricate sui dispositivi con Android 5.0 (livello API 21) o versioni successive. Ad esempio, per ridurre le dimensioni di download iniziali dell'app, puoi configurare alcune funzionalità in modo che possano essere scaricate on demand in base alle esigenze o solo da dispositivi che li supportano, come la possibilità di scattare foto o di supportare funzionalità di realtà aumentata.

Sebbene tu ottenga download altamente ottimizzati per impostazione predefinita quando carichi l'app come app bundle, le opzioni di pubblicazione delle funzionalità più avanzate e personalizzabili richiedono una configurazione e una modularizzazione aggiuntive delle funzionalità dell'app tramite i moduli delle funzionalità. In altre parole, i moduli delle funzionalità forniscono gli elementi di base per la creazione di funzionalità modulari che puoi configurare per ciascun download in base alle tue esigenze.

Prendi in considerazione un'app che consenta agli utenti di acquistare e vendere prodotti in un marketplace online. Puoi ragionevolmente modularizzare ciascuna delle seguenti funzionalità dell'app in moduli di funzionalità separati:

  • Accesso e creazione dell'account
  • Esplorare il Marketplace
  • Mettere un articolo in vendita
  • Elaborazione dei pagamenti

La tabella riportata di seguito descrive le diverse opzioni di pubblicazione che supportano i moduli e il modo in cui possono essere utilizzate per ottimizzare la dimensione di download iniziale dell'app del Marketplace di esempio.

Opzione di consegna Comportamento Esempio di caso d'uso Per iniziare
Consegna al momento dell'installazione I moduli delle funzionalità che non configurano nessuna delle opzioni di pubblicazione descritte in precedenza vengono scaricati al momento dell'installazione dell'app per impostazione predefinita. Si tratta di un comportamento importante perché significa che puoi adottare gradualmente le opzioni di pubblicazione avanzate. Ad esempio, puoi trarre vantaggio dalla modularizzazione delle funzionalità della tua app e abilitare la distribuzione on demand solo dopo aver implementato completamente i download on demand utilizzando la libreria Play Feature Delivery.

Inoltre, la tua app può chiedere di disinstallare le funzionalità in un secondo momento. Pertanto, se hai bisogno di determinate funzionalità al momento dell'installazione dell'app, ma non successivamente, puoi ridurre le dimensioni di installazione richiedendo la rimozione della funzionalità dal dispositivo.

Se l'app prevede determinate attività di formazione, ad esempio una guida interattiva su come acquistare e vendere articoli nel marketplace, puoi includere questa funzionalità al momento dell'installazione dell'app per impostazione predefinita.

Tuttavia, per ridurre le dimensioni installate, l'app può richiedere di eliminare la funzionalità al termine dell'addestramento.

Modularizza la tua app utilizzando moduli di funzionalità che non configurano opzioni di distribuzione avanzate.

Per scoprire come ridurre le dimensioni installate della tua app rimuovendo determinati moduli di funzionalità che l'utente potrebbe non aver più bisogno, consulta Gestire i moduli installati.

Distribuzione on demand Consente alla tua app di richiedere e scaricare moduli delle funzionalità in base alle esigenze. Se solo il 20% di coloro che utilizzano l'app del marketplace pubblica articoli in vendita, una buona strategia per ridurre le dimensioni di download iniziali per la maggior parte degli utenti consiste nel rendere disponibile la funzionalità per scattare foto, inclusa una descrizione dell'articolo, e mettere un articolo in vendita disponibile come download on demand. In altre parole, puoi configurare il modulo delle funzionalità in modo che la funzionalità di vendita dell'app venga scaricata solo quando un utente mostra interesse a posizionare articoli in vendita sul marketplace.

Inoltre, se l'utente non vende più articoli dopo un determinato periodo di tempo, l'app può ridurre le dimensioni di installazione chiedendo di disinstallare la funzionalità.

Crea un modulo delle funzionalità e configura la distribuzione on demand. La tua app può quindi utilizzare la libreria di Play Feature Delivery per richiedere il download del modulo on demand.
Pubblicazione condizionale Consente di specificare determinati requisiti del dispositivo dell'utente, come funzionalità hardware, impostazioni internazionali e livello API minimo, per determinare se una funzionalità modularizzata viene scaricata al momento dell'installazione dell'app. Se l'app del Marketplace ha una copertura globale, potrebbe essere necessario supportare i metodi di pagamento più utilizzati solo in determinate regioni o in determinati paesi. Al fine di ridurre le dimensioni iniziali del download dell'app, puoi creare moduli di funzionalità separati per l'elaborazione di determinati tipi di metodi di pagamento e installarli in modo condizionale sul dispositivo di un utente in base alle impostazioni internazionali registrate. Crea un modulo delle funzionalità e configura la consegna condizionale.
Consegna istantanea Google Play Instant consente agli utenti di interagire con la tua app senza doverla installare sul proprio dispositivo. Possono invece usare la tua app tramite il pulsante "Prova ora" sul Google Play Store o tramite un URL creato da te. Questa forma di pubblicazione di contenuti ti consente di aumentare più facilmente il coinvolgimento con la tua app.

Con la distribuzione istantanea, puoi utilizzare Google Play Instant per consentire agli utenti di sperimentare immediatamente determinate funzionalità della tua app senza installazione.

Prendi in considerazione un gioco che includa i primi livelli in un modulo di funzionalità leggero. Puoi attivare immediatamente il modulo in modo che gli utenti possano provare subito il gioco tramite un link URL o un pulsante "Prova ora", senza installare app. Crea un modulo di funzionalità e configura la distribuzione istantanea. La tua app può quindi utilizzare la libreria di Play Feature Delivery per richiedere il download del modulo on demand.

Tieni presente che la modularizzazione delle funzionalità dell'app tramite i moduli delle funzionalità è solo il primo passo. Per supportare Google Play Instant, le dimensioni di download del modulo di base della tua app e una determinata funzionalità ad attivazione istantanea devono soddisfare rigide limitazioni relative alle dimensioni. Per scoprire di più, leggi Attivare le app istantanee riducendo le dimensioni dell'app o del gioco.

Creazione di un URI per una risorsa

Se vuoi accedere a una risorsa archiviata in un modulo di funzionalità utilizzando un URI, ecco come generare un URI di risorsa del modulo di funzionalità utilizzando Uri.Builder():

Kotlin

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

Java

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

Ogni parte del percorso della risorsa viene creata in fase di esecuzione, assicurando che venga generato lo spazio dei nomi corretto dopo il caricamento degli APK divisi.

Per un esempio di come viene generato l'URI, supponiamo che tu abbia un'app e moduli di funzionalità con questi nomi:

  • Nome pacchetto app: com.example.my_app_package
  • Nome del pacchetto di risorse della funzionalità: com.example.my_app_package.my_dynamic_feature

Se resId nello snippet di codice riportato sopra si riferisce a una risorsa di file non elaborata denominata "my_video" nel modulo della funzionalità, il codice Uri.Builder() riportato sopra restituirà il seguente risultato:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

Questo URI può quindi essere utilizzato dall'app per accedere alla risorsa del modulo delle funzionalità.

Per convalidare i percorsi nell'URI, puoi utilizzare lo Strumento di analisi APK per esaminare l'APK del modulo delle funzionalità e determinare il nome del pacchetto:

Uno screenshot dell'Analizzatore APK che esamina i contenuti di un file di risorse compilato.

Figura 2. Usa lo strumento di analisi APK per esaminare il nome del pacchetto in un file di risorse compilato.

Considerazioni sui moduli delle funzionalità

Con i moduli delle funzionalità, puoi migliorare la velocità della build e di progettazione e personalizzare ampiamente la distribuzione delle funzionalità della tua app per ridurne le dimensioni. Tuttavia, ci sono alcuni vincoli e casi limite da tenere presenti quando si utilizzano i moduli delle caratteristiche:

  • L'installazione di 50 o più moduli di funzionalità su un singolo dispositivo, tramite distribuzione condizionale o on demand, potrebbe causare problemi di prestazioni. I moduli di fase di installazione, che non sono configurati come rimovibili, vengono inclusi automaticamente nel modulo di base e contano come un solo modulo di funzionalità su ciascun dispositivo.
  • Limita il numero di moduli che configuri come rimovibili per la consegna al momento dell'installazione a 10 o meno. In caso contrario, i tempi di download e installazione dell'app potrebbero aumentare.
  • Solo i dispositivi con Android 5.0 (livello API 21) e versioni successive supportano il download e l'installazione di funzionalità on demand. Per rendere la funzionalità disponibile nelle versioni precedenti di Android, abilita Fusing quando crei un modulo delle funzionalità.
  • Abilita SplitCompat, in modo che la tua app abbia accesso ai moduli delle funzionalità scaricati che vengono forniti on demand.
  • I moduli delle funzionalità non devono specificare le attività nel file manifest con l'opzione android:exported impostata su true. Il motivo è che non possiamo garantire che il dispositivo abbia scaricato il modulo delle funzionalità quando un'altra app tenta di avviare l'attività. Inoltre, l'app deve confermare che una funzionalità sia stata scaricata prima di tentare di accedere al relativo codice e alle relative risorse. Per scoprire di più, consulta Gestire i moduli installati.
  • Poiché Play Feature Delivery richiede la pubblicazione dell'app tramite un app bundle, assicurati di essere a conoscenza dei problemi noti relativi all'app bundle.

Riferimento per il file manifest dei moduli delle funzionalità

Quando crei un nuovo modulo di funzionalità utilizzando Android Studio, l'IDE include la maggior parte degli attributi del file manifest necessari al modulo per comportarsi come un modulo di funzionalità. Inoltre, alcuni attributi vengono inseriti dal sistema di compilazione al momento della compilazione, quindi non devi specificarli o modificarli personalmente. La seguente tabella descrive gli attributi del file manifest importanti per i moduli di funzionalità.

Attributo Descrizione
<manifest
...
Questo è il tuo blocco <manifest> tipico.
xmlns:dist="http://schemas.android.com/apk/distribution" Specifica un nuovo spazio dei nomi XML dist: descritto più dettagliatamente di seguito.
split="split_name" Quando Android Studio crea l'app bundle, include questo attributo per te. Pertanto, non devi includere o modificare personalmente questo attributo.

Definisce il nome del modulo, che la tua app specifica quando viene richiesto un modulo on demand utilizzando la libreria Play Feature Delivery.

In che modo Gradle determina il valore di questo attributo:

Per impostazione predefinita, quando crei un modulo di funzionalità utilizzando Android Studio, l'IDE utilizza quello che hai specificato come Nome modulo per identificare il modulo come sottoprogetto Gradle nel tuo file di impostazioni Gradle.

Quando crei l'app bundle, Gradle utilizza l'ultimo elemento del percorso del sottoprogetto per inserire questo attributo manifest nel file manifest del modulo. Ad esempio, se crei un nuovo modulo di funzionalità nella directory MyAppProject/features/ e hai specificato " dynamic_feature1 come Nome modulo, l'IDE aggiunge ':features:dynamic_feature1' come sottoprogetto nel tuo file settings.gradle. Durante la creazione dell'app bundle, Gradle inserisce quindi <manifest split="dynamic_feature1"> nel manifest del modulo.

android:isFeatureSplit="true | false"> Quando Android Studio crea l'app bundle, include questo attributo per te. Pertanto, non devi includere o modificare manualmente questo attributo.

Specifica che questo modulo è un modulo delle funzionalità. I manifest nei moduli di base e negli APK di configurazione omettono questo attributo o lo impostano su false.

<dist:module Questo nuovo elemento XML definisce gli attributi che determinano il modo in cui il modulo viene pacchettizzato e distribuito come APK.
dist:instant="true | false" Specifica se il modulo deve essere disponibile tramite Google Play Instant come esperienza istantanea.

Se la tua app include uno o più moduli di funzionalità ad attivazione istantanea, devi attivare anche il modulo di base ad attivazione istantanea. Se utilizzi Android Studio 3.5 o versioni successive, l'IDE lo fa per te quando crei un modulo di funzionalità ad attivazione istantanea.

Non puoi impostare questo elemento XML su true e allo stesso tempo impostare <dist:on-demand/>. Tuttavia, puoi comunque richiedere il download on demand dei moduli delle funzionalità ad attivazione istantanea come app istantanee utilizzando la libreria Play Feature Delivery. Quando un utente scarica e installa la tua app, il dispositivo scarica e installa i moduli di funzionalità ad attivazione istantanea della tua app, insieme all'APK di base, per impostazione predefinita.

dist:title="@string/feature_name" Specifica un titolo del modulo rivolto agli utenti. Ad esempio, il dispositivo potrebbe visualizzare questo titolo quando richiede la conferma del download.

Devi includere la risorsa stringa per questo titolo nel file module_root/src/source_set/res/values/strings.xml del modulo di base.

<dist:fusing dist:include="true | false" />
</dist:module>
Specifica se includere il modulo in APK multipli destinati ai dispositivi con Android 4.4 (livello API 20) e versioni precedenti.

Inoltre, se utilizzi bundletool per generare APK da un app bundle, nell'APK universale vengono inclusi solo i moduli delle funzionalità che impostano questa proprietà su true, ovvero un APK monolitico che include codice e risorse per tutte le configurazioni dei dispositivi supportate dalla tua app.

<dist:delivery> Incapsula opzioni che personalizzano la distribuzione dei moduli, come mostrato di seguito. Tieni presente che ogni modulo delle funzionalità deve configurare un solo tipo di queste opzioni di distribuzione personalizzate.
<dist:install-time> Specifica che il modulo deve essere disponibile al momento dell'installazione. Questo è il comportamento predefinito per i moduli delle funzionalità che non specificano un altro tipo di opzione di pubblicazione personalizzata.

Per scoprire di più sui download al momento dell'installazione, consulta Configurare la distribuzione al momento dell'installazione.

Questo nodo può anche specificare condizioni che limitano il modulo ai dispositivi che soddisfano determinati requisiti, come le funzionalità dei dispositivi, il paese dell'utente o il livello API minimo. Per saperne di più, consulta Configurare la consegna condizionale.

<dist:removable dist:value="true | false" />

Se il criterio non viene configurato o se viene impostato su false, bundletool unirà i moduli al momento dell'installazione nel modulo di base durante la generazione di APK divisi dal bundle. Poiché l'unione avrà meno APK divisi, questa impostazione potrebbe migliorare le prestazioni della tua app.

Se il criterio removable viene impostato su true: i moduli al momento dell'installazione non verranno integrati nel modulo di base. Imposta su true se vuoi disinstallare i moduli in futuro. Tuttavia, la configurazione di troppi moduli da rimuovere potrebbe aumentare il tempo di installazione dell'app.

Il valore predefinito è false. È necessario impostare questo valore nel manifest solo se vuoi disabilitare l'unione per un modulo di funzionalità.

Nota: questa funzionalità è disponibile solo se si utilizza il plug-in Android Gradle 4.2 o quando si utilizza bundletool v1.0 dalla riga di comando.

</dist:install-time>  
<dist:on-demand/> Specifica che il modulo deve essere disponibile per il download on demand. Ciò significa che il modulo non è disponibile al momento dell'installazione, ma la tua app potrebbe richiedere di scaricarlo in un secondo momento.

Per scoprire di più sui download on demand, consulta Configurare la distribuzione on demand.

</dist:delivery>
<application
android:hasCode="true | false">
...
</application>
Se il modulo delle funzionalità non genera file DEX, ovvero non contiene nessun codice compilato in un secondo momento nel formato file DEX, procedi nel seguente modo (altrimenti potrebbero verificarsi errori di runtime):
  1. Imposta android:hasCode su "false" nel manifest del modulo delle funzionalità.
  2. Aggiungi quanto segue al manifest del modulo base:
    <application
      android:hasCode="true"
      tools:replace="android:hasCode">
      ...
    </application>
    

Risorse aggiuntive

Per scoprire di più sull'utilizzo dei moduli delle funzionalità, prova le seguenti risorse.

Blog post

Video

Termini di servizio e sicurezza dei dati

Accedendo o utilizzando la libreria Play Feature Delivery Library, l'utente accetta i Termini di servizio del kit di sviluppo software di base di Play. Leggi e comprendi tutti i termini e le norme applicabili prima di accedere alla libreria.

Sicurezza dei dati

Le librerie Play Core sono l'interfaccia di runtime dell'app con il Google Play Store. Pertanto, quando utilizzi Play Core nella tua app, il Play Store esegue i propri processi, tra cui la gestione dei dati come regolata dai Termini di servizio di Google Play. Le informazioni riportate di seguito descrivono il modo in cui le librerie Play Core gestiscono i dati per elaborare richieste specifiche della tua app.

API Additional Language

Dati raccolti sull'utilizzo Elenco di lingue installate
Scopo della raccolta dei dati I dati raccolti vengono usati per pubblicare versioni dell'app in diverse lingue e per conservare le lingue installate dopo un aggiornamento dell'app.
Crittografia dei dati I dati sono criptati.
Condivisione dei dati I dati non vengono trasferiti a terze parti.
Eliminazione dei dati I dati vengono eliminati dopo un periodo di conservazione fisso.

Play Feature Delivery

Dati raccolti sull'utilizzo Metadati del dispositivo
Versione applicazione
Scopo della raccolta dei dati I dati raccolti vengono utilizzati per offrire il modulo giusto al dispositivo e per conservare i moduli installati dopo un aggiornamento, un backup e un ripristino.
Crittografia dei dati I dati sono criptati.
Condivisione dei dati I dati non vengono trasferiti a terze parti.
Eliminazione dei dati I dati vengono eliminati dopo un periodo di conservazione fisso.

Anche se puntiamo a essere il più trasparenti possibile, sei tu l'unico responsabile di decidere come rispondere al modulo relativo alla sezione Sicurezza dei dati di Google Play in merito alle misure di raccolta, condivisione e sicurezza dei dati utente della tua app.