lightbulb_outline Please take our October 2018 developer survey. Start survey

Cómo controlar la versión de tu app

El control de versiones es un componente crítico de la estrategia de actualización y mantenimiento de tu app. Su importancia se debe a lo siguiente:

  • Los usuarios deben contar con información específica sobre la versión de la app instalada en sus dispositivos y las versiones de actualización disponibles para su instalación.
  • Otras apps, incluidas las que publiques como un conjunto, deben realizar consultas al sistema respecto de la versión de tu app para determinar la compatibilidad e identificar dependencias.
  • Es posible que los servicios a través de los cuales publicarás tus apps también deban consultar a tu app para conocer su versión, a fin de poder mostrarla a los usuarios. También puede se necesario que un servicio de publicación deba verificar la versión de tu app para determinar la compatibilidad y establecer relaciones de cambio a versiones anteriores o posteriores.

El sistema Android no usa la información sobre la versión de la app para imponer restricciones sobre cambios a versiones anteriores o posteriores, o sobre compatibilidad con aplicaciones de terceros. Como alternativa, tienes la responsabilidad de imponer restricciones de versiones dentro de tu app o de informar a los usuarios sobre las restricciones y limitaciones de la versión. Sin embargo, el sistema Android impone la compatibilidad con la versión del sistema como se expresa en la configuración de minSdkVersion, en los archivos de compilación. Este atributo permite que una app especifique el nivel mínimo de API de sistema que admite. Para obtener más información, consulta Cómo especificar la versión mínima de API del sistema.

Establecer información sobre la versión de la aplicación

Para definir la información de la versión de tu app, establece los valores de la configuración de la versión en los archivos de compilación de Gradle. Estos valores luego se combinarán en el archivo de manifiesto de tu app durante el proceso de compilación.

Nota: Si tu app define la versión de la app directamente en el elemento <manifest>, los valores de la versión en el archivo de compilación de Gradle anularán la configuración en el manifiesto. Además, definir estas configuraciones en los archivos de compilación de Gradle te permite especificar valores diferentes para distintas versiones de tu app. Para obtener una mayor flexibilidad y evitar un posible reemplazo cuando se integre el manifiesto, debes eliminar estos atributos del elemento <manifest> y definir la configuración de tu versión en los archivos de compilación de Gradle.

Se encuentran disponibles dos atributos y debes definir siempre valores para ambos:

  • versionCode: valor entero usado como número de versión interna. Este número se usa solo para determinar si una versión es más reciente que otra; los números más altos indican versiones más recientes. Este no es el número de versión que se muestra a los usuarios, que se establece a través de la configuración versionName, a continuación.

    El valor es entero, por lo que otras app pueden evaluarlo de manera programática; por ejemplo, para comprobar una relación de cambio a versiones anteriores o posteriores. Puedes establecer el valor en cualquier número entero que desees; sin embargo, debes asegurarte de que en cada versión de tu app que siga se use un valor mayor. El sistema no impone este comportamiento, pero aumentar el valor con cada versión sucesiva es la regla.

    Normalmente, lanzarás la primera versión de tu app con versionCode fijado en 1, y luego aumentarás el valor en progresión continua en cada versión, sin importar si la versión es principal o secundaria. Esto significa que el valor versionCode no tiene necesariamente una fuerte semejanza con la versión de lanzamiento de la app que ve el usuario (consulta versionName, a continuación). Los servicios de apps y publicación no deben mostrar el valor de la versión a los usuarios.

    Advertencia: El valor máximo que Google Play permite para versionCode es 2100000000.

  • versionName: string usada como el número de versión que se muestra a los usuarios. Esta configuración se puede especificar como una string sin procesar o como una referencia a un recurso de string.

    El valor es una string, por lo que puedes describir la versión de la app como una string <mayor>.<menor>.<punto> o como cualquier otro tipo de identificador absoluto o relativo de versión. versionName no tiene otro propósito que mostrarse ante los usuarios.

Puedes definir los valores predeterminados para estas configuraciones al incluirlos en el bloque defaultConfig {}, anidados dentro del bloque android {} del archivo build.gradle de tu módulo. Luego puedes anular estos valores predeterminados para diferentes versiones de tu app definiendo valores separados de tipos de compilación individuales o clases de productos. En el siguiente archivo build.gradle se muestran las configuraciones versionCode y versionName en el bloque defaultConfig {}, asi como el bloque productFlavors {}.

android {
  ...
  defaultConfig {
    ...
    versionCode 2
    versionName "1.1"
  }
  productFlavors {
    demo {
      ...
      versionName "1.1-demo"
    }
    full {
      ...
    }
  }
}

En el bloque de este ejemplo defaultConfig {}, el valor versionCode indica que el APK actual contiene la segunda versión de la app y en la string versionName se especifica que aparecerá ante los usuarios como versión 1.1. Este archivo build.gradle también define dos clases de productos, “demo” y “full”. Debido a que la clase de producto “demo” define versionName como “1.1-demo”, la compilación “demo” usa este versionName en lugar del valor predeterminado. El bloque de clase de producto “full” no define versionName. Por lo tanto, este usa el valor predeterminado de “1.1”.

El framework de Android proporciona una API para permitirte realizar consultas al sistema sobre información de la versión de tu app. Para obtener información sobre la versión, usa el método getPackageInfo(java.lang.String, int) de PackageManager.

Nota: Cuando usas Instant Run, Android Studio fija automáticamente versionCode en MAXINT y versionName en "INSTANTRUN".

Especificar los requisitos de nivel de API

Si tu app requiere de una versión específica mínima de la plataforma Android, puedes especificar ese requisito de versión como configuración de nivel de API en el archivo build.gradle de la app. Durante el proceso de compilación, estas configuraciones se combinan con el archivo de manifiesto de tu app. Al especificar los requisitos de nivel de API, garantizas que tu app pueda instalarse únicamente en dispositivos que ejecuten una versión compatible de la plataforma Android.

Nota: Si especificas los requisitos de nivel de API directamente en el archivo de manifiesto de tu app, la configuración correspondiente de los archivos de compilación anulará la del archivo de manifiesto. Además, definir estas configuraciones en los archivos de compilación de Gradle te permite especificar valores diferentes para distintas versiones de tu app. Para obtener una mayor flexibilidad y evitar una posible anulación cuando se integre el manifiesto, deberás eliminar estos atributos del elemento <uses-sdk> y definir las configuraciones de tu nivel de API en los archivos de compilación de Gradle.

Hay dos configuraciones de nivel de API disponibles:

  • minSdkVersion: versión mínima de la plataforma Android en la cual la app podrá ejecutarse, especificada por el identificador de nivel de API de la plataforma.
  • targetSdkVersion: elemento que especifica el nivel de API con el cual la app está diseñada para funcionar. En algunos casos, esto permite que la app use elementos del manifiesto o comportamientos definidos en el nivel de API de destino, en vez de limitarse a usar únicamente aquellos definidos por el nivel mínimo de API.

Para especificar los requisitos de nivel de API predeterminado en un archivo build.gradle, agrega una o más de las configuraciones anteriores al bloque defaultConfig {}, anidado dentro del bloque android {}. También puedes anular estos valores predeterminados para versiones diferentes de tu app agregando las configuraciones a los tipos de compilación o a las clases de productos. En el siguiente archivo build.gradle se especifican las configuraciones predeterminadas de minSdkVersion y targetSdkVersion en el bloque defaultConfig {}, y se anula minSdkVersion para una clase de producto.

android {
  ...
  defaultConfig {
    ...
    minSdkVersion 14
    targetSdkVersion 24
  }
  productFlavors {
    main {
      ...
    }
    afterLollipop {
      ...
      minSdkVersion 21
    }
  }
}

Cuando te preparas para instalar tu app, el sistema verifica el valor de estas configuraciones y las compara con la versión del sistema. Si el valor minSdkVersion es superior al valor de la versión del sistema, este evita que se instale la app.

Si no especificas estas configuraciones, el sistema determina que tu app es compatible con todas las versiones de la plataforma.

Para obtener más información, consulta la documentación sobre el elemento de manifiesto <uses-sdk> y el documento Niveles de API. Para hallar configuraciones de compilación Gradle, consulta Configurar variantes de compilación.