instalación para dispositivos móviles de Bazel

Informar un problema Ver fuente

Desarrollo iterativo rápido para Android

En esta página, se describe cómo bazel mobile-install agiliza mucho el desarrollo iterativo para Android. Se describen los beneficios de este enfoque en comparación con los desafíos del método tradicional de instalación de apps.

Resumen

Para instalar cambios pequeños en una app para Android de manera muy rápida, haz lo siguiente:

  1. Busca la regla android_binary de la app que quieras instalar.
  2. Para inhabilitar ProGuard, quita el atributo proguard_specs.
  3. Establece el atributo multidex en native.
  4. Establece el atributo dex_shards en 10.
  5. Conecta tu dispositivo con ART (no Dalvik) a través de USB y habilita la depuración por USB en él.
  6. Ejecuta bazel mobile-install :your_target. La app será un poco más lenta de lo habitual.
  7. Edita el código o los recursos de Android.
  8. Ejecuta bazel mobile-install --incremental :your_target.
  9. Disfruta de no tener que esperar mucho.

Estas son algunas opciones de línea de comandos para Bazel que pueden ser útiles:

  • --adb le indica a Bazel qué objeto binario de adb debe usar.
  • Se puede usar --adb_arg para agregar argumentos adicionales a la línea de comandos de adb. Una aplicación útil es seleccionar en qué dispositivo deseas la instalación si tienes varios dispositivos conectados a tu estación de trabajo: bazel mobile-install --adb_arg=-s --adb_arg=<SERIAL> :your_target
  • --start_app inicia la app automáticamente

Si tienes dudas, mira el ejemplo o comunícate con nosotros.

Introducción

Uno de los atributos más importantes de la cadena de herramientas de un desarrollador es la velocidad: existe una gran diferencia entre cambiar el código y verlo ejecutarse en un segundo, y tener que esperar minutos, a veces horas, antes de obtener comentarios sobre si los cambios hacen lo que esperas.

Lamentablemente, la cadena de herramientas tradicional de Android para compilar un archivo .apk implica muchos pasos monolíticos secuenciales, y todos ellos deben realizarse a fin de compilar una app para Android. En Google, esperar cinco minutos para compilar un cambio de una sola línea no era algo inusual en proyectos más grandes, como Google Maps.

bazel mobile-install agiliza el desarrollo iterativo para Android con una combinación de reducción de cambios, fragmentación de trabajo y manipulación inteligente de componentes internos de Android, todo sin cambiar el código de tu app.

Problemas con la instalación de una app tradicional

La compilación de una app para Android presenta algunos problemas, como los siguientes:

  • Conversión a DEX. De forma predeterminada, "dx" se invoca exactamente una vez en la compilación y no sabe cómo volver a usar el trabajo de compilaciones anteriores: dex en cada método nuevamente, aunque solo se haya cambiado uno.

  • Carga de datos al dispositivo: adb no usa todo el ancho de banda de una conexión USB 2.0, y las apps de mayor tamaño pueden tardar mucho tiempo en subirse. Se sube toda la app, incluso si solo cambiaron partes pequeñas (por ejemplo, un recurso o un solo método), lo que puede ser un gran cuello de botella.

  • Compilación en código nativo. Android L presentó ART, un nuevo tiempo de ejecución de Android, que compila apps con anticipación en lugar de hacerlo justo a tiempo como Dalvik. Esto hace que las apps sean mucho más rápidas, a costa de un tiempo de instalación más prolongado. Esta es una buena compensación para los usuarios porque, por lo general, instalan una app una vez y la usan muchas veces, pero esto genera un desarrollo más lento, ya que una app se instala muchas veces y cada versión se ejecuta varias veces.

El enfoque de bazel mobile-install

bazel mobile-install realiza las siguientes mejoras:

  • Conversión a DEX fragmentada. Después de compilar el código Java de la app, Bazel fragmenta los archivos de clase en partes de tamaño similar y, luego, invoca a dx por separado en ellas. No se invoca dx en los fragmentos que no cambiaron desde la última compilación.

  • Transferencia de archivos incremental. Los recursos de Android, los archivos .dex y las bibliotecas nativas se quitan del .apk principal y se almacenan en un directorio de instalación móvil independiente. Esto permite actualizar el código y los recursos de Android de forma independiente sin reinstalar toda la app. Por lo tanto, la transferencia de archivos lleva menos tiempo y solo los archivos .dex que cambiaron se vuelven a compilar en el dispositivo.

  • Cargar partes de la app desde fuera del .apk Se coloca una pequeña aplicación de stub en el APK que carga los recursos de Android, el código Java y el código nativo desde el directorio de instalación para dispositivos móviles del dispositivo y, luego, transfiere el control a la app en sí. Todo esto es transparente para la app, excepto en los casos excepcionales que se describen a continuación.

Conversión a DEX fragmentada

La conversión a DEX fragmentada es bastante sencilla: una vez que se compilan los archivos .jar, una herramienta los fragmenta en archivos .jar separados de aproximadamente el mismo tamaño y, luego, invoca a dx en aquellos que se modificaron desde la compilación anterior. La lógica que determina los fragmentos a convertir a DEX no es específica de Android: solo usa el algoritmo general de reducción de cambios de Bazel.

La primera versión del algoritmo de fragmentación simplemente ordenó los archivos .class en orden alfabético y, luego, recortó la lista en partes de igual tamaño, pero esto resultó ser subóptimo: si se agregaba o quitaba una clase (incluso una anidada o una anónima), todas las clases después de ella se desplazaban en uno, lo que provocaba que esos fragmentos se vuelvan a convertir a DEX. Por lo tanto, se decidió fragmentar paquetes de Java en lugar de clases individuales. Por supuesto, esto aún genera muchos fragmentos a DEX si se agrega o quita un paquete nuevo, pero esto es mucho menos frecuente que agregar o quitar una sola clase.

El archivo BUILD controla la cantidad de fragmentos (mediante el atributo android_binary.dex_shards). En un mundo ideal, Bazel determinaría automáticamente cuántos fragmentos son mejores, pero en la actualidad debe conocer el conjunto de acciones (por ejemplo, comandos que se ejecutarán durante la compilación) antes de ejecutar cualquiera de ellas, por lo que no puede determinar la cantidad óptima de fragmentos porque no sabe cuántas clases de Java habrá en la app. En general, cuantos más fragmentos se vuelven más lentos, más rápido será la compilación y la instalación de la app. Por lo general, el punto óptimo es entre 10 y 50 fragmentos.

Transferencia de archivos incremental

Después de compilar la app, el siguiente paso es instalarla, preferentemente con el menor esfuerzo posible. La instalación consta de los siguientes pasos:

  1. Cómo instalar el .apk (generalmente, se usa adb install)
  2. Cómo subir los archivos .dex, los recursos de Android y las bibliotecas nativas al directorio mobile-install

No hay mucha incrementalidad en el primer paso: la app está instalada o no. Actualmente, Bazel depende del usuario para indicar si debe realizar este paso mediante la opción de línea de comandos --incremental, ya que no puede determinar en todos los casos si es necesario.

En el segundo paso, los archivos de la app provenientes de la compilación se comparan con un archivo de manifiesto en el dispositivo, en el que se indican qué archivos de la app se encuentran en el dispositivo y sus sumas de verificación. Todos los archivos nuevos se suben al dispositivo, se actualizan los archivos modificados y los que se quitaron se borran del dispositivo. Si el manifiesto no está presente, se asume que se deben subir todos los archivos.

Ten en cuenta que se puede engañar al algoritmo de instalación incremental si cambias un archivo en el dispositivo, pero no su suma de verificación en el manifiesto. Esto se podría haber protegido a través del cálculo de la suma de verificación de los archivos en el dispositivo, pero se consideró que esto no valía la pena el aumento del tiempo de instalación.

La aplicación Stub

En la aplicación de stub, se produce la magia para cargar los archivos DEX, el código nativo y los recursos de Android desde el directorio mobile-install del dispositivo.

La carga real se implementa mediante la subclasificación de BaseDexClassLoader y es una técnica razonablemente bien documentada. Esto sucede antes de que se cargue cualquiera de las clases de la app, de modo que cualquier clase de aplicación que se encuentre en el APK se pueda colocar en el directorio mobile-install del dispositivo para que se pueda actualizar sin adb install.

Esto debe ocurrir antes de que se cargue cualquiera de las clases de la app, de modo que ninguna clase de aplicación deba estar en el archivo .apk, lo que significaría que los cambios en esas clases requerirían una reinstalación completa.

Para ello, se reemplaza la clase Application especificada en AndroidManifest.xml por la aplicación stub. De esta manera, se controla cuándo se inicia la app y se ajusta el cargador de clases y el administrador de recursos de manera adecuada en el primer momento (su constructor) usando la reflexión de Java sobre los componentes internos del framework de Android.

Otra cosa que hace la aplicación de stub es copiar las bibliotecas nativas instaladas mediante la instalación para dispositivos móviles en otra ubicación. Esto es necesario porque el vinculador dinámico necesita que se configure el bit X en los archivos, lo cual no es posible en ninguna ubicación a la que pueda acceder un adb no raíz.

Una vez que completas todo esto, la aplicación de stub crea una instancia de la clase Application real y cambia todas las referencias a sí misma a la aplicación real dentro del framework de Android.

Resultados

Rendimiento

En general, bazel mobile-install acelera de 4 a 10 veces la compilación y la instalación de apps grandes después de un pequeño cambio.

Se calcularon las siguientes cifras para algunos productos de Google:

Por supuesto, esto depende de la naturaleza del cambio: la recompilación después de cambiar una biblioteca base lleva más tiempo.

Limitaciones

Los trucos que reproduce la aplicación de stub no funcionan en todos los casos. En los siguientes casos, se destacan los casos en los que no funciona como se espera:

  • Cuando se transmite Context a la clase Application en ContentProvider#onCreate() Se llama a este método durante el inicio de la aplicación antes de que tengamos la oportunidad de reemplazar la instancia de la clase Application; por lo tanto, ContentProvider seguirá haciendo referencia a la aplicación de stub en lugar de a la real. Se podría decir que no es un error, ya que no se supone que no implementes una solución Context de esta manera, pero parece suceder en algunas apps de Google.

  • Los recursos que instala bazel mobile-install solo están disponibles desde la app. Si otras apps acceden a los recursos a través de PackageManager#getApplicationResources(), estos recursos provendrán de la última instalación no incremental.

  • Dispositivos que no ejecutan ART. Si bien la aplicación de stub funciona bien en Froyo y versiones posteriores, Dalvik tiene un error que le hace pensar que la app es incorrecta si su código se distribuye en varios archivos .dex en ciertos casos (por ejemplo, cuando se usan anotaciones Java de manera específica). Siempre y cuando tu app no detecte estos errores, también debería funcionar con Dalvik (ten en cuenta, sin embargo, que la compatibilidad con versiones anteriores de Android no es lo que nos enfocamos).