Cómo crear varios APK

Precaución: Desde agosto de 2021, todas las apps nuevas deben publicarse como App Bundles. Si publicas tu app en Google Play, compila y sube un Android App Bundle. Cuando lo haces, Google Play genera y publica automáticamente los APKs optimizados para la configuración del dispositivo de cada usuario, de modo que solo descarguen el código y los recursos que necesitan para ejecutar tu app. Publicar varios APKs es útil si publicas en una tienda que no admite el formato AAB. En ese caso, deberás compilar, firmar y administrar cada APK tú mismo.

Si bien es mejor compilar un solo APK que admita todos los dispositivos de destino siempre que sea posible, quizá se genere uno muy grande debido a la cantidad de archivos que admiten varias interfaces binarias de aplicación (ABIs). Una forma de reducir el tamaño de tu APK es crear varios APK que contengan archivos para ABIs específicas.

Gradle puede crear APKs separados que solo contengan el código y los recursos específicos de cada ABI. En esta página, se describe cómo configurar tu compilación a fin de generar varios APK. Si necesitas crear diferentes versiones de tu app que no se basen en la ABI, usa variantes de compilación en su lugar.

Cómo configurar tu compilación para varios APK

A fin de configurar tu compilación para varios APK, agrega un bloque splits a tu archivo build.gradle a nivel del módulo. Dentro del bloque splits, proporciona un bloque abi que especifique cómo deseas que Gradle genere los APK por ABI.

Cómo configurar varios APK para las ABI

A fin de crear APK separados para diferentes ABI, agrega un bloque abi dentro de tu bloque splits. En el bloque abi, proporciona una lista de las ABI deseadas.

Para configurar varios APK por ABI, se usan las siguientes opciones de Gradle DSL:

enable para Groovy o isEnable para la secuencia de comandos de Kotlin

Si configuras este elemento en true, Gradle generará varios APKs basados en las ABIs que definas. El valor predeterminado es false.

exclude

Especifica una lista de ABIs separadas por comas para las que no deseas que Gradle genere APKs separados. Usa exclude si quieres generar APKs para la mayoría de las ABIs, pero necesitas excluir algunas que tu app no admite.

reset()

Borra la lista predeterminada de ABIs. Solo se usa junto con el elemento include a fin de especificar las ABIs que quieres agregar.

En el siguiente fragmento, se configura la lista de ABIs únicamente en x86 y x86_64 llamando a reset() para borrar la lista y, luego, usando include:

reset()                 // Clears the default list from all ABIs to no ABIs.
include "x86", "x86_64" // Specifies the two ABIs we want to generate APKs for.

include

Especifica una lista de ABIs separadas por comas para las que deseas que Gradle genere APKs. Solo se usa junto con reset() para especificar una lista exacta de ABIs.

universalApk para Groovy o isUniversalApk para la secuencia de comandos de Kotlin

Si se configura en true, Gradle generará un APK universal además de los APK por ABI. Un APK universal contiene el código y los recursos para todas las ABI en un solo APK. El valor predeterminado es false.

En el siguiente ejemplo, se genera un APK separado para cada ABI: x86 y x86_64. Para ello, se usa reset() a fin de comenzar con la lista vacía de ABI, seguida de include con una lista de ABI para las que se generará un APK.

Groovy

android {
  ...
  splits {

    // Configures multiple APKs based on ABI.
    abi {

      // Enables building multiple APKs per ABI.
      enable true

      // By default all ABIs are included, so use reset() and include to specify that you only
      // want APKs for x86 and x86_64.

      // Resets the list of ABIs for Gradle to create APKs for to none.
      reset()

      // Specifies a list of ABIs for Gradle to create APKs for.
      include "x86", "x86_64"

      // Specifies that you don't want to also generate a universal APK that includes all ABIs.
      universalApk false
    }
  }
}

Kotlin

android {
  ...
  splits {

    // Configures multiple APKs based on ABI.
    abi {

      // Enables building multiple APKs per ABI.
      isEnable = true

      // By default all ABIs are included, so use reset() and include to specify that you only
      // want APKs for x86 and x86_64.

      // Resets the list of ABIs for Gradle to create APKs for to none.
      reset()

      // Specifies a list of ABIs for Gradle to create APKs for.
      include("x86", "x86_64")

      // Specifies that you don't want to also generate a universal APK that includes all ABIs.
      isUniversalApk = false
    }
  }
}

Consulta la lista de las ABI admitidas aquí.

Proyectos sin código nativo/C++

Para los proyectos sin código nativo/C++, el panel Build Variants tiene dos columnas: Module y Active Build Variant, como se muestra en la figura 1.

Figura 1. El panel Build Variants tiene dos columnas para los proyectos sin código nativo/C++.

El valor Active Build Variant del módulo determina la variante de compilación que se implementa y que se puede ver en el editor. Para alternar entre variantes, haz clic en la celda Active Build Variant de un módulo y elige la variante que desees en el campo de lista.

Proyectos con código nativo/C++

Para proyectos con código nativo/C++, el panel Build Variants tiene tres columnas: Module, Active Build Variant y Active ABI, como se muestra en la figura 2.

Figura 2: El panel Build Variants agrega la columna Active ABI para los proyectos con código nativo/C++.

El valor Active Build Variant del módulo determina la variante de compilación que se implementa y que se puede ver en el editor. En el caso de los módulos nativos, el valor Active ABI determina la ABI que usa el editor, pero no afecta lo que se implementa.

Para cambiar el tipo de compilación o ABI, haz lo siguiente:

Haz clic en la celda de la columna Active Build Variant o Active ABI.
Elige la variante o la ABI que desees del campo de la lista. Se ejecuta automáticamente una nueva sincronización.

Si modificas cualquiera de las columnas de una app o un módulo de biblioteca, se aplicará el cambio a todas las filas dependientes.

Cómo configurar el control de versiones

De forma predeterminada, cuando Gradle genera varios APK, cada uno de estos tiene la misma información de versión, según se especificó en el archivo build.gradle o build.gradle.kts a nivel del módulo. Dado que Google Play Store no permite varios APKs para la misma app que tengan la misma información de versión, debes asegurarte de que cada APK tenga un versionCode único antes de subirlo a Play Store.

Puedes configurar tu archivo build.gradle a nivel del módulo para anular el versionCode de cada APK. Si creas una asignación que asigne un valor numérico único a cada ABI para la que configures varios APKs, puedes anular el código de versión de salida con un valor que combine el código de versión definido dentro del bloque defaultConfig o productFlavors con el valor numérico asignado a la ABI.

En el siguiente ejemplo, el APK para la ABI x86 obtiene un versionCode de 2004 y la ABI x86_64 obtiene un versionCode de 3004.

Asignar códigos de versión en grandes incrementos (por ejemplo, de a 1, 000) te permitirá asignar códigos de versión únicos más adelante en caso de que necesites actualizar tu app. Por ejemplo, si defaultConfig.versionCode itera a 5 en una actualización posterior, Gradle asigna un versionCode de 2005 al APK x86 y de 3005 al APK x86_64.

Sugerencia: Si tu compilación incluye un APK universal, asígnale un versionCode que sea inferior al de los otros APK. Dado que Google Play Store instala la versión de tu app que es compatible con el dispositivo objetivo y tiene el valor versionCode más alto, asignar un versionCode inferior al del APK universal garantiza que Google Play Store intente instalar uno de tus APK antes de recurrir al APK universal. En el siguiente código de ejemplo, se realiza esta acción sin anular el versionCode predeterminado de un APK universal.

Groovy

android {
  ...
  defaultConfig {
    ...
    versionCode 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
ext.abiCodes = ['armeabi-v7a':1, x86:2, x86_64:3]

import com.android.build.OutputFile

// For each APK output variant, override versionCode with a combination of
// ext.abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
android.applicationVariants.all { variant ->

  // Assigns a different version code for each output APK
  // other than the universal APK.
  variant.outputs.each { output ->

    // Stores the value of ext.abiCodes that is associated with the ABI for this variant.
    def baseAbiVersionCode =
            // Determines the ABI for this variant and returns the mapped value.
            project.ext.abiCodes.get(output.getFilter(OutputFile.ABI))

    // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
    // the following code doesn't override the version code for universal APKs.
    // However, because you want universal APKs to have the lowest version code,
    // this outcome is desirable.
    if (baseAbiVersionCode != null) {

      // Assigns the new version code to versionCodeOverride, which changes the
      // version code for only the output APK, not for the variant itself. Skipping
      // this step causes Gradle to use the value of variant.versionCode for the APK.
      output.versionCodeOverride =
              baseAbiVersionCode * 1000 + variant.versionCode
    }
  }
}

Kotlin

android {
  ...
  defaultConfig {
    ...
    versionCode = 4
  }
  splits {
    ...
  }
}

// Map for the version code that gives each ABI a value.
val abiCodes = mapOf("armeabi-v7a" to 1, "x86" to 2, "x86_64" to 3)

import com.android.build.api.variant.FilterConfiguration.FilterType.*

// For each APK output variant, override versionCode with a combination of
// abiCodes * 1000 + variant.versionCode. In this example, variant.versionCode
// is equal to defaultConfig.versionCode. If you configure product flavors that
// define their own versionCode, variant.versionCode uses that value instead.
androidComponents {
    onVariants { variant ->

        // Assigns a different version code for each output APK
        // other than the universal APK.
        variant.outputs.forEach { output ->
            val name = output.filters.find { it.filterType == ABI }?.identifier

            // Stores the value of abiCodes that is associated with the ABI for this variant.
            val baseAbiCode = abiCodes[name]
            // Because abiCodes.get() returns null for ABIs that are not mapped by ext.abiCodes,
            // the following code doesn't override the version code for universal APKs.
            // However, because you want universal APKs to have the lowest version code,
            // this outcome is desirable.
            if (baseAbiCode != null) {
                // Assigns the new version code to output.versionCode, which changes the version code
                // for only the output APK, not for the variant itself.
                output.versionCode.set(baseAbiCode * 1000 + (output.versionCode.get() ?: 0))
            }
        }
    }
}

Para obtener más ejemplos de esquemas de códigos de versión alternativos, consulta Cómo asignar códigos de versión.

Cómo crear varios APK

Una vez que hayas configurado tu archivo build.gradle o build.gradle.kts a nivel del módulo para compilar varios APK, haz clic en Build > Build APK para compilar todos los APK del módulo seleccionado en el panel Project. Gradle crea los APK para cada ABI en el directorio build/outputs/apk/ del proyecto.

Gradle compila un APK para cada ABI para la que configuras varios APK.

Por ejemplo, el siguiente fragmento de build.gradle permite compilar varios APK para las ABI x86 y x86_64:

Groovy

...
  splits {
    abi {
      enable true
      reset()
      include "x86", "x86_64"
    }
  }

Kotlin

...
  splits {
    abi {
      isEnable = true
      reset()
      include("x86", "x86_64")
    }
  }

En el resultado de la configuración de ejemplo, se incluyen los 4 APK siguientes:

app-X86-release.apk: Contiene código y recursos para la ABI x86.
app-X86_64-release.apk: Contiene código y recursos para la ABI x86_64.

A su vez, al compilar varios APK basados en la ABI, Gradle solo generará un APK que incluya el código y los recursos para todas las ABI si especificas universalApk true en el bloque splits.abi de tu archivo build.gradle (para Groovy) o isUniversalApk = true en el bloque splits.abi de tu archivo build.gradle.kts (para la secuencia de comandos de Kotlin).

Formato de nombre de archivo APK

Cuando compilas varios APK, Gradle genera nombres de archivos APK con el siguiente esquema:

modulename-ABI-buildvariant.apk

Los componentes del esquema son los siguientes:

modulename: Especifica el nombre del módulo que se está compilando.
ABI: Si se habilitan varios APK para la ABI, especifica la ABI del APK, por ejemplo, x86.
buildvariant: Especifica la variante de compilación que se está compilando, por ejemplo, debug.

Cómo crear varios APK Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cómo configurar tu compilación para varios APK

Cómo configurar varios APK para las ABI

Groovy

Kotlin

Proyectos sin código nativo/C++

Proyectos con código nativo/C++

Cómo configurar el control de versiones

Groovy

Kotlin

Cómo crear varios APK

Groovy

Kotlin

Formato de nombre de archivo APK

Cómo crear varios APK