Se usó la API de Cloud Translation para traducir esta página.

credenciales

Referencia de la API
androidx.credentials

Esta biblioteca proporciona acceso unificado a las credenciales de un usuario. Esto puede incluir contraseñas, llaves de acceso y credenciales federadas. Esta biblioteca debe usarse para proporcionar experiencias de acceso seguras y sin interrupciones.

Actualización más reciente	Versión estable	Versión potencial	Versión beta	Versión alfa
10 de julio de 2024	1.2.2	1.3.0-rc01	-	1.5.0-alpha02

Cómo declarar dependencias

Para agregar una dependencia en las credenciales, debes agregar el repositorio de Maven de Google a tu proyecto. Lee el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

Kotlin

dependencies {
    implementation("androidx.credentials:credentials:1.5.0-alpha02")

    // optional - needed for credentials support from play services, for devices running
    // Android 13 and below.
    implementation("androidx.credentials:credentials-play-services-auth:1.5.0-alpha02")
}

Groovy

dependencies {
    implementation "androidx.credentials:credentials:1.5.0-alpha02"

    // optional - needed for credentials support from play services, for devices running
    // Android 13 and below.
    implementation "androidx.credentials:credentials-play-services-auth:1.5.0-alpha02"
}

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

No hay notas de la versión para este artefacto.

Credentials e2ee versión 1.0.

Versión 1.0.0-alpha02

17 de abril de 2024

Lanzamiento de androidx.credentials:credentials-e2ee:1.0.0-alpha02. Esta versión contiene los archivos jar de origen que faltaban en la versión anterior.

Versión 1.0.0-alpha01

3 de abril de 2024

Lanzamiento de androidx.credentials:credentials-e2ee:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

Se agregó compatibilidad para crear un IdentityKey a partir de una llave de acceso (Iba31e).

Versión 1.5

Versión 1.5.0-alpha02

12 de junio de 2024

Lanzamiento de androidx.credentials:credentials:1.5.0-alpha02 y androidx.credentials:credentials-play-services-auth:1.5.0-alpha02. Esta versión se desarrolla en una rama interna.

Nuevas funciones

Ahora, la capacidad de CredentialManager de proporcionar directamente un BiometricPrompt dentro de los flujos de creación y recuperación de credenciales está disponible para que los proveedores la usen a través de Jetpack.

Cambios en la API

Se agregó BiometricPromptData a la plataforma de la API para permitir el uso del nuevo flujo de BiometricPrompt incorporado a través de CredentialManager (I3b159).
Se modificaron todas las clases y subclases de entrada en CreateEntry y CredentialEntry para obtener la utilidad de BiometricPromptData para proveedores. (I16936, I8e5bc).
Se agregaron los tipos necesarios para codificar el error y los resultados de los flujos de BiometricPrompt incorporados con CredentialManager. (I8e5bc).

Versión 1.5.0-alpha01

29 de mayo de 2024

Lanzamiento de androidx.credentials:credentials:1.5.0-alpha01 y androidx.credentials:credentials-play-services-auth:1.5.0-alpha01. Esta versión se desarrolla en una rama interna.

Nuevas funciones

Experiencia de la IU secundaria para la selección de credenciales: Los desarrolladores de apps que llaman a las APIs de Credential Manager en el momento del acceso para presentar al usuario un selector, ahora pueden usar nuevas APIs para asociar el mismo GetCredentialRequest con una vista determinada, como un campo de nombre de usuario o contraseña.

Posteriormente, cuando el usuario se centre en una de estas vistas, la solicitud correspondiente se enviará al Administrador de credenciales. Las credenciales resultantes se agregan a todos los proveedores y se muestran en Autocompletar como IU secundarias, como sugerencias de teclado o del menú desplegable. Por lo tanto, cuando se usan todas las APIs juntas, primero se le presenta al usuario un selector y, si se descarta y presiona uno de los campos mencionados anteriormente, se le presentan sugerencias del teclado/desplegable.

Cambios en la API

Una clase PendingGetCredentialRequest que recibe un GetCredentialRequest (preexistente) y una devolución de llamada que se invocará con un GetCredentialResponse (preexistente) cuando esté disponible de forma asíncrona.
Nueva API de método set de extensiones para la clase View de Android, que permite configurar una instancia de PendingGetCredentialRequest El uso de esta API preparará la vista determinada, de modo que, cuando el usuario la presione, se mostrarán sugerencias de credenciales en experiencias de IU secundarias, como sugerencias de teclado/desplegable.

Versión 1.3

Versión 1.3.0-rc01

10 de julio de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-rc01 y androidx.credentials:credentials-play-services-auth:1.3.0-rc01. La versión 1.3.0-rc01 contiene estas confirmaciones.

Nuevas funciones

Un lanzamiento mejorado de la versión junto con pequeñas actualizaciones de implementación.

Versión 1.3.0-beta02

12 de junio de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-beta02 y androidx.credentials:credentials-play-services-auth:1.3.0-beta02. La versión 1.3.0-beta02 contiene estas confirmaciones.

Correcciones de errores

Se corrigió la lógica para verificar correctamente NOT_ALLOWED_ERR en lugar de CONSTRAINT_ERR en los flujos de credenciales de clave pública que contienen un error en dispositivos anteriores a U (I31b37).

Versión 1.3.0-beta01

29 de mayo de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-beta01 y androidx.credentials:credentials-play-services-auth:1.3.0-beta01. La versión 1.3.0-beta01 contiene estas confirmaciones.

Cambios en la API

Cambia el nombre de la API de conversión de paquete reateCredentialRequest. (I46b95).
Se actualizó la API de priorityhints (Ida554).

Versión 1.3.0-alpha04

14 de mayo de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-alpha04 y androidx.credentials:credentials-play-services-auth:1.3.0-alpha04. La versión 1.3.0-alpha04 contiene estas confirmaciones.

Correcciones de errores

Pasar a 21 como el minSdkVersion predeterminado de las bibliotecas de AndroidX (I6ec7f).
Se admite la creación de PRF para Android 13 y versiones anteriores.
Compatibilidad con preferImmediatelyAvailableCredentials para Android 13 y versiones anteriores.

Versión 1.3.0-alpha03

17 de abril de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-alpha03 y androidx.credentials:credentials-play-services-auth:1.3.0-alpha03. Esta versión contiene los archivos jar de origen que faltaban en la versión anterior.

Versión 1.3.0-alpha02

3 de abril de 2024

Lanzamiento de androidx.credentials:credentials:1.3.0-alpha02 y androidx.credentials:credentials-play-services-auth:1.3.0-alpha02. La versión 1.3.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

Se agregaron nuevas APIs que ayudan a que las entradas de credenciales se muestren claramente en el selector de credenciales durante una llamada getCredential o createCredential.

Cambios en la API

Se extendió la superficie de la API de Credential Options para contener información sobre las prioridades de pantalla. (Ied6fe)
Se expuso el paquete sin procesar a los asistentes de conversión de datos estructurados. (If03a0)
Se expusieron las APIs de isDefaultIcon y isAutoSelectAllowedFromOption. (I05c59)
Se amplió la superficie de la API de entrada de credenciales para que contenga información sobre la configuración predeterminada de un ícono (I9fe00).
Se agregó un bit entryGroupId a las entradas de credenciales (Id995c).
Se agregó una nueva propiedad affiliationName a la plataforma de la API de CredentialEntry. (I6261e).
Se expusieron las APIs de fromXYZEntry para usar en el framework (I645a1).

Correcciones de errores: Se proporcionó una solución de resguardo para cuando el administrador de credenciales de la plataforma no está disponible. (b/310701473): Se corrigió la NPE causada por la API de clearCredentialState. (b/327686881)

Versión 1.3.0-alpha01

13 de diciembre de 2023

Lanzamiento de androidx.credentials:credentials:1.3.0-alpha01 y androidx.credentials:credentials-play-services-auth:1.3.0-alpha01. La versión 1.3.0-alpha01 contiene estas confirmaciones.

Correcciones de errores

La versión mínima del APK necesaria para los Servicios de Google Play ahora es 2023 v08.23 (versión 230815045 del APK), y esta verificación se integra en la biblioteca. (aosp/2856137).
Se corrigió el error ya se había reanudado debido a la condición de carrera de varias solicitudes en tránsito. (Ic3567)

Versión 1.2

Versión 1.2.2

3 de abril de 2024

Lanzamiento de androidx.credentials:credentials:1.2.2 y androidx.credentials:credentials-play-services-auth:1.2.2. La versión 1.2.2 contiene estas confirmaciones.

Correcciones de errores

Se corrigió el error ya se había reanudado debido a la condición de carrera de varias solicitudes en tránsito. (Ic3567)
Se corrigió la NPE causada por la API de clearCredentialState (b/327686881).

Versión 1.2.1

6 de marzo de 2024

Lanzamiento de androidx.credentials:credentials:1.2.1 y androidx.credentials:credentials-play-services-auth:1.2.1. La versión 1.2.1 contiene estas confirmaciones.

Correcciones de errores

Se proporciona una solución de resguardo cuando el administrador de credenciales de la plataforma no está disponible. (b/310701473).

Versión 1.2.0

1 de noviembre de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0 y androidx.credentials:credentials-play-services-auth:1.2.0. La versión 1.2.0 contiene estas confirmaciones.

Cambios importantes desde 1.0.0

En esta versión, se agregó un nuevo conjunto de APIs para admitir el proveedor de credenciales en el almacenamiento y la recuperación de contraseñas y llaves de acceso según las solicitudes de los usuarios.

Versión 1.2.0-rc01

4 de octubre de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-rc01 y androidx.credentials:credentials-play-services-auth:1.2.0-rc01. La versión 1.2.0-rc01 contiene estas confirmaciones.

Un lanzamiento mejorado de la versión junto con pequeñas actualizaciones de implementación

Versión 1.2.0-beta04

20 de septiembre de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-beta04 y androidx.credentials:credentials-play-services-auth:1.2.0-beta04. La versión 1.2.0-beta04 contiene estas confirmaciones.

Nuevas funciones

Se agregó el flujo de intents de obtención de acceso para Acceder con Google. (Ib6559,I7a042).
Se agregó la verificación de firma única para los paquetes incluidos en la lista de entidades permitidas. (Ie6ff5).
Se actualizó el análisis de JSON de PublicKeyCredential para usar métodos toJson() actualizados. (I708e3, I00402).

Correcciones de errores

Se corrigieron las reglas de ProGuard faltantes (b/288120539).

Versión 1.2.0-beta03

23 de agosto de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-beta03 y androidx.credentials:credentials-play-services-auth:1.2.0-beta03. La versión 1.2.0-beta03 contiene estas confirmaciones.

Correcciones de errores

Se quitaron las extensiones uvm debido a la baja planificada de la especificación de webauthn (I2d46d).
Se garantiza el cumplimiento de las especificaciones de webauthn en relación con clientExtensions, credProps y las propiedades rk. (I3ab01)

Versión 1.2.0-beta02

1 de agosto de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-beta02 y androidx.credentials:credentials-play-services-auth:1.2.0-beta02. La versión 1.2.0-beta02 contiene estas confirmaciones.

Correcciones de errores

b/293743991: Se corrigió el valor constante del campo authenticatorData para analizar correctamente la propiedad authenticationResponseJson en PublicKeyCredential.

Versión 1.2.0-beta01

26 de julio de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-beta01 y androidx.credentials:credentials-play-services-auth:1.2.0-beta01. La versión 1.2.0-beta01 contiene estas confirmaciones.

Cambios en la API

Se expuso una API que determina si el origen se propaga o no. (Ia91f4)
Hace que las excepciones personalizadas sean semánticasmente correctas. (Ibf6f4)
Agrega la API de prueba. (I61c1d)
Agrega la API de prueba. (Iaeb6f)
Se quitaron los usos de la API experimental de isAtLeastU() (Ie9117, b/289269026).
Se expuso un método get de origen personalizado que toma en la lista de entidades permitidas. (I0c1b4)
Se agregó la anotación VisibleForTest (I5467a).
Se agregó la anotación VisibleForTest (Idf57a).
Se quitaron las APIs de solo prueba. (Idcc05)
Se expusieron las clases de entrada del proveedor a niveles de API inferiores (I2e00a).
Se agregaron APIs de prueba. (Id6b9e)

Correcciones de errores

Se agregaron las APIs de prueba (I0d243).
Se agregaron nuevas APIs de prueba (I6fa12).
Se expuso la selección automática para solicitudes de creación. (I84eee)
Se detallaron más los errores de codificación JSON. (I7a865)
Informa de manera fluida un error del desarrollador sobre un parámetro de contexto sin actividad. (/I20dd7, b/288288940)
Se corrigió el análisis de excepciones para las excepciones que devolvieron los proveedores. (Iaa2af,I0d243,I55151)
Documentación mejorada para toSlice

Versión 1.2.0-alpha05

7 de junio de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-alpha05 y androidx.credentials:credentials-play-services-auth:1.2.0-alpha05. Esta versión se desarrolla en una rama interna.

Nuevas funciones

Análisis retrocompatible para la API de Get en los módulos de GMS que se introdujeron junto con la rama pública.

Versión 1.2.0-alpha04

10 de mayo de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-alpha04 y androidx.credentials:credentials-play-services-auth:1.2.0-alpha04. Esta versión se desarrolla en una rama interna.

Versión 1.2.0-alpha03

12 de abril de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-alpha03 y androidx.credentials:credentials-play-services-auth:1.2.0-alpha03. Esto se lanzó a partir de una rama interna.

Versión 1.2.0-alpha02

8 de marzo de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-alpha02 y androidx.credentials:credentials-play-services-auth:1.2.0-alpha02. Se desarrolla a partir de una rama interna.

Cambios en la API

Habilita la prueba de las clases de solicitud del proveedor haciendo públicos los constructores.
Hacer que los íconos sean obligatorios en todas las clases de entrada Sin embargo, si los proveedores de credenciales no proporcionan íconos, esta biblioteca tendrá íconos de resguardo.
Permite que los proveedores de credenciales configuren varias entradas de acción de autenticación y establezcan un título para cada una.
Quita todas las clases de solicitudes con privilegios. Ahora, los proveedores simplemente pueden obtener el origen de la clase android.service.credentials.CallingAppInfo y no necesitan controlar clases de solicitudes especiales para llamadas con privilegios (llamadas en nombre de otra app).

Versión 1.2.0-alpha01

8 de febrero de 2023

Lanzamiento de androidx.credentials:credentials:1.2.0-alpha01 y androidx.credentials:credentials-play-services-auth:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

En esta versión, se agregó un nuevo conjunto de APIs para admitir el proveedor de credenciales en el almacenamiento y la recuperación de contraseñas y llaves de acceso según las solicitudes de los usuarios.

Cambios en la API

Se agregaron nuevas APIs para admitir proveedores de credenciales.

Versión 1.0

Nota: Todos los proyectos deben usar la versión 1.2 más reciente de androidx.credentials. Las versiones anteriores de androidx.credentials arrojarán una excepción UnsupportedOperationException("Post-U not supported yet") cuando se ejecuten en Android 14.

Versión 1.0.0-alpha09

7 de junio de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha09 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Correcciones de errores

Valida que los tipos de excepciones sean precisos y coherentes. (Id13d7).
Admite el formato JSON en las solicitudes de obtención de llaves de acceso. (I25100).
El flujo de recuperación de la llave de acceso es retrocompatible con los módulos de GMS anteriores (I23878).

Versión 1.0.0-alpha08

3 de mayo de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha08 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Correcciones de errores

Se mejoraron la legibilidad de los resultados de depuración y los mensajes de error.

Versión 1.0.0-alpha07

19 de abril de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha07 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha07. La versión 1.0.0-alpha07 contiene estas confirmaciones.

Correcciones de errores

Se corrigió el error causado por los cambios de configuración (a75fca, b/276316128).
No se interrumpe el flujo posterior a U para el SDK solo anterior a U. (5418c9, b/278148300)

Versión 1.0.0-alpha06

5 de abril de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha06 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Nuevas funciones

Actualiza la integración con el ID de Google y funcionará con com.google.android.libraries.identity.googleid:googleid:1.0.0

Versión 1.0.0-alpha05

22 de marzo de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha05 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Correcciones de errores

Informa correctamente el error de cancelación del usuario cuando este cancele la hoja modal. (/I9ff3, b/271863184).

Versión 1.0.0-alpha04

8 de marzo de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha04 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Cambios en la API

Se agregó el requisito android.permission.CREDENTIAL_MANAGER_SET_ORIGIN para configurar el origen en la biblioteca de Jetpack. (Ibaad4).
Se agregaron excepciones de flujo de obtención de llaves de acceso. (I4f654)
Actualización del comportamiento de la selección automática de la API de CredentialManager (I576dd).
CreateCredentialRequest.DisplayInfo ahora usa CharSequence en lugar de campos String. (I85e70).

Correcciones de errores

Agrega reglas de ProGuard para garantizar que R8 no quite el módulo de autenticación de Play. (9543977).

Versión 1.0.0-alpha03

22 de febrero de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha03 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

Se agregó compatibilidad con Acceder con Google.

Cambios en la API

Permite que UnsupportedException funcione correctamente. (I68208)
Se agrega un nuevo tipo de excepción para dar cuenta en casos como cuando el dispositivo no contiene las marcas necesarias (If08dd).
API de excepción de CredentialManager (I72947)

Versión 1.0.0-alpha02

8 de febrero de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha02 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Cambios en la API

Cambió la firma de la API de CredentialManager (Iabdec).
Cambió la firma de la API de CredentialManager (I977ed).
Cambió la firma de la API de CredentialManager (Ia6e9b).

Correcciones de errores

Ya no se admite "cable" más antiguo en la especificación de webauthn, y su reemplazo, "hybrid", ahora se muestra para la lista de transporte.
Los transportes se devolvieron en dos listas dimensionales. Esto se corrigió para que sea la lista 1d correcta.

Versión 1.0.0-alpha01

11 de enero de 2023

Lanzamiento de androidx.credentials:credentials:1.0.0-alpha01 y androidx.credentials:credentials-play-services-auth:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

Esta versión incluye una nueva biblioteca de Jetpack que proporciona un acceso unificado a las credenciales de los usuarios. Esto puede incluir contraseñas, llaves de acceso y credenciales federadas. Esta biblioteca debe usarse para proporcionar experiencias de acceso seguras y sin interrupciones.
androidx.credentials:credentials-play-services-auth:1.0.0-alpha01 es una biblioteca opcional que permite que las credenciales se almacenen en el Administrador de contraseñas de Google y se recuperen desde allí. Esta dependencia es necesaria para los dispositivos con nivel de API de Android 33 o inferior.

Cambios en la API

Nueva biblioteca con APIs nuevas