Panoramica di Play Feature Delivery

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

Play Feature Delivery utilizza le funzionalità avanzate degli app bundle, consentendo di caricare alcune funzionalità dell'app in base alle condizioni o di scaricarle on demand. Per farlo, devi prima separare queste funzionalità dall'app di base in moduli di funzionalità.

Configurazione di compilazione del modulo della 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 della funzionalità. Le sezioni seguenti descrivono le proprietà che devi e non devi includere nella configurazione di compilazione del modulo di funzionalità.

Elementi da escludere nella configurazione di compilazione del modulo della funzionalità

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

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

Stabilire una relazione con il modulo di base

Quando Android Studio crea il modulo di 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 della 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

Sebbene solo la configurazione di build del modulo di base possa attivare la riduzione del codice per il progetto dell'app, puoi fornire regole ProGuard personalizzate con ogni modulo di 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 compilazione. Pertanto, anche se ogni modulo di funzionalità può specificare un nuovo insieme di regole, queste regole si applicano a tutti i moduli del progetto dell'app.

Esegui il deployment dell'app

Durante lo sviluppo dell'app con il supporto dei moduli di 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 quali includere durante il deployment dell'app modificando la configurazione di esecuzione/debug esistente come segue:

1. Seleziona Esegui > Modifica configurazioni dalla barra dei menu.
2. Nel riquadro a sinistra della finestra di dialogo Configurazioni di esecuzione/debug, seleziona la configurazione dell'app per Android che preferisci.
3. In Funzionalità dinamiche da implementare nella scheda Generali, seleziona la casella accanto a ogni modulo di funzionalità da includere durante l'implementazione dell'app.
4. Fai clic su OK.

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

Utilizzare i moduli di funzionalità per una pubblicazione personalizzata

Un vantaggio unico dei moduli delle funzionalità è la possibilità di personalizzare come e quando vengono scaricate le diverse funzionalità della tua app sui dispositivi con Android 5.0 (livello API 21) o versioni successive. Ad esempio, per ridurre le dimensioni di download iniziali della tua app, puoi configurare alcune funzionalità in modo che vengano scaricate on demand in base alle necessità oppure soltanto su dispositivi che le supportano, ad esempio la possibilità di scattare foto o supportare le funzionalità di realtà aumentata.

Sebbene per impostazione predefinita tu riceva download altamente ottimizzati quando carichi la tua 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 di funzionalità forniscono i componenti di base per creare funzionalità modulari che puoi configurare in modo che ciascuna possa essere scaricata in base alle esigenze.

Prendi ad esempio un'app che consente agli utenti di acquistare e vendere prodotti in un marketplace online. Puoi modularizzare ragionevolmente ciascuna delle seguenti funzionalità dell'app in moduli di funzionalità distinti:

• Accesso e creazione dell'account
• Esplorazione del marketplace
• Mettere un articolo in vendita
• Elaborazione dei pagamenti

La tabella seguente descrive le diverse opzioni di caricamento supportate dai moduli di funzionalità e come possono essere utilizzate per ottimizzare le dimensioni del download iniziale dell'app marketplace di esempio.

Creazione di un URI per una risorsa

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

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()

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 alla risorsa viene costruita in fase di esecuzione, assicurando che lo spazio dei nomi corretto venga generato dopo il caricamento degli APK suddivisi.

Come esempio di come viene generato l'URI, supponiamo di avere un'app e moduli di funzionalità con i seguenti nomi:

• Nome pacchetto dell'app: com.example.my_app_package
• Nome del pacchetto delle risorse della funzionalità: com.example.my_app_package.my_dynamic_feature

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

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

Questo URI può essere utilizzato dalla tua app per accedere alla risorsa del modulo della funzionalità.

Per convalidare i percorsi nell'URI, puoi utilizzare APK Analyzer per ispezionare l'APK del modulo della funzionalità e determinare il nome del pacchetto:

Considerazioni per i moduli delle funzionalità

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

• L'installazione di 50 o più moduli delle funzionalità su un singolo dispositivo, tramite pubblicazione condizionale o su richiesta, potrebbe causare problemi di prestazioni. I moduli al momento dell'installazione, che non sono configurati come rimovibili, vengono inclusi automaticamente nel modulo di base e conteggiati come un solo modulo delle funzionalità su ogni dispositivo.
• Limita il numero di moduli configurati come rimovibili per il caricamento al momento dell'installazione a 10 o meno. In caso contrario, il tempo di download e installazione dell'app potrebbe aumentare.
• Solo i dispositivi con Android 5.0 (livello API 21) e versioni successive supportano il download e l'installazione delle funzionalità on demand. Per rendere disponibile la funzionalità per le versioni precedenti di Android, abilita Fusing quando crei un modulo di funzionalità.
• Attiva SplitCompat, in modo che la tua app abbia accesso ai moduli di funzionalità scaricati che vengono pubblicati su richiesta.
• I moduli di funzionalità non devono specificare attività nel file manifest con android:exported impostato su true. Questo perché non c'è alcuna garanzia che il dispositivo abbia scaricato il modulo della funzionalità quando un'altra app tenta di avviare l'attività. Inoltre, l'app deve confermare che una funzionalità è 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 di pubblicare l'app utilizzando un app bundle, assicurati di conoscere i problemi noti relativi agli app bundle.

Riferimento manifest del modulo della funzionalità

Quando crei un nuovo modulo di funzionalità utilizzando Android Studio, l'IDE include la maggior parte degli attributi manifest necessari per il comportamento del modulo come modulo di funzionalità. Inoltre, alcuni attributi vengono inseriti dal sistema di compilazione in fase di compilazione, quindi non è necessario specificarli o modificarli manualmente. La tabella seguente descrive gli attributi manifest importanti per i moduli di funzionalità.

Risorse aggiuntive

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

Post del blog

• Nuove funzionalità per aiutarti a sviluppare, rilasciare e far crescere la tua attività su Google Play
• Gli ultimi aggiornamenti di Android App Bundle, inclusa l'API delle lingue aggiuntive
• Patchwork Plaid: una storia di modularizzazione

Video

• Pubblicazione personalizzabile con l'app bundle e facilità di condivisione dei build di test
• Nuovi strumenti per ottimizzare le dimensioni dell'app e aumentare le installazioni su Google Play

Termini di servizio e sicurezza dei dati

Se accedi alla Play Feature Delivery Library o la utilizzi, accetti i Termini di servizio del kit di sviluppo software Play Core. Prima di accedere alla raccolta, leggete e comprendete tutti i termini e le norme vigenti.

Sicurezza dei dati

Le librerie Play Core sono l'interfaccia di runtime della tua app con il Google Play Store. Pertanto, quando utilizzi Play Core nella tua app, il Play Store esegue le proprie procedure, che includono il trattamento dei dati ai sensi dei Termini di servizio di Google Play. Le informazioni riportate di seguito descrivono in che modo le librerie Play Core gestiscono i dati per elaborare richieste specifiche della tua app.

API per altre lingue

Play Feature Delivery

Cerchiamo di essere il più trasparenti possibili, ma sei l'unico responsabile della decisione su come rispondere al modulo della sezione Sicurezza dei dati di Google Play per quanto riguarda le modalità di raccolta, condivisione e sicurezza dei dati utente della tua app.