credentials

This library provides unified access to a user's credentials. This can include passwords, passkeys and federated credentials. This library should be used to provide seamless and secure sign-in experiences.
Latest Update Stable Release Release Candidate Beta Release Alpha Release
March 6, 2024 1.2.1 - - 1.3.0-alpha01

Declaring dependencies

To add a dependency on credentials, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Kotlin

dependencies {
    implementation("androidx.credentials:credentials:1.3.0-alpha01")

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

Groovy

dependencies {
    implementation "androidx.credentials:credentials:1.3.0-alpha01"

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

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

There are no release notes for this artifact.

Version 1.3

Version 1.3.0-alpha01

December 13, 2023

androidx.credentials:credentials:1.3.0-alpha01 and androidx.credentials:credentials-play-services-auth:1.3.0-alpha01 are released. Version 1.3.0-alpha01 contains these commits.

Bug Fixes

  • The minimum APK version needed for Google Play services is now 2023 v08.23 (APK version APK version 230815045), and this check is baked into the library. (aosp/2856137)
  • Fix the already-resume error caused by race condition of multiple in-flight requests (Ic3567)

Version 1.2

Version 1.2.1

March 6, 2024

androidx.credentials:credentials:1.2.1 and androidx.credentials:credentials-play-services-auth:1.2.1 are released. Version 1.2.1 contains these commits.

Bug Fixes

  • Provided fallback solution when platform credential manager is not available. (b/310701473)

Version 1.2.0

November 1, 2023

androidx.credentials:credentials:1.2.0 and androidx.credentials:credentials-play-services-auth:1.2.0 are released. Version 1.2.0 contains these commits.

Important changes since 1.0.0

  • This release added a new set of APIs for supporting Credential Provider in storing and fetching passwords, passkeys per users' requests.

Version 1.2.0-rc01

October 4, 2023

androidx.credentials:credentials:1.2.0-rc01 and androidx.credentials:credentials-play-services-auth:1.2.0-rc01 are released. Version 1.2.0-rc01 contains these commits.

  • A version bump release along with small implementation updates

Version 1.2.0-beta04

September 20, 2023

androidx.credentials:credentials:1.2.0-beta04 and androidx.credentials:credentials-play-services-auth:1.2.0-beta04 are released. Version 1.2.0-beta04 contains these commits.

New Features

  • Added get sign in intent flow for sign in with google. (Ib6559,I7a042)
  • Added single signature checking for allowlisted packages. (Ie6ff5)
  • Updated PublicKeyCredential json parsing to utilize updated toJson() methods. (I708e3, I00402)

Bug Fixes

Version 1.2.0-beta03

August 23, 2023

androidx.credentials:credentials:1.2.0-beta03 and androidx.credentials:credentials-play-services-auth:1.2.0-beta03 are released. Version 1.2.0-beta03 contains these commits.

Bug Fixes

  • Removes uvm extensions, due to planned deprecation from the webauthn spec. (I2d46d)
  • Ensure compliance to webauthn spec regarding clientExtensions, credProps, and rk properties (I3ab01)

Version 1.2.0-beta02

August 1, 2023

androidx.credentials:credentials:1.2.0-beta02 and androidx.credentials:credentials-play-services-auth:1.2.0-beta02 are released. Version 1.2.0-beta02 contains these commits.

Bug Fixes

  • b/293743991 - Fix the constant value for the authenticatorData field, in order to correctly parse the authenticationResponseJson property in PublicKeyCredential

Version 1.2.0-beta01

July 26, 2023

androidx.credentials:credentials:1.2.0-beta01 and androidx.credentials:credentials-play-services-auth:1.2.0-beta01 are released. Version 1.2.0-beta01 contains these commits.

API Changes

  • Expose an API that determines whether the origin is populated or not (Ia91f4)
  • Makes custom exceptions semantically correct (Ibf6f4)
  • add test api (I61c1d)
  • add test api (Iaeb6f)
  • Removed usages of experimental isAtLeastU() API (Ie9117, b/289269026)
  • Expose a custom origin getter that takes in allowlist (I0c1b4)
  • Added VisibleForTest annotation (I5467a)
  • Added VisibleForTest annotation (Idf57a)
  • Remove test only apis (Idcc05)
  • Expose provider entry classes to lower API levels (I2e00a)
  • Add test apis (Id6b9e)

Bug Fixes

  • Add test APIs (I0d243)
  • Add new testing APIs (I6fa12)
  • Expose autoselect for Create requests (I84eee)
  • Make JSON encoding errors more detailed (I7a865)
  • Gracefully report a developer error upon a non-activity context parameter (/I20dd7, b/288288940)
  • Corrected Exception Parsing for Exceptions returned from Providers (Iaa2af,I0d243,I55151)
  • Improved documentation for toSlice

Version 1.2.0-alpha05

June 7, 2023

androidx.credentials:credentials:1.2.0-alpha05 and androidx.credentials:credentials-play-services-auth:1.2.0-alpha05 are released. This version is developed in an internal branch.

New Features

  • Backwards compatible parsing for the get API across GMS modules introduced alongside the public branch.

Version 1.2.0-alpha04

May 10, 2023

androidx.credentials:credentials:1.2.0-alpha04 and androidx.credentials:credentials-play-services-auth:1.2.0-alpha04 are released. This version is developed in an internal branch.

Version 1.2.0-alpha03

April 12, 2023

androidx.credentials:credentials:1.2.0-alpha03 and androidx.credentials:credentials-play-services-auth:1.2.0-alpha03 are released. This was released from an internal branch.

Version 1.2.0-alpha02

March 8, 2023

androidx.credentials:credentials:1.2.0-alpha02 and androidx.credentials:credentials-play-services-auth:1.2.0-alpha02 are released. Developed from an internal branch.

API Changes

  • Enable testing of provider request classes by making constructors public.
  • Make icons required in all entry classes. However if credential providers do not provide icons, this library will have fallback icons.
  • Allow credential providers to set multiple authentication action entries, and set a title for each.
  • Remove all privileged request classes. Providers can now simply get the origin from android.service.credentials.CallingAppInfo class, and do not need to handle special request classes for privileged calls (calls on behalf of another app).

Version 1.2.0-alpha01

February 8, 2023

androidx.credentials:credentials:1.2.0-alpha01 and androidx.credentials:credentials-play-services-auth:1.2.0-alpha01 are released. Version 1.2.0-alpha01 contains these commits.

New Features

  • This release added a new set of APIs for supporting Credential Provider in storing and fetching passwords, passkeys per users' requests.

API Changes

  • New APIs added to support Credential Providers.

Version 1.0

Version 1.0.0-alpha09

June 7, 2023

androidx.credentials:credentials:1.0.0-alpha09 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha09 are released. Version 1.0.0-alpha09 contains these commits.

Bug Fixes

  • Validate that exception types are accurate and consistent. (Id13d7)
  • Support the json format on get passkey request. (I25100)
  • Passkey Retrieval flow is backwards compatible with earlier GMS modules.(I23878)

Version 1.0.0-alpha08

May 3, 2023

androidx.credentials:credentials:1.0.0-alpha08 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha08 are released. Version 1.0.0-alpha08 contains these commits.

Bug Fixes

  • Improved debug output readability and error messages.

Version 1.0.0-alpha07

April 19, 2023

androidx.credentials:credentials:1.0.0-alpha07 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha07 are released. Version 1.0.0-alpha07 contains these commits.

Bug Fixes

Version 1.0.0-alpha06

April 5, 2023

androidx.credentials:credentials:1.0.0-alpha06 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha06 are released. Version 1.0.0-alpha06 contains these commits.

New Features

  • Update the integration with Google ID, will work with com.google.android.libraries.identity.googleid:googleid:1.0.0

Version 1.0.0-alpha05

March 22, 2023

androidx.credentials:credentials:1.0.0-alpha05 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha05 are released. Version 1.0.0-alpha05 contains these commits.

Bug Fixes

  • Properly report the user cancellation error when the user cancels the modal sheet. (/I9ff3, b/271863184)

Version 1.0.0-alpha04

March 8, 2023

androidx.credentials:credentials:1.0.0-alpha04 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha04 are released. Version 1.0.0-alpha04 contains these commits.

API Changes

  • Added android.permission.CREDENTIAL_MANAGER_SET_ORIGIN requirement for setting origin in Jetpack Library. (Ibaad4)
  • Added passkey get flow exceptions (I4f654)
  • CredentialManager api autoselect behavior update (I576dd)
  • CreateCredentialRequest.DisplayInfo now uses CharSequence rather than String fields. (I85e70)

Bug Fixes

  • Add proguard rules to ensure the play auth module won't be removed by R8. (9543977)

Version 1.0.0-alpha03

February 22, 2023

androidx.credentials:credentials:1.0.0-alpha03 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

New Features

  • Added support for Sign-in with Google.

API Changes

  • Allows UnsupportedException to function correctly (I68208)
  • Adding a new exception type to account for cases such as when the device does not contain the necessary flags (If08dd)
  • CredentialManager exception api (I72947)

Version 1.0.0-alpha02

February 8, 2023

androidx.credentials:credentials:1.0.0-alpha02 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

API Changes

  • CredentialManager api signature changes (Iabdec)
  • CredentialManager api signature changes (I977ed)
  • CredentialManager api signature changes (Ia6e9b)

Bug Fixes

  • Older ‘cable’ is no longer supported in the webauthn spec, and its replacement, ‘hybrid’ is now returned for the transport list.
  • Transports were given back in two dimensional lists, this has been fixed to be the correct 1d list.

Version 1.0.0-alpha01

January 11, 2023

androidx.credentials:credentials:1.0.0-alpha01 and androidx.credentials:credentials-play-services-auth:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

  • This release contains a new jetpack library which provides a unified access to a user's credentials. This can include passwords, passkeys and federated credentials. This library should be used to provide seamless and secure sign-in experiences.
  • `androidx.credentials:credentials-play-services-auth:1.0.0-alpha01 ‘ is an optional library that allows credentials to be stored to, and retrieved from Google Password Manager. This dependency is needed for devices running Android API level <= 33.

API Changes

  • New library with new APIs