La Vista previa para desarrolladores de Android 11 ya está disponible. Pruébala y comparte tus comentarios.

Cómo crear un paquete de aplicación instantánea

Para crear una experiencia de Google Play Instant, debes incluirla como parte de un Android App Bundle. Este paquete se conoce como paquete de aplicación instantánea. En este documento, se muestra cómo configurar el entorno de desarrollo para paquetes de aplicación instantánea, además de cómo configurar, compilar, probar y publicar un paquete de aplicación instantánea.

Si ya tienes un proyecto de app instantánea que usa el complemento obsoleto de funciones (com.android.feature), obtén información sobre cómo migrar tu app instantánea para admitir Android App Bundles.

Cómo configurar el entorno de desarrollo

Para proporcionar una experiencia instantánea dentro de un paquete de aplicación, necesitas acceso al SDK de desarrollo de Google Play Instant. Puedes instalarlo utilizando uno de los siguientes métodos:

  • Instala Android Studio 3.3 o una versión posterior. Después de abrir Android Studio, descarga el SDK de desarrollo de Google Play Instant desde la pestaña SDK Tools de SDK Manager.
  • Realiza la instalación desde la línea de comandos:

        cd path/to/android/sdk/tools/bin && \
          ./sdkmanager 'extras;google;instantapps'
        

Además, si deseas probar tu experiencia instantánea de forma local, debes obtener acceso a un dispositivo físico o virtual.

Cómo configurar un proyecto para experiencias instantáneas

Para que sea compatible con Google Play Instant, debes configurar atentamente varios aspectos del paquete de aplicación instantánea. En las siguientes secciones, se describen estas consideraciones.

Módulos de aplicación instantánea

Puedes declarar que tu paquete de aplicación admite experiencias instantáneas utilizando uno de los siguientes métodos:

  • Si creas un proyecto nuevo en Android Studio, durante la etapa Configure your project, selecciona la casilla de verificación This project will support instant apps.
  • Si tienes un paquete de aplicación existente que solo contiene un módulo base, puedes habilitarlo para apps instantáneas agregando la siguiente declaración al manifiesto del módulo:

    <manifest ... xmlns:dist="http://schemas.android.com/apk/distribution">
            <dist:module dist:instant="true" />
            ...
        </manifest>
        
  • Si ya tienes un paquete de aplicación que contiene varios módulos, puedes crear un módulo de funciones dinámicas de aplicación instantánea. Este proceso también habilita el módulo base de tu app para apps instantáneas, lo que te brinda la opción de admitir varios puntos de entrada instantáneos.

Permisos compatibles

Los paquetes de aplicación instantánea solo pueden usar permisos de la siguiente lista:

Acceso a aplicaciones instaladas

Cuando desarrolles una experiencia instantánea, ten en cuenta que no puedes interactuar con las apps instaladas en un dispositivo, a menos que uno de los siguientes puntos sea verdadero:

  • Una o más actividades de una app instalada establecieron el elemento android:visibleToInstantApps como true: este elemento está disponible para las apps que ejecutan Android 8.0 (API nivel 26) o una versión posterior.
  • Una app instalada contiene un filtro de intents que incluye CATEGORY_BROWSABLE.
  • La experiencia instantánea envía un intent utilizando la acción ACTION_SEND, ACTION_SENDTO o ACTION_SEND_MULTIPLE.

Entorno de ejecución

Google Play Instant ejecuta paquetes de apps instantáneas en un tipo especial de zona de pruebas de SELinux con el objetivo de ofrecer una mayor seguridad. Para que tu paquete de app instantánea sea compatible con ese entorno, debes crear dentro de él la siguiente configuración:

Cómo compilar el paquete de aplicación

Puedes usar Android Studio o la interfaz de línea de comandos para compilar tu app instantánea.

Android Studio

En Android Studio, puedes compilar tu paquete de aplicación seleccionando Build > Build Bundle(s) / APK(s) > Build Bundle(s). Para obtener más información sobre cómo compilar tu proyecto, consulta Cómo compilar un proyecto.

Interfaz de línea de comandos

También puedes compilar el paquete de aplicación desde la línea de comandos utilizando Gradle. Después de realizar esta compilación, ejecuta el siguiente comando para realizar un control de funcionalidad de la experiencia instantánea:

    ia check app-artifact
    

El artefacto de la app puede ser un archivo ZIP, un paquete de aplicación o una lista de APK que contenga al menos una experiencia instantánea.

Cómo probar la experiencia instantánea

Antes de publicar tu paquete de app instantánea, prueba la experiencia desde una de las siguientes ubicaciones a fin de comprobar la funcionalidad:

Android Studio

Para probar la experiencia instantánea de tu app en una máquina local con Android Studio, sigue estos pasos:

  1. Si tienes una versión instalada de tu app en el dispositivo de prueba, desinstálala.
  2. En Android Studio, en las opciones de instalación que aparecen en la pestaña General del diálogo Run/Debug Configurations, habilita la casilla de verificación Deploy as instant app.
  3. Selecciona Run > Run en la barra de menú o haz clic en Run en la barra de herramientas. Luego, elige el dispositivo en el que quieras probar las experiencias instantáneas de tu app. La experiencia instantánea de tu app se carga en el dispositivo de prueba que elegiste.

Interfaz de línea de comandos

Para probar la experiencia instantánea de tu app en una máquina local con Android Studio, sigue estos pasos:

  1. Si tienes una versión instalada de tu app en el dispositivo de prueba, desinstálala.
  2. Para cargar y ejecutar tu app instantánea en el dispositivo de prueba, ingresa el siguiente comando:
    ia run output-from-build-command
    

Segmento de prueba interna

Para probar la experiencia instantánea de tu app desde Play Store o un banner de sitio web, publica la app en el segmento de prueba interna de Play Console. Para ello, completa los siguientes pasos:

  1. Para subir tu paquete de aplicación, sigue los pasos que se indican en la guía Cómo subir tu paquete de aplicación a Play Console.
  2. Prepara el paquete que subiste para iniciarlo en el segmento de prueba interna. Para obtener más información, consulta el artículo de asistencia sobre cómo preparar e implementar versiones.
  3. Accede a una cuenta de verificador interno en un dispositivo y, luego, inicia tu experiencia instantánea desde una de las siguientes opciones:

    • El botón Probar ahora de la ficha de Play Store de tu app
    • Un vínculo de un banner del sitio web de tu app

Cómo publicar el paquete de aplicación en el segmento de producción

Para publicar tu paquete de aplicación instantánea, sigue estos pasos:

  1. Si aún no lo hiciste, firma el paquete de tu aplicación con una clave de lanzamiento y súbelo a Play Console.
  2. En Play Console, abre Administración de lanzamientos > Apps instantáneas Android y ve hasta el segmento de producción de apps instantáneas.
  3. Selecciona Actualizar desde la biblioteca y, luego, elige el paquete de apps instantáneas que subiste.

Recursos adicionales

Para obtener más información sobre cómo crear experiencias instantáneas y Android App Bundles, consulta los siguientes recursos:

Cómo compilar una app instantáneamente
Obtén información sobre cómo agregar una experiencia instantánea a un Android App Bundle en esta sesión de Android Dev Summit 2018.
Video: Cómo publicar apps más pequeñas con Android App Bundle
Obtén información sobre cómo los paquetes de aplicación te ayudan a desarrollar tu app con mayor rapidez y a compilar APK más pequeños para los usuarios.
Codelab: Tu primer Android App Bundle
Consulta esta guía paso a paso para compilar un Android App Bundle y agregarle funciones.
El formato de Android App Bundle
Obtén más información sobre cómo el programa de línea de comandos bundletool organiza un paquete de aplicación a partir del código y los recursos de tu app.