Nota: Con el lanzamiento de la biblioteca de compatibilidad 28.0.0, el paquete android.support
empaquetado
las bibliotecas dejaron de estar disponibles y se reemplazaron por Jetpack con versiones individuales
bibliotecas empaquetadas como androidx
. La primera versión 1.0.0
de las bibliotecas de Jetpack proporciona paridad con la biblioteca de compatibilidad 28.0.0 y ofrece un
punto de partida para migrar a la nueva androidx
empaquetado.
Las bibliotecas empaquetadas en android.support
existentes seguirán funcionando. Sin embargo,
no recibirán actualizaciones posteriores a la 28.0.0 y no serán compatibles con las nuevas bibliotecas de Jetpack.
Artefactos históricos (aquellos con versiones 27 y anteriores, y empaquetados como android.support
)
seguirán estando disponibles en Google Maven. Todos los artefactos nuevos se empaquetarán como androidx
y requerirá una migración desde android.support
a androidx
.
Recomendamos usar las bibliotecas androidx
en todos los proyectos nuevos. También debes
considera migrar los proyectos existentes para asegurarte de que
seguirán recibiendo correcciones de errores y otras mejoras de la biblioteca.
La biblioteca de compatibilidad de Android contiene varios paquetes de biblioteca que se pueden incluir en tu aplicación. Cada una de estas bibliotecas es compatible con un rango específico de plataformas de Android. y un conjunto de funciones.
Para usar cualquiera de las siguientes bibliotecas, debes descargar los archivos de la biblioteca en tu Instalación del SDK de Android. Sigue las instrucciones para descargar las bibliotecas de compatibilidad en Configuración de la biblioteca de compatibilidad para completar este paso. Debes realizar pasos adicionales para incluir una biblioteca de compatibilidad específica en tu aplicación. Consulta el final de cada sección de la biblioteca a continuación para obtener información importante sobre cómo incluir la biblioteca en tu aplicación.
Nota: Es la versión mínima del SDK para toda la compatibilidad. de paquetes de biblioteca tiene, como mínimo, el nivel de API 14. Algunos paquetes requieren una API más alta de recuperación, como se indica a continuación.
Bibliotecas de compatibilidad v4
Estas bibliotecas incluyen el conjunto más grande de APIs en comparación con otras bibliotecas. incluida la compatibilidad con componentes de aplicaciones, funciones de interfaz de usuario, la accesibilidad, el manejo de datos, la conectividad de red y la programación servicios públicos.
Para obtener información completa y detallada sobre las clases y los métodos proporcionados por
las bibliotecas de compatibilidad v4, consulta el paquete android.support.v4
en la referencia de la API.
Nota: Antes de la revisión 24.2.0 de la biblioteca de compatibilidad, había una
una sola biblioteca de compatibilidad v4. Esa biblioteca se dividió en varios módulos para
mejorar la eficiencia. Para la retrocompatibilidad, si enumeras
support-v4
en la secuencia de comandos de Gradle, tu app incluirá todos los elementos
los módulos v4. Sin embargo, para reducir el tamaño de la app, te recomendamos que solo incluyas
los módulos específicos que necesita tu app.
Biblioteca compat v4
Proporciona wrappers de compatibilidad para varias APIs del framework, como
Context.obtainDrawable()
y
View.performAccessibilityAction()
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-compat:28.0.0
Biblioteca core-utils v4
Proporciona una serie de clases de utilidad, como AsyncTaskLoader
y PermissionChecker
.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-core-utils:28.0.0
Biblioteca core-ui v4
Implementa una variedad de componentes relacionados con la IU, como ViewPager
, NestedScrollView
y ExploreByTouchHelper
.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-core-ui:28.0.0
Biblioteca media-compat v4
Ofrece portabilidad a versiones anteriores del marco de trabajo de media.
incluidos MediaBrowser
y MediaSession
.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-media-compat:28.0.0
Biblioteca fragment v4
Agrega compatibilidad para el encapsulamiento de la interfaz de usuario y la funcionalidad con fragmentos lo que permite que las aplicaciones proporcionen diseños que se ajustan entre dispositivos de pantalla grande. Este módulo tiene dependencias en compat, core-utils, core-ui y media-compat.
Nota: La biblioteca de compatibilidad v13
proporciona una clase FragmentCompat
. La v4
La clase Fragment
es una clase independiente que
proporciona correcciones de errores que se agregaron en versiones posteriores de la plataforma, mientras que el
La clase FragmentCompat
v13 proporciona
correcciones de compatibilidad para la implementación del framework del
Clase Fragment
.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-fragment:28.0.0
Biblioteca de compatibilidad multidex
Esta biblioteca proporciona compatibilidad para compilar apps con múltiples archivos Dalvik Executable (DEX). Se requieren apps que hagan referencia a más de 65,536 métodos para usar configuraciones multidex. Para para obtener más información sobre el uso de multidex, consulta Compila apps con más de 64,000 métodos.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:multidex:1.0.0
Bibliotecas de compatibilidad v7
Estas bibliotecas proporcionan conjuntos de funciones específicas y se pueden incluir en tu aplicación de forma independiente entre sí.
Biblioteca appcompat v7 Parte de Android Jetpack.
Nota: La biblioteca appcompat migró a la La biblioteca de AndroidX, que es una herramienta Android de Jetpack Puedes ver cómo se usa en la App de demostración de Sunflower
Esta biblioteca agrega compatibilidad con el Usuario de la barra de acciones diseño de interfaz patrón. Esta biblioteca incluye compatibilidad con Interfaz de usuario de material design de Google Cloud.
Nota: Esta biblioteca depende de la biblioteca de compatibilidad v4.
Estas son algunas de las clases clave incluidas en la biblioteca appcompat v7:
ActionBar
: Proporciona una implementación de la barra de acciones. patrón de interfaz de usuario. Para ver más información sobre el uso de la barra de acciones, consulta el Barra de acciones.AppCompatActivity
: Agrega una clase de actividad de aplicación que puede Se usará como clase base para actividades que usan la barra de acciones de la biblioteca de compatibilidad. para implementarlos.AppCompatDialog
: Agrega una clase de diálogo que se puede usar como base. para diálogos con temas de AppCompat.ShareActionProvider
: Agrega compatibilidad con una interfaz de uso compartido (por ejemplo, enviar un correo electrónico o publicar en aplicaciones sociales) que se puede incluir en un barra de acciones.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:appcompat-v7:28.0.0
Biblioteca cardview v7
Esta biblioteca agrega compatibilidad con CardView
.
widget, que te permite mostrar información dentro de las tarjetas que tienen un aspecto coherente
en cualquier app. Estas tarjetas son útiles para material design
y se usan ampliamente en diseños para apps de TV.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:cardview-v7:28.0.0
Biblioteca gridlayout v7
Después de descargar las bibliotecas de compatibilidad de Android, esta biblioteca agrega compatibilidad con el
GridLayout
, que
le permite organizar los elementos de la interfaz de usuario mediante una cuadrícula de celdas rectangulares.
Para obtener información detallada sobre las APIs de la biblioteca gridlayout v7, consulta la
android.support.v7.widget
en la referencia de la API.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:gridlayout-v7:28.0.0
Biblioteca mediarouter v7
Esta biblioteca proporciona MediaRouter
, MediaRouteProvider
y clases de contenido multimedia relacionadas que
ser compatible con Google Cast.
En general, las APIs de la biblioteca mediarouter v7 proporcionan una forma de
controlar el enrutamiento de canales de medios y transmisiones desde el dispositivo actual hasta
pantallas externas, bocinas y otros dispositivos de destino. La biblioteca incluye
APIs para publicar proveedores de rutas de contenido multimedia específicos de la app para descubrir y
seleccionar dispositivos de destino, verificar el estado de los medios y mucho más Para obtener información
acerca de las APIs de la biblioteca mediarouter v7, consulta la
Paquete android.support.v7.media
en la API
referencia.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:mediarouter-v7:28.0.0
Las API de la biblioteca mediarouter v7 se introdujeron en la biblioteca de compatibilidad. Las versiones r18 están sujetas a cambios en revisiones posteriores de la biblioteca de compatibilidad. En este tiempo, te recomendamos que uses la biblioteca solo en conexión con Google Cast.
Biblioteca palette v7
La biblioteca de compatibilidad de la paleta v7 incluye las
Palette
, que te permite extraer
colores prominentes de una imagen. Por ejemplo, una app de música puede usar una
Un objeto Palette
para extraer los colores principales
de la portada de un álbum y usar esos colores para crear una canción que combine con los colores
tarjeta de título.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:palette-v7:28.0.0
Biblioteca recyclerview v7
La biblioteca recyclerview agrega RecyclerView
.
. Esta clase proporciona compatibilidad con los
RecyclerView
, una vista para mostrar de manera eficiente grandes conjuntos de datos proporcionando una
una ventana limitada de elementos de datos.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:recyclerview-v7:28.0.0
Biblioteca de compatibilidad Preference v7
El
preferencias
proporciona APIs para admitir la adición de objetos de preferencia, como
CheckBoxPreference
y
ListPreference
para
a los usuarios modificar la configuración de la IU.
La biblioteca de preferencias v7 agrega compatibilidad con interfaces, como
Preference.OnPreferenceChangeListener
y
Preference.OnPreferenceClickListener
y las clases,
como CheckBoxPreference
y
ListPreference
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:preference-v7:28.0.0
Biblioteca de compatibilidad v8
Esta biblioteca proporciona conjuntos de funciones específicas y se puede incluir en tu aplicación. de forma independiente de otras bibliotecas.
Biblioteca renderscript v8
Esta biblioteca agrega compatibilidad con
el procesamiento de RenderScript
en un framework de aplicaciones. Estas API se incluyen en el paquete android.support.v8.renderscript
. Tú
debes saber que los pasos para incluir estas APIs en tu aplicación son muy
es diferente de otras APIs de bibliotecas de compatibilidad. Para obtener más información sobre el uso de estas APIs
en tu aplicación, consulta la
RenderScript
de la guía para desarrolladores.
Nota: El uso de RenderScript con la biblioteca de compatibilidad es compatible con Android
compilaciones basadas en Gradle y Studio. El
La biblioteca renderscript se encuentra en la carpeta build-tools/$VERSION/renderscript/
.
En el siguiente ejemplo, se muestran las propiedades de la secuencia de comandos de compilación de Gradle para esta biblioteca:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
Biblioteca de compatibilidad v13
Esta biblioteca agrega compatibilidad
para el patrón de interfaz de usuario Fragment
Con la clase (FragmentCompat
) y compatibilidad adicional con fragmentos
. Para obtener más información sobre los fragmentos, consulta el
Fragment para desarrolladores. Para obtener información
sobre las API de la biblioteca de compatibilidad v13, consulta el paquete android.support.v13
en la referencia de la API.
Nota: La biblioteca fragment v4
proporciona una clase Fragment
. La v4
La clase Fragment
es una clase independiente que
proporciona correcciones de errores que se agregaron en versiones posteriores de la plataforma, mientras que el
La clase FragmentCompat
v13 proporciona
correcciones de compatibilidad para la implementación del framework del
Clase Fragment
.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-v13:28.0.0
Biblioteca de compatibilidad de preferencias v14
El paquete android.support.v14.preference
proporciona APIs para agregar compatibilidad.
de interfaces de preferencias, como
PreferenceFragment.OnPreferenceStartFragmentCallback
y
PreferenceFragment.OnPreferenceStartScreenCallback
,
además de clases, como
MultiSelectListPreference
y
PreferenceFragment
Para obtener información
sobre las APIs de la biblioteca de compatibilidad de preferencias v14, consulta la
preferencias
en la referencia de la API.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:preference-v14:28.0.0
Biblioteca de compatibilidad de preferencias para TV v17
El paquete android.support.v17.preference
proporciona APIs para proporcionar preferencias
en dispositivos de TV, incluida la compatibilidad con
LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
interfaz y las clases, como
BaseLeanbackPreferenceFragment
y
LeanbackPreferenceFragment
Para obtener información
sobre las APIs de la biblioteca de compatibilidad de preferencias v17, consulta la
preferencias
en la referencia de la API.
Este paquete requiere la API nivel 17 o superior. La secuencia de comandos de compilación de Gradle identificador de dependencias para esta biblioteca es el siguiente:
com.android.support:preference-leanback-v17:28.0.0
Biblioteca Leanback v17
El paquete android.support.v17.leanback
proporciona APIs para admitir
creación de interfaces de usuario
en dispositivos de TV. Proporciona una serie de widgets importantes para apps de TV. Entre algunas de las clases notables, se incluyen las siguientes:
BrowseFragment
: un fragmento para Crear un diseño principal para las categorías de navegación y las filas de medios. elementos.DetailsFragment
: Es un wrapper. para pantallas de detalles de Leanback.- De
PlaybackOverlayFragment
a A subclase deDetailsFragment
para mostrar los controles de reproducción y el contenido relacionado SearchFragment
: Es un fragmento de para manejar las búsquedas. El fragmento recibe la solicitud de búsqueda del usuario y pasa alSearchResultProvider
que proporciona la aplicación.SearchResultProvider
devuelve los resultados de la búsqueda alSearchFragment
, que los renderiza en unRowsFragment
.
Este paquete requiere la API nivel 17 o superior. La secuencia de comandos de compilación de Gradle identificador de dependencias para esta biblioteca es el siguiente:
com.android.support:leanback-v17:28.0.0
Biblioteca Vector Drawable
Proporciona compatibilidad para gráficos vectoriales estáticos.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es sigue:
com.android.support:support-vector-drawable:28.0.0
Biblioteca Animated Vector Drawable
Admite gráficos vectoriales animados.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es sigue:
com.android.support:animated-vector-drawable:28.0.0
Biblioteca de compatibilidad Annotations
La Anotación proporciona APIs para admitir la adición de metadatos de anotación a tus apps.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:support-annotations:28.0.0
Biblioteca de compatibilidad Design
El Paquete Design proporciona API para admitir la adición de componentes y patrones de Material Design a tus aplicaciones.
La biblioteca de compatibilidad de diseño agrega compatibilidad con varios componentes y patrones de Material Design para desarrolladores de apps, como paneles laterales de navegación, botones de acción flotante (BAF), barras de notificaciones y pestañas.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:design:28.0.0
Biblioteca de compatibilidad Custom Tabs
El Pestañas personalizadas proporciona APIs para admitir la adición y administración de pestañas personalizadas en tus apps.
La biblioteca de compatibilidad Custom Tabs Support agrega compatibilidad con varias clases, como Pestañas personalizadas Servicio y Pestañas personalizadas Devolución de llamada.
Este paquete requiere la API nivel 15 o superior. El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:customtabs:28.0.0
Biblioteca de compatibilidad Percent
El Porcentaje proporciona APIs para admitir la adición y administración de porcentajes dimensiones de tu app.
Nota: A partir de la versión 26.0.0, la biblioteca de compatibilidad Percent dejó de estar disponible.
Los clientes de este módulo deberían migrar al nuevo ConstraintLayout
que se proporciona como un artefacto independiente en SDK Manager.
La biblioteca de compatibilidad Percent agrega compatibilidad con los Interfaz de PercentLayoutHelper.PercentLayoutParams y varias clases, como PercentFrameLayout y . PercentRelativeLayout
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:percent:28.0.0
Biblioteca de compatibilidad ExifInterface
Las etiquetas EXIF almacenan información como la orientación, la fecha y hora,
y la ubicación directamente en un archivo JPEG o RAW. La ExifInterface
La clase desagrupa compatibilidad para leer información EXIF de JPEG.
y sin procesar (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW y RAF)
y configurar la información Exif en los archivos de imagen JPEG.
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:exifinterface:28.0.0
Biblioteca de compatibilidad App Recommendation para TV
El Aplicación Recomendación proporciona APIs para admitir la adición de recomendaciones de contenido en tu app para dispositivos de TV.
La biblioteca de apps agrega compatibilidad con anotaciones, como ContentRecommendation.ContentMaturity y varias clases, como Recomendación de contenido y . RecommendationExtender.
Este paquete requiere la API nivel 21 o superior. El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:recommendation:28.0.0
Biblioteca de la IU de Wear
Esta biblioteca tiene API que permiten compilar interfaces de usuario para apps de Wear. Las APIs, disponibles en la android.support.wear.widget, reemplazar las APIs correspondientes en la biblioteca de compatibilidad para wearables.
Para obtener más información, consulta Cómo usar la biblioteca de IU de Wear
El identificador de dependencias de la secuencia de comandos de compilación de Gradle para esta biblioteca es el siguiente:
com.android.support:wear:28.0.0