Skip to content

Most visited

Recently visited

navigation

Configuración de la biblioteca de compatibilidad

La manera en que configuras las bibliotecas de compatibilidad de Android en tu proyecto de desarrollo depende de las funciones que desees usar y la variedad de versiones de plataforma de Android que desees admitir con tu aplicación.

En este documento, recibirás orientación para la descarga del paquete de bibliotecas de compatibilidad y en la adición de bibliotecas a tu entorno de desarrollo.

Descarga de la biblioteca de compatibilidad

El paquete del repositorio de compatibilidad de Android se proporciona como una descarga complementaria para el Android SDK y se encuentra disponible a través de Android SDK Manager. Sigue las instrucciones a continuación para obtener los archivos de la biblioteca de compatibilidad.

Para descargar la biblioteca de compatibilidad a través de SDK Manager:

  1. Inicia Android SDK Manager.
  2. En la ventana de este, desplázate hacia el final de la lista Packages, busca la carpeta de Extras y, si es necesario, expándela para mostrar su contenido.
  3. Selecciona el elemento Android Support Repository.
  4. Haz clic en el botón Install packages....

Figura 1: Repositorio de compatibilidad de Android seleccionado en Android SDK Manager.

Después de la descarga, la herramienta instala los archivos de la biblioteca de compatibilidad en tu directorio de Android SDK existente. Los archivos de biblioteca se encuentran en el siguiente subdirectorio de tu SDK: <sdk>/extras/android/m2repository/com/android/support/.

Elección de bibliotecas de compatibilidad

Antes de agregar una biblioteca de compatibilidad a tu aplicación, decide las funciones que deseas incluir y las versiones anteriores de Android que quieres admitir. Para obtener más información sobre las funciones proporcionadas por las diferentes bibliotecas, consulta las Funciones de la biblioteca de compatibilidad.

Adición de bibliotecas de compatibilidad

Para poder usar una biblioteca de compatibilidad, debes modificar las dependencias de classpath de tu proyecto en tu entorno de desarrollo. Debes realizar este procedimiento con cada biblioteca de compatibilidad que desees usar.

Para agregar una biblioteca de compatibilidad al proyecto de tu aplicación:

  1. Asegúrate de haber descargado el repositorio de compatibilidad de Android con SDK Manager.
  2. Abre el archivo build.gradle para tu aplicación.
  3. Agrega la biblioteca de compatibilidad a la sesión dependencies. Por ejemplo, para agregar la biblioteca de core-utils v4, agrega las siguientes líneas:
    dependencies {
        ...
        compile "com.android.support:support-core-utils:24.2.0"
    }
    

Advertencia: El uso de dependencias dinámicas (por ejemplo, palette-v7:23.0.+) puede generar actualizaciones inesperadas de versiones e incompatibilidades de regresión. Te recomendamos especificar de modo explícito una versión de biblioteca (por ejemplo, palette-v7:24.2.0).

Uso de las Support Library API

Las clases de bibliotecas de compatibilidad que proporcionan compatibilidad con las API de framework existente normalmente tienen el mismo nombre que la clase framework pero se ubican en los paquetes de clase android.support o tienen un sufijo *Compat.

Advertencia: Cuando uses clases de la biblioteca de compatibilidad, asegúrate de importar la clase desde el paquete correspondiente. Por ejemplo, al aplicar la clase ActionBar:

  • android.support.v7.app.ActionBar cuando uses la biblioteca de compatibilidad.
  • android.app.ActionBar cuando realices desarrollos únicamente para el nivel de API 11 o niveles posteriores.

Nota: Después de incluir la biblioteca de compatibilidad en el proyecto de tu aplicación, te recomendamos usar la herramienta ProGuard para preparar el lanzamiento del APK de tu aplicación. Además de proteger tu código fuente, la herramienta ProGuard también quita las clases no usadas de cualquier biblioteca que incluyas en tu aplicación, lo cual reduce al máximo posible el tamaño de descarga de esta. Para obtener más información, consulta ProGuard.

En las clases de capacitación, las guías y las muestras para desarrolladores de Android se proporciona información adicional sobre el uso de las funciones de la biblioteca de compatibilidad. Para obtener más información acerca de las clases y los métodos de las bibliotecas de compatibilidad individuales, consulta los paquetes android.support en la referencia de API.

Cambios en la declaración del manifiesto

Si planeas aumentar la compatibilidad con versiones anteriores de tu aplicación existente para que admita una versión anterior de la Android API con la biblioteca de compatibilidad, asegúrate de actualizar el manifiesto de tu aplicación. Específicamente, debes actualizar el elemento android:minSdkVersion de la pestaña <uses-sdk> del manifiesto al número nuevo de la versión anterior, como se muestra a continuación:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

La configuración del manifiesto indica a Google Play que tu aplicación se puede instalar en dispositivos con Android 4.0 (nivel de API 14) y versiones posteriores.

Si usas archivos de compilación de Gradle, la configuración minSdkVersion en de estos archivos anula las configuraciones del manifiesto.

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

En este caso, la configuración del archivo de compilación indica a Google Play que la variante de compilación predeterminada de tu aplicación se puede instalar en dispositivos con Android 4.1 (nivel de API 16) y versiones posteriores. Para obtener más información sobre variantes de compilación, consulta Información general del sistema de compilación.

Nota: Si incluyes varias bibliotecas de compatibilidad, la versión de SDK mínima debe ser la más alta que requieran las bibliotecas especificadas. Por ejemplo, si tu app incluye la biblioteca de compatibilidad de preferencias v14 y la biblioteca Leanback v17, tu versión mínima de SDK debe ser la 17 o una posterior.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)