Descripción general de la entrega de funciones en Play

El modelo de entrega de apps de Google Play usa paquetes Android App Bundle a fin de generar y publicar APK optimizados para la configuración del dispositivo de cada usuario, de manera que los usuarios descarguen solo el código y los recursos necesarios para ejecutar la app.

Play Feature Delivery usa capacidades avanzadas de los paquetes de aplicaciones, lo que permite que ciertas funciones de tu app se entreguen de manera condicional o se descarguen a pedido. Para ello, primero debes separar estas funciones de tu app de base en módulos de funciones.

Configuración de compilación de módulos de funciones

Cuando creas un nuevo módulo de funciones con Android Studio, el IDE aplica el siguiente complemento de Gradle al archivo build.gradle del módulo.

// 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'
}

Muchas de las propiedades disponibles para el complemento de app estándar también están disponibles a fin de que puedas utilizarlas en tu módulo de funciones. En las siguientes secciones, se describen las propiedades que deberías y las que no deberías incluir en la configuración de compilación de tu módulo de funciones.

Elementos que no debes incluir en la configuración de compilación del módulo de funciones

Debido a que cada módulo de funciones depende del módulo base, también hereda ciertas configuraciones. Por lo tanto, en el archivo build.gradle del módulo de funciones, debes omitir lo siguiente:

• Configuraciones de firma: Los paquetes de aplicación se firman con las configuraciones de firma que especificas en el módulo base.
• La propiedad minifyEnabled: Puedes habilitar la reducción de código para todo el proyecto de la app solo desde la configuración de compilación del módulo base. Por lo tanto, debes omitir esa propiedad en los módulos de funciones. No obstante, puedes especificar reglas adicionales de ProGuard para cada módulo de funciones.
• versionCode y versionName: cuando se compila el paquete de aplicación, Gradle utiliza la información de versión de la app que proporciona el módulo base. Debes omitir esas propiedades del archivo build.gradle de tu módulo de funciones.

Cómo establecer una relación con el módulo base

Cuando Android Studio crea tu módulo de funciones, lo hace visible para el módulo base agregando la propiedad android.dynamicFeatures al archivo build.gradle del módulo base, como se muestra a continuación:

// 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"]
}

Además, Android Studio incluye el módulo base como una dependencia del módulo de funciones, según se muestra a continuación:

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

Cómo especificar reglas adicionales de ProGuard

Aunque solo la configuración de compilación del módulo base puede habilitar la reducción del código para el proyecto de tu app, puedes proporcionar reglas de ProGuard personalizadas con cada módulo de funciones a través de la propiedad proguardFiles, como se muestra a continuación.

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

Ten en cuenta que estas reglas de ProGuard se fusionan con las de otros módulos (incluido el módulo base) durante la compilación. Por lo tanto, si bien cada módulo de funciones puede especificar un nuevo conjunto de reglas, esas reglas se aplican a todos los módulos del proyecto de la app.

Cómo implementar la app

Mientras desarrollas una app compatible con módulos de funciones, puedes implementarla en un dispositivo conectado como lo harías normalmente seleccionando Run > Run en la barra de menú (o haciendo clic en Run en la barra de herramientas).

Si el proyecto de tu app incluye uno o más módulos de funciones, puedes elegir qué funciones incluir cuando implementas tu app si modificas tu configuración de ejecución y depuración existente de la siguiente manera:

1. Selecciona Run > Edit Configurations en la barra de menú.
2. En el panel izquierdo del cuadro de diálogo Run/Debug Configurations, elige la configuración de Android App que desees.
3. En Dynamic features to deploy, en la pestaña General, marca la casilla junto a cada módulo de funciones dinámicas que desees incluir cuando implementes la app.
4. Haz clic en OK.

De forma predeterminada, Android Studio no implementa la app usando paquetes de aplicación. En cambio, el IDE crea e instala en tu dispositivo los APK optimizados para la velocidad de implementación, en lugar del tamaño del APK. Si quieres configurar Android Studio para que compile e implemente APK y experiencias instantáneas desde un paquete de aplicación, modifica la configuración de ejecución y depuración.

Cómo usar módulos de funciones para la entrega personalizada

Un beneficio único de los módulos de funciones es la habilidad de personalizar cómo y cuándo se descargan las diferentes funciones de la app en dispositivos con Android 5.0 (nivel de API 21) o versiones posteriores. Por ejemplo, a fin de reducir el tamaño de la descarga inicial de tu app, puedes configurar ciertas funciones para que se descarguen a pedido según sea necesario o solo en dispositivos que admitan ciertas capacidades, como la posibilidad de tomar fotografías o admitir funciones de realidad aumentada.

Si bien cuando subes tu app como un paquete de aplicación obtienes una descarga altamente optimizada de manera predeterminada, las opciones de entrega de funciones más avanzadas y personalizables requieren una configuración adicional y la modularización de las funciones de la app mediante módulos de funciones. Es decir, los módulos de funciones proporcionan los componentes básicos para crear funciones modulares que puedes configurar a fin de que se descarguen según sea necesario.

Piensa en una app que permite a los usuarios comprar y vender bienes en un mercado en línea. Puedes modularizar razonablemente cada una de las siguientes funciones de la app en módulos de funciones independientes:

• Acceso y creación de cuentas
• Navegación por el mercado
• Colocación de un artículo a la venta
• Procesamiento de pagos

En la tabla que sigue, se describen las diferentes opciones de entrega que admiten los módulos de funciones y cómo se pueden usar para optimizar el tamaño de descarga inicial en el ejemplo de la aplicación de Marketplace.

Cómo compilar un URI para un recurso

Si deseas acceder a un recurso almacenado en un módulo de funciones mediante un URI, consulta la siguiente información para aprender a generar un URI de recurso de módulo de funciones con 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();

Cada parte de la ruta de acceso al recurso se construye en el tiempo de ejecución, lo que garantiza que se genere el espacio de nombres correcto después de cargar los APK divididos.

Si deseas un ejemplo de cómo se genera el URI, supongamos que tienes una app y módulos de funciones con estos nombres:

• Nombre del paquete de apps: com.example.my_app_package
• Nombre del paquete de recursos de la función: com.example.my_app_package.my_dynamic_feature

Si el resId del fragmento de código anterior hace referencia a un recurso de archivos sin procesar con el nombre "my_video" en tu módulo de funciones, entonces el código de Uri.Builder() debería generar el siguiente resultado:

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

Tu app puede usar este URI para acceder al recurso del módulo de funciones.

Para validar las rutas de acceso de tu URI, puedes usar el Analizador de APK a fin de inspeccionar el APK del módulo de funciones y determinar el nombre del paquete:

Figura 2: Usa el Analizador de APK para inspeccionar el nombre del paquete en un archivo de recursos compilado.

Consideraciones para los módulos de funciones

Con los módulos de funciones, puedes mejorar la velocidad de compilación y la de ingeniería, y personalizar ampliamente la entrega de las funciones de tu app a fin de reducir su tamaño. Sin embargo, hay algunas limitaciones y casos extremos que se deben tener en cuenta cuando se usan módulos de funciones:

• Instalar 50 módulos de funciones o más en un solo dispositivo, a través de la entrega condicional o a pedido, puede generar problemas de rendimiento. Los módulos de tiempo de instalación, que no están configurados como extraíbles, se incluyen automáticamente en el módulo base y solo se cuentan como un módulo de funciones en cada dispositivo.
• Limita la cantidad de módulos que configures como extraíbles para la entrega en el momento de la instalación a 10 o menos. De lo contrario, el tiempo de descarga e instalación de tu app podría aumentar.
• Solo los dispositivos con Android 5.0 (nivel de API 21) y versiones posteriores admiten la descarga y la instalación de funciones a pedido. Para que la función esté disponible en versiones anteriores de Android, habilita Fusing cuando crees un módulo de funciones.
• Habilita SplitCompat para que la app tenga acceso a los módulos de funciones descargados que se entregan a pedido.
• Los módulos de funciones no deben especificar actividades en su manifiesto con android:exported establecido en true. Esto se debe a que no hay garantía de que el dispositivo haya descargado el módulo de funciones cuando otra app intente iniciar la actividad. Además, tu app debe confirmar que se descarga una función antes de intentar acceder a su código y a sus recursos. Para obtener más información, consulta Cómo administrar módulos instalados.
• Dado que la entrega de funciones de Play requiere que publiques tu app con un paquete de aplicación, asegúrate de tener en cuenta los problemas conocidos del paquete de aplicación.

Referencia del manifiesto del módulo de funciones

Cuando creas un módulo de funciones nuevo con Android Studio, el IDE incluye la mayoría de los atributos de manifiesto que el módulo requiere para comportarse como un módulo de funciones. Además, el sistema de compilación inserta algunos atributos en el tiempo de compilación, por lo que no necesitas especificarlos ni modificarlos. En la tabla siguiente, se describen los atributos de manifiesto que son importantes para los módulos de funciones.

Recursos adicionales

Para obtener más información sobre el uso de los módulos de funciones, consulta los siguientes recursos.

Entradas de blog

• Nuevas funciones que ayudan a desarrollar, lanzar y expandir tu empresa en Google Play
• Últimas actualizaciones de Android App Bundle, incluida la API de idiomas adicionales
• La reinvención de Plaid: Una historia de modularización (en inglés)

Videos

• Entrega personalizable con el paquete de aplicación e intercambio fácil de compilaciones de prueba (en inglés)
• Nuevas herramientas para optimizar el tamaño de tu app y aumentar las instalaciones en Google Play

Condiciones del Servicio y seguridad de los datos

Si accedes a la Biblioteca de Play Feature Delivery o la usas, significa que aceptas las Condiciones del Servicio del kit de desarrollo de software de Play Core. Asegúrate de leer y entender todas las condiciones y políticas aplicables antes de acceder a la API.

Seguridad de los datos

Las bibliotecas de Play Core son la interfaz de tiempo de ejecución de tu app con Google Play Store. Por lo tanto, cuando usas Play Core en tu app, Play Store ejecuta sus propios procesos, que incluyen el manejo de datos en virtud de las Condiciones del Servicio de Google Play. La siguiente información describe cómo las bibliotecas de Play Core manejan los datos para procesar solicitudes específicas de tu app.

API de Additional Languages

Play Feature Delivery

Si bien nuestro objetivo es ser lo más transparentes que podamos, eres el único responsable de decidir cómo responder el formulario de la sección de Seguridad de datos de Google Play en relación con las prácticas de seguridad, el uso compartido y la recopilación de datos del usuario de tu app.