credentials

Essa biblioteca oferece acesso unificado às credenciais de um usuário. Isso pode incluir senhas, senhas de acesso e credenciais federadas. Use a biblioteca para proporcionar experiências de login integradas e seguras.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
4 de setembro de 2024 1.2.2 1.3.0-rc01 - 1.5.0-alpha05

Declarar dependências

Para adicionar uma dependência a credenciais, é preciso adicionar o repositório Maven do Google ao seu projeto. Leia o Maven do Google repositório para mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

Kotlin

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

    // 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-alpha05")
}

Groovy

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

    // 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-alpha05"
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Não há notas de versão para este artefato.

Credenciais e2ee Versão 1.0.

Versão 1.0.0-alpha02

17 de abril de 2024

Lançamento de androidx.credentials:credentials-e2ee:1.0.0-alpha02. Esta versão contém jars de origem que estavam ausentes na versão anterior.

Versão 1.0.0-alpha01

3 de abril de 2024

Lançamento de androidx.credentials:credentials-e2ee:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

  • Suporte à criação de um IdentityKey usando uma chave de acesso (Iba31e).

Versão 1.5

Versão 1.5.0-alpha05

4 de setembro de 2024

Lançamento de androidx.credentials:credentials:1.5.0-alpha05 e androidx.credentials:credentials-play-services-auth:1.5.0-alpha05. A versão 1.5.0-alpha05 contém estas confirmações.

Mudanças na API

  • Suporte a um novo tipo de credencial: DigitalCredential (I12952).
  • Exposição de APIs de conversão de pacote: expõe mais auxiliares asBundle e fromBundle para permitir que essas classes sejam transmitidas pela IPC com mais facilidade (I1a017).
  • Tornar o PendingIntentHandler compatível com versões anteriores. (I34c13).
  • O CallingAppInfo agora é compatível com versões anteriores (I65085).
  • expor constantes ClearCredentialRequestTypes;

Versão 1.5.0-alpha04

7 de agosto de 2024

Lançamento de androidx.credentials:credentials:1.5.0-alpha04 e androidx.credentials:credentials-play-services-auth:1.5.0-alpha04. A versão 1.5.0-alpha04 contém estas confirmações.

Mudanças na API

  • Foi adicionado um valor padrão para o parâmetro isCloudBackupEnabled de CreateRestoreCredentialRequest.

Correções de bugs

  • minSdkVersion removido para credentials-play-services-auth.

Versão 1.5.0-alpha03

24 de julho de 2024

Lançamento de androidx.credentials:credentials:1.5.0-alpha03 e androidx.credentials:credentials-play-services-auth:1.5.0-alpha03. Essa versão é desenvolvida em uma ramificação interna.

Novos recursos

  • Apresenta um novo recurso, a restauração de credenciais. A credencial de restauração é usada para restaurar a credencial do usuário do dispositivo anterior em um novo dispositivo Android. Ao criar um RestoreCredential para o usuário, a credencial será automaticamente transferida para o novo dispositivo do usuário se ele selecionar o app que será transferido do dispositivo antigo durante a etapa de configuração.

Mudanças na API

  • Novas turmas são adicionadas para solicitar credenciais de restauração.
  • Um novo tipo de credencial, RestoreCredential, que pode restaurar credenciais em um novo dispositivo.
  • CreateRestoreCredentialRequest para criar um novo RestoreCredential.
  • GetRestoreCredentialOption para buscar RestoreCredential.
  • O ClearCredentialStateRequest pode ser modificado para limpar o RestoreCredential.

Correções de bugs

  • Adição de uma nova API RestoreCredential para fins de restauração de apps (If2d40).

Versão 1.5.0-alpha02

12 de junho de 2024

Lançamento de androidx.credentials:credentials:1.5.0-alpha02 e androidx.credentials:credentials-play-services-auth:1.5.0-alpha02. Essa versão é desenvolvida em uma ramificação interna.

Novos recursos

  • A capacidade de CredentialManager implantar diretamente um BiometricPrompt nos fluxos de criação e recuperação de credenciais agora está disponível para uso com o Jetpack para provedores.

Mudanças na API

  • O BiometricPromptData foi adicionado à superfície da API para permitir o uso do novo fluxo de BiometricPrompt integrado por CredentialManager (I3b159).
  • Modificação de todas as classes e subclasses de entrada em CreateEntry e CredentialEntry para receber a utilidade do BiometricPromptData para provedores (I16936, I8e5bc).
  • Foram adicionados os tipos necessários para codificar o erro e os resultados dos fluxos BiometricPrompt incorporados com CredentialManager. (I8e5bc).

Versão 1.5.0-alpha01

29 de maio de 2024

Lançamento de androidx.credentials:credentials:1.5.0-alpha01 e androidx.credentials:credentials-play-services-auth:1.5.0-alpha01. Essa versão é desenvolvida em uma ramificação interna.

Novos recursos

Experiência secundária de interface para seleção de credenciais: os desenvolvedores de apps que chamam as APIs do Gerenciador de credenciais no momento do login para apresentar ao usuário um seletor agora podem usar novas APIs para associar o mesmo GetCredentialRequest a uma determinada visualização, como um campo de nome de usuário ou senha.

Em seguida, quando o usuário se concentrar em uma dessas visualizações, a solicitação correspondente será enviada ao Gerenciador de credenciais. As credenciais resultantes são agregadas entre os provedores e exibidas no preenchimento automático como interfaces secundárias, por exemplo, sugestões de teclado ou menu suspenso. Dessa forma, quando todas as APIs são usadas juntas, o usuário recebe primeiro um seletor e, se dispensado e toca em um dos campos mencionados acima, recebe sugestões de teclado/menu suspenso.

Mudanças na API

  • Uma classe PendingGetCredentialRequest que usa um GetCredentialRequest (preexistente) e um callback a ser invocado com um GetCredentialResponse (pré-existente), quando disponível de forma assíncrona.
  • Nova API setter de extensão para a classe View do Android, que permite definir uma instância de PendingGetCredentialRequest. O uso dessa API vai preparar a visualização fornecida para que, quando o usuário tocar nela, sugestões de credenciais apareçam em experiências de interface secundárias, como sugestões de teclado/menu suspenso.

Versão 1.3

Versão 1.3.0-rc01

10 de julho de 2024

Lançamento de androidx.credentials:credentials:1.3.0-rc01 e androidx.credentials:credentials-play-services-auth:1.3.0-rc01. A versão 1.3.0-rc01 contém estas confirmações.

Novos recursos

  • Um lançamento de versão com pequenas atualizações de implementação.

Versão 1.3.0-beta02

12 de junho de 2024

Lançamento de androidx.credentials:credentials:1.3.0-beta02 e androidx.credentials:credentials-play-services-auth:1.3.0-beta02. A versão 1.3.0-beta02 contém estas confirmações.

Correções de bugs

  • A lógica para verificar corretamente NOT_ALLOWED_ERR em vez de CONSTRAINT_ERR nos fluxos de credenciais de chave pública que contêm um erro em dispositivos anteriores ao U (I31b37) foi corrigida

Versão 1.3.0-beta01

29 de maio de 2024

Lançamento de androidx.credentials:credentials:1.3.0-beta01 e androidx.credentials:credentials-play-services-auth:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

Mudanças na API

  • Renomeie a API Bundle conversion reateCredentialRequest. (I46b95).
  • Atualização da APIpriorityhints (Ida554).

Versão 1.3.0-alpha04

14 de maio de 2024

Lançamento de androidx.credentials:credentials:1.3.0-alpha04 e androidx.credentials:credentials-play-services-auth:1.3.0-alpha04. A versão 1.3.0-alpha04 contém estas confirmações.

Correções de bugs

  • Mudança para 21 como o minSdkVersion padrão das bibliotecas androidx. (I6ec7f).
  • Compatibilidade com a criação de PRFs para as versões 13 e anteriores do Android.
  • Suporte a preferImmediatelyAvailableCredentials para as versões 13 e anteriores do Android.

Versão 1.3.0-alpha03

17 de abril de 2024

Lançamento de androidx.credentials:credentials:1.3.0-alpha03 e androidx.credentials:credentials-play-services-auth:1.3.0-alpha03. Esta versão contém jars de origem que não estavam na versão anterior.

Versão 1.3.0-alpha02

3 de abril de 2024

Lançamento de androidx.credentials:credentials:1.3.0-alpha02 e androidx.credentials:credentials-play-services-auth:1.3.0-alpha02. A versão 1.3.0-alpha02 contém estas confirmações.

Novos recursos

  • Foram adicionadas novas APIs que ajudam a mostrar entradas de credenciais claramente no seletor de credenciais durante uma chamada getCredential ou createCredential.

Mudanças na API

  • A superfície da API Credential Options foi estendida para conter informações sobre prioridades de exibição (Ied6fe).
  • Pacote bruto exposto aos auxiliares de conversão de dados estruturados (If03a0).
  • Exposição das APIs isDefaultIcon e isAutoSelectAllowedFromOption (I05c59).
  • A plataforma da API de entrada de credenciais foi estendida para conter informações sobre como definir o padrão de um ícone (I9fe00).
  • Adição de um bit entryGroupId às entradas de credenciais (Id995c).
  • Adicionamos uma nova propriedade affiliationName à plataforma da API CredentialEntry. (I6261e).
  • As APIs fromXYZEntry foram expostas para serem usadas no framework (I645a1).

Correções de bugs - Fornecida uma solução substituta quando o gerenciador de credenciais da plataforma não está disponível. (b/310701473). - Correção de NPE causada pela API clearCredentialState (b/327686881).

Versão 1.3.0-alpha01

13 de dezembro de 2023

Lançamento de androidx.credentials:credentials:1.3.0-alpha01 e androidx.credentials:credentials-play-services-auth:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estas confirmações.

Correções de bugs

  • A versão mínima do APK necessária para o Google Play Services agora é 2023 v08.23 (versão do APK 230815045), e essa verificação faz parte da biblioteca. (osp/2856137, link em inglês).
  • Correção do erro de já retomada causado pela disputa de várias solicitações em andamento (Ic3567).

Versão 1.2

Versão 1.2.2

3 de abril de 2024

Lançamento de androidx.credentials:credentials:1.2.2 e androidx.credentials:credentials-play-services-auth:1.2.2. A versão 1.2.2 contém estas confirmações.

Correções de bugs

  • Correção do erro de já retomada causado pela disputa de várias solicitações em andamento (Ic3567).
  • Correção do NPE causado pela API clearCredentialState (b/327686881).

Versão 1.2.1

6 de março de 2024

Lançamento de androidx.credentials:credentials:1.2.1 e androidx.credentials:credentials-play-services-auth:1.2.1. A versão 1.2.1 contém estas confirmações.

Correções de bugs

  • Solução substituta fornecida quando o gerenciador de credenciais da plataforma não está disponível. (b/310701473).

Versão 1.2.0

1º de novembro de 2023

Lançamento de androidx.credentials:credentials:1.2.0 e androidx.credentials:credentials-play-services-auth:1.2.0. A versão 1.2.0 contém estas confirmações.

Mudanças importantes desde a versão 1.0.0

  • Esta versão adicionou um novo conjunto de APIs para oferecer suporte ao Provedor de credenciais no para armazenar e buscar senhas, chaves de acesso solicitações.

Versão 1.2.0-rc01

4 de outubro de 2023

Lançamento de androidx.credentials:credentials:1.2.0-rc01 e androidx.credentials:credentials-play-services-auth:1.2.0-rc01. A versão 1.2.0-rc01 contém estas confirmações.

  • Um lançamento de versão com pequenas atualizações de implementação

Versão 1.2.0-beta04

20 de setembro de 2023

Lançamento de androidx.credentials:credentials:1.2.0-beta04 e androidx.credentials:credentials-play-services-auth:1.2.0-beta04. A versão 1.2.0-beta04 contém estas confirmações.

Novos recursos

  • Foi adicionado um fluxo da intent de login para fazer login com o Google. (Ib6559,I7a042).
  • Verificação de assinatura única adicionada para pacotes na lista de permissões. (Ie6ff5).
  • Atualizamos a análise json PublicKeyCredential para usar métodos toJson() atualizados. (I708e3, I00402).

Correções de bugs

  • Correção de regras do Proguard ausentes (b/288120539).

Versão 1.2.0-beta03

23 de agosto de 2023

Lançamento de androidx.credentials:credentials:1.2.0-beta03 e androidx.credentials:credentials-play-services-auth:1.2.0-beta03. A versão 1.2.0-beta03 contém estas confirmações.

Correções de bugs

  • Remoção das extensões uvm devido à descontinuação planejada da especificação webauthn (I2d46d).
  • Conformidade com a especificação webauthn em relação às propriedades clientExtensions, credProps e rk (I3ab01).

Versão 1.2.0-beta02

1º de agosto de 2023

Lançamento de androidx.credentials:credentials:1.2.0-beta02 e androidx.credentials:credentials-play-services-auth:1.2.0-beta02. A versão 1.2.0-beta02 contém estas confirmações.

Correções de bugs

  • b/293743991: o valor constante do campo authenticatorData foi corrigido para analisar corretamente a propriedade authenticationResponseJson em PublicKeyCredential

Versão 1.2.0-beta01

26 de julho de 2023

Lançamento de androidx.credentials:credentials:1.2.0-beta01 e androidx.credentials:credentials-play-services-auth:1.2.0-beta01. A versão 1.2.0-beta01 contém estas confirmações.

Mudanças na API

  • Foi exposta uma API que determina se a origem está preenchida ou não (Ia91f4).
  • Torna as exceções personalizadas semanticamente corretas (Ibf6f4).
  • Adição da API de teste (I61c1d).
  • Adição da API de teste (Iaeb6f).
  • Remoção dos usos da API experimental isAtLeastU() (Ie9117, b/289269026).
  • Um getter de origem personalizado que recebe a lista de permissões foi exposto (I0c1b4).
  • A anotação VisibleForTest foi adicionada (I5467a).
  • A anotação VisibleForTest foi adicionada (Idf57a).
  • Remoção de APIs somente de teste (Idcc05)
  • As classes de entrada do provedor foram expostas para níveis de API mais baixos (I2e00a).
  • Adição de APIs de teste (Id6b9e).

Correções de bugs

  • Adição de APIs de teste (I0d243).
  • Novas APIs de teste foram adicionadas (I6fa12).
  • Exposição automática da seleção automática para solicitações de criação (I84eee).
  • Os erros de codificação JSON foram mais detalhados (I7a865).
  • Um erro de desenvolvedor é informado em um parâmetro de contexto de não atividade (/I20dd7, b/288288940).
  • Correção da análise de exceções para exceções retornadas de provedores (Iaa2af,I0d243,I55151).
  • Melhoramos a documentação de toSlice

Versão 1.2.0-alpha05

7 de junho de 2023

Lançamento de androidx.credentials:credentials:1.2.0-alpha05 e androidx.credentials:credentials-play-services-auth:1.2.0-alpha05. Essa versão é desenvolvida em uma ramificação interna.

Novos recursos

  • Análise compatível com versões anteriores para a API GET em módulos do GMS introduzidos com a ramificação pública.

Versão 1.2.0-alpha04

10 de maio de 2023

Lançamento de androidx.credentials:credentials:1.2.0-alpha04 e androidx.credentials:credentials-play-services-auth:1.2.0-alpha04. Essa versão é desenvolvida em uma ramificação interna.

Versão 1.2.0-alpha03

12 de abril de 2023

Lançamento de androidx.credentials:credentials:1.2.0-alpha03 e androidx.credentials:credentials-play-services-auth:1.2.0-alpha03. O lançamento foi feito em uma ramificação interna.

Versão 1.2.0-alpha02

8 de março de 2023

Lançamento de androidx.credentials:credentials:1.2.0-alpha02 e androidx.credentials:credentials-play-services-auth:1.2.0-alpha02. Desenvolvido a partir de uma ramificação interna.

Mudanças na API

  • Ative o teste de classes de solicitação do provedor tornando públicos construtores.
  • Tornar os ícones obrigatórios em todas as classes de entrada. No entanto, se os provedores de credenciais não fornecerem ícones, essa biblioteca terá ícones substitutos.
  • Permita que provedores de credenciais definam várias entradas de ação de autenticação e definam um título para cada uma.
  • Remova todas as classes de solicitação com privilégios. Os provedores agora podem simplesmente receber a origem da classe android.service.credentials.CallingAppInfo e não precisam processar classes de solicitação especiais para chamadas privilegiadas (chamadas em nome de outro app).

Versão 1.2.0-alpha01

8 de fevereiro de 2023

Lançamento de androidx.credentials:credentials:1.2.0-alpha01 e androidx.credentials:credentials-play-services-auth:1.2.0-alpha01. A versão 1.2.0-alpha01 contém estas confirmações.

Novos recursos

  • Esta versão adicionou um novo conjunto de APIs para oferecer suporte ao Provedor de credenciais no para armazenar e buscar senhas, chaves de acesso solicitações.

Mudanças na API

  • Novas APIs foram adicionadas para oferecer suporte a provedores de credenciais.

Versão 1.0

Versão 1.0.0-alpha09

7 de junho de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha09 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Correções de bugs

  • Confira se os tipos de exceção são precisos e consistentes. (Id13d7).
  • Compatibilidade com o formato JSON na solicitação de acesso à chave de acesso. (I25100).
  • O fluxo de recuperação da chave de acesso é compatível com versões anteriores dos módulos GMS anteriores (I23878).

Versão 1.0.0-alpha08

3 de maio de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha08 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Correções de bugs

  • Melhoramos a legibilidade da saída de depuração e as mensagens de erro.

Versão 1.0.0-alpha07

19 de abril de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha07 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Correções de bugs

  • Correção de bug causado por mudanças de configuração (a75fca, b/276316128).
  • Não é possível interromper o fluxo pós-U do SDK anterior a U (5418c9, b/278148300).

Versão 1.0.0-alpha06

5 de abril de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha06 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Novos recursos

  • Atualize a integração com o ID do Google (funcionará com com.google.android.libraries.identity.googleid:googleid:1.0.0)

Versão 1.0.0-alpha05

22 de março de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha05 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Correções de bugs

  • Informe corretamente o erro de cancelamento quando o usuário cancelar a página modal. (/I9ff3, b/271863184).

Versão 1.0.0-alpha04

8 de março de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha04 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Mudanças na API

  • Adição do requisito android.permission.CREDENTIAL_MANAGER_SET_ORIGIN para definir a origem na Biblioteca Jetpack. (Ibaad4).
  • Foram adicionadas exceções de fluxo de acesso à chave de acesso (I4f654).
  • Atualização do comportamento de seleção automática da API CredentialManager (I576dd).
  • CreateCredentialRequest.DisplayInfo agora usa CharSequence em vez de campos String. (I85e70).

Correções de bugs

  • Adicione regras do ProGuard para garantir que o módulo de autenticação do Play não seja removido pelo R8. (9543977).

Versão 1.0.0-alpha03

22 de fevereiro de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha03 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Novos recursos

  • Agora é possível usar o recurso Fazer login com o Google.

Mudanças na API

  • Permite que UnsupportedException funcione corretamente (I68208).
  • Adição de um novo tipo de exceção para explicar casos em que o dispositivo não contém as sinalizações necessárias (If08dd).
  • API de exceção CredentialManager (I72947).

Versão 1.0.0-alpha02

8 de fevereiro de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha02 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Mudanças na API

  • Mudanças na assinatura da API CredentialManager (Iabdec).
  • Mudanças na assinatura da API CredentialManager (I977ed).
  • Mudanças na assinatura da API CredentialManager (Ia6e9b).

Correções de bugs

  • O "cabo" mais antigo não pode mais ser usado com a especificação WebAuthn, e o substituto "híbrido" voltou para a lista de transportes.
  • Os transportes foram devolvidos em listas bidimensionais, que foram corrigidas como a lista unidimensional certa.

Versão 1.0.0-alpha01

11 de janeiro de 2023

Lançamento de androidx.credentials:credentials:1.0.0-alpha01 e androidx.credentials:credentials-play-services-auth:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

  • Esta versão contém uma nova biblioteca do Jetpack que oferece acesso unificado às credenciais do usuário. Isso pode incluir senhas, senhas de acesso e credenciais federadas. Use a biblioteca para proporcionar experiências de login integradas e seguras.
  • "androidx.credentials:credentials-play-services-auth:1.0.0-alpha01" é uma biblioteca opcional que permite que as credenciais sejam armazenadas e recuperadas pelo Gerenciador de senhas do Google. Essa dependência é necessária para dispositivos Android com API de nível 33 ou anteriores.

Mudanças na API

  • Nova biblioteca com novas APIs.