此页面由 Cloud Translation API 翻译。

凭据

此库可提供对用户凭据的统一访问权限。其中包括密码、通行密钥和联合凭据。此库应该用于提供安全顺畅的登录体验。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2024 年 9 月 4 日	1.2.2	1.3.0-rc01	-	1.5.0-alpha05

声明依赖项

如需添加凭据的依赖项，您必须将 Google Maven 制品库添加到自己的项目阅读 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

Credentials e2ee 版本 1.0。

版本 1.0.0-alpha02

2024 年 4 月 17 日

发布了 androidx.credentials:credentials-e2ee:1.0.0-alpha02。此版本包含上一版本中缺少的源 JAR。

版本 1.0.0-alpha01

2024 年 4 月 3 日

发布了 androidx.credentials:credentials-e2ee:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

支持通过通行密钥创建 IdentityKey (Iba31e)

版本 1.5

版本 1.5.0-alpha05

2024 年 9 月 4 日

发布了 androidx.credentials:credentials:1.5.0-alpha05 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha05。版本 1.5.0-alpha05 中包含这些提交内容。

API 变更

支持新的凭据类型 - DigitalCredential (I12952)
公开了软件包转换 API：公开了更多 asBundle 和 fromBundle 帮助程序，以便更轻松地跨 IPC 传递这些类 (I1a017)
使 PendingIntentHandler 向后兼容。（I34c13）
使 CallingAppInfo 向后兼容 (I65085)
公开 ClearCredentialRequestTypes 常量。

版本 1.5.0-alpha04

2024 年 8 月 7 日

发布了 androidx.credentials:credentials:1.5.0-alpha04 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha04。版本 1.5.0-alpha04 包含这些提交内容。

API 变更

为 CreateRestoreCredentialRequest 的 isCloudBackupEnabled 参数添加了默认值。

bug 修复

已为credentials-play-services-auth移除minSdkVersion。

版本 1.5.0-alpha03

2024 年 7 月 24 日

发布了 androidx.credentials:credentials:1.5.0-alpha03 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha03。此版本是在内部分支中开发的。

新功能

引入了一项新功能，即恢复凭据。恢复凭据用于将用户凭据从之前的设备恢复到新的 Android 设备。为用户创建 RestoreCredential 后，如果用户在设置阶段选择从旧设备转移应用，凭据将自动转移到用户的新设备。

API 变更

添加了用于请求恢复凭据的新类。
一种新的凭据类型 RestoreCredential，可以在新设备中恢复凭据。
CreateRestoreCredentialRequest，用于创建新的 RestoreCredential。
GetRestoreCredentialOption，用于提取 RestoreCredential。
您可以修改 ClearCredentialStateRequest 以清除 RestoreCredential。

bug 修复

添加了用于应用恢复的新 RestoreCredential API (If2d40)

版本 1.5.0-alpha02

2024 年 6 月 12 日

发布了 androidx.credentials:credentials:1.5.0-alpha02 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha02。此版本是在内部分支中开发的。

新功能

现在，可通过 Jetpack 为提供程序使用 CredentialManager 直接在凭据创建和检索流程中植入 BiometricPrompt 的功能。

API 变更

向 API Surface 添加了 BiometricPromptData，以允许通过 CredentialManager 利用新的已传入 BiometricPrompt 流 (I3b159)
修改了 CreateEntry 和 CredentialEntry 中的所有条目类和子类，以便将 BiometricPromptData 用于提供程序。（I16936、I8e5bc）
添加了使用 CredentialManager 对已引入的 BiometricPrompt 流中的错误和结果进行编码所需的类型。（I8e5bc）

版本 1.5.0-alpha01

2024 年 5 月 29 日

发布了 androidx.credentials:credentials:1.5.0-alpha01 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha01。此版本是在内部分支中开发的。

新功能

凭据选择的次要界面体验：在登录时调用 Credential Manager API 以向用户显示选择器的应用开发者现在能够使用新的 API 将同一 GetCredentialRequest 与给定视图（例如用户名或密码字段）相关联。

随后，当用户聚焦于其中一个视图时，相应的请求将会发送到 Credential Manager。生成的凭据会在各提供程序中汇总，并显示在辅助界面（例如键盘或下拉菜单建议）等自动填充项中。因此，当所有 API 一起使用时，系统首先会向用户显示选择器，如果用户将其关闭并点按上述某个字段，系统就会显示键盘/下拉菜单建议。

API 变更

一个 PendingGetCredentialRequest 类，用于接受（预先存在的）GetCredentialRequest，以及使用（预先存在的）GetCredentialResponse（如果异步可用）调用的回调。
为 Android View 类添加了新的扩展 setter API，允许设置 PendingGetCredentialRequest 的实例。使用此 API 将准备给定的视图，以便在用户点按该视图时，凭据建议将显示在辅助界面体验（例如键盘/下拉菜单建议）中。

版本 1.3

版本 1.3.0-rc01

2024 年 7 月 10 日

发布了 androidx.credentials:credentials:1.3.0-rc01 和 androidx.credentials:credentials-play-services-auth:1.3.0-rc01。版本 1.3.0-rc01 中包含这些提交内容。

新功能

一个版本递增版本，以及一些小的实现更新。

版本 1.3.0-beta02

2024 年 6 月 12 日

发布了 androidx.credentials:credentials:1.3.0-beta02 和 androidx.credentials:credentials-play-services-auth:1.3.0-beta02。版本 1.3.0-beta02 包含这些提交内容。

bug 修复

修复了相应逻辑，以便在公钥凭据流程中正确检查包含 U 之前版本的设备上存在错误的 NOT_ALLOWED_ERR，而非 CONSTRAINT_ERR (I31b37)

版本 1.3.0-beta01

2024 年 5 月 29 日

发布了 androidx.credentials:credentials:1.3.0-beta01 和 androidx.credentials:credentials-play-services-auth:1.3.0-beta01。版本 1.3.0-beta01 包含这些提交内容。

API 变更

重命名 reateCredentialRequest Bundle Conversion API。（I46b95）
更新了 priorityhints API (Ida554)

版本 1.3.0-alpha04

2024 年 5 月 14 日

发布了 androidx.credentials:credentials:1.3.0-alpha04 和 androidx.credentials:credentials-play-services-auth:1.3.0-alpha04。版本 1.3.0-alpha04 包含这些提交内容。

bug 修复

移到了 21，作为 androidx 库的默认 minSdkVersion。（I6ec7f）
支持为 Android 版本 13 及更低版本创建 PRF。
支持 preferImmediatelyAvailableCredentials（适用于 Android 版本 13 及更低版本）。

版本 1.3.0-alpha03

2024 年 4 月 17 日

发布了 androidx.credentials:credentials:1.3.0-alpha03 和 androidx.credentials:credentials-play-services-auth:1.3.0-alpha03。此版本包含上一版本中缺少的源 JAR。

版本 1.3.0-alpha02

2024 年 4 月 3 日

发布了 androidx.credentials:credentials:1.3.0-alpha02 和 androidx.credentials:credentials-play-services-auth:1.3.0-alpha02。版本 1.3.0-alpha02 包含这些提交内容。

新功能

添加了新的 API，有助于在 getCredential 或 createCredential 调用期间将凭据条目清晰显示在凭据选择器中。

API 变更

扩展了 Credential Options API Surface，以包含有关显示优先级的信息 (Ied6fe)
向结构化数据转换帮助程序提供了原始 Bundle (If03a0)
公开了 isDefaultIcon 和 isAutoSelectAllowedFromOption API (I05c59)
扩展了凭据条目 API Surface，以包含有关默认图标的信息 (I9fe00)
向凭据条目添加了 entryGroupId 位 (Id995c)
向 CredentialEntry API Surface 添加了新的 affiliationName 属性。（I6261e）
公开了要在框架中使用的 fromXYZEntry API (I645a1)

bug 修复 - 提供了当平台凭据管理器不可用时的后备解决方案。(b/310701473) - 修复了由 clearCredentialState API 导致的 NPE (b/327686881)

版本 1.3.0-alpha01

2023 年 12 月 13 日

发布了 androidx.credentials:credentials:1.3.0-alpha01 和 androidx.credentials:credentials-play-services-auth:1.3.0-alpha01。版本 1.3.0-alpha01 中包含这些提交内容。

bug 修复

现在，Google Play 服务所需的最低 APK 版本是 2023 v08.23（APK 版本 APK 版本 230815045），这项检查已纳入库中。(aosp/2856137)
修复了由多个传输中请求的竞态条件导致的已经恢复错误 (Ic3567)

版本 1.2

版本 1.2.2

2024 年 4 月 3 日

发布了 androidx.credentials:credentials:1.2.2 和 androidx.credentials:credentials-play-services-auth:1.2.2。版本 1.2.2 包含这些提交内容。

bug 修复

修复了由多个传输中请求的竞态条件导致的已经恢复错误 (Ic3567)
修复了由 clearCredentialState API 导致的 NPE (b/327686881)

版本 1.2.1

2024 年 3 月 6 日

发布了 androidx.credentials:credentials:1.2.1 和 androidx.credentials:credentials-play-services-auth:1.2.1。版本 1.2.1 中包含这些提交内容。

bug 修复

提供了当平台凭据管理器不可用时的后备解决方案。(b/310701473)

版本 1.2.0

2023 年 11 月 1 日

发布了 androidx.credentials:credentials:1.2.0 和 androidx.credentials:credentials-play-services-auth:1.2.0。版本 1.2.0 中包含这些提交内容。

自 1.0.0 以来的重要变更

此版本新增了一组 API，用于在存储和提取密码、每个用户的通行密钥请求。

版本 1.2.0-rc01

2023 年 10 月 4 日

发布了 androidx.credentials:credentials:1.2.0-rc01 和 androidx.credentials:credentials-play-services-auth:1.2.0-rc01。版本 1.2.0-rc01 中包含这些提交内容。

一个版本递增版本以及一些小的实现更新

版本 1.2.0-beta04

2023 年 9 月 20 日

发布了 androidx.credentials:credentials:1.2.0-beta04 和 androidx.credentials:credentials-play-services-auth:1.2.0-beta04。版本 1.2.0-beta04 中包含这些提交内容。

新功能

添加了“使用 Google 账号登录”功能的 get 登录 intent 流程。（Ib6559、I7a042）
针对列入许可名单的软件包添加了单一签名检查。（Ie6ff5）
更新了 PublicKeyCredential JSON 解析，以利用更新后的 toJson() 方法。（I708e3、I00402）

bug 修复

修复了缺失的 Proguard 规则 (b/288120539)

版本 1.2.0-beta03

2023 年 8 月 23 日

发布了 androidx.credentials:credentials:1.2.0-beta03 和 androidx.credentials:credentials-play-services-auth:1.2.0-beta03。版本 1.2.0-beta03 中包含这些提交内容。

bug 修复

移除了 uvm 扩展，因为我们已计划从 webauthn 规范中废弃它。（I2d46d）
确保符合有关 clientExtensions、credProps 和 rk 属性的 webauthn 规范 (I3ab01)

版本 1.2.0-beta02

2023 年 8 月 1 日

发布了 androidx.credentials:credentials:1.2.0-beta02 和 androidx.credentials:credentials-play-services-auth:1.2.0-beta02。版本 1.2.0-beta02 中包含这些提交内容。

bug 修复

b/293743991 - 修复 authenticatorData 字段的常量值，以便正确解析 PublicKeyCredential 中的 authenticationResponseJson 属性

版本 1.2.0-beta01

2023 年 7 月 26 日

发布了 androidx.credentials:credentials:1.2.0-beta01 和 androidx.credentials:credentials-play-services-auth:1.2.0-beta01。版本 1.2.0-beta01 中包含这些提交内容。

API 变更

公开了一个用于确定是否填充来源的 API (Ia91f4)
使自定义异常在语义上正确 (Ibf6f4)
添加了测试 API (I61c1d)
添加了测试 API (Iaeb6f)
移除了实验性 isAtLeastU() API 的使用（Ie9117、b/289269026）
公开接受许可名单的自定义源站 getter (I0c1b4)
添加了 VisibleForTest 注解 (I5467a)
添加了 VisibleForTest 注解 (Idf57a)
移除了仅用于测试的 API (Idcc05)
将提供程序条目类公开给较低的 API 级别 (I2e00a)
添加了测试 API (Id6b9e)

bug 修复

添加了测试 API (I0d243)
添加了新的测试 API (I6fa12)
公开了 Create 请求的自动选择功能 (I84eee)
提供更详细的 JSON 编码错误 (I7a865)
针对非 activity 上下文参数优雅报告开发者错误（/I20dd7、b/288288940）
更正了从提供程序返回的异常的异常解析（Iaa2af、I0d243、I55151）
完善了关于 toSlice 的文档

版本 1.2.0-alpha05

2023 年 6 月 7 日

发布了 androidx.credentials:credentials:1.2.0-alpha05 和 androidx.credentials:credentials-play-services-auth:1.2.0-alpha05。此版本是在内部分支中开发的。

新功能

在公共分支中引入的 GMS 模块中对 get API 的向后兼容性解析。

版本 1.2.0-alpha04

2023 年 5 月 10 日

发布了 androidx.credentials:credentials:1.2.0-alpha04 和 androidx.credentials:credentials-play-services-auth:1.2.0-alpha04。此版本是在内部分支中开发的。

版本 1.2.0-alpha03

2023 年 4 月 12 日

发布了 androidx.credentials:credentials:1.2.0-alpha03 和 androidx.credentials:credentials-play-services-auth:1.2.0-alpha03。这是从内部分支发布的。

版本 1.2.0-alpha02

2023 年 3 月 8 日

发布了 androidx.credentials:credentials:1.2.0-alpha02 和 androidx.credentials:credentials-play-services-auth:1.2.0-alpha02。由内部分支开发。

API 变更

通过将构造函数设为公开，允许对提供程序请求类进行测试。
使图标在所有条目类中都是必需的。不过，如果凭据提供程序不提供图标，此库将具有后备图标。
允许凭据提供程序设置多个身份验证操作条目，并为每个条目设置标题。
移除所有特权请求类。提供程序现在只需从 android.service.credentials.CallingAppInfo 类获取来源，无需为特权调用（代表其他应用调用）处理特殊请求类。

版本 1.2.0-alpha01

2023 年 2 月 8 日

发布了 androidx.credentials:credentials:1.2.0-alpha01 和 androidx.credentials:credentials-play-services-auth:1.2.0-alpha01。版本 1.2.0-alpha01 中包含这些提交内容。

新功能

此版本新增了一组 API，用于在存储和提取密码、每个用户的通行密钥请求。

API 变更

新增了 API 以支持凭据提供程序。

版本 1.0

</ph> 注意：所有项目都应使用最新的 1.2 版的 androidx.credentials 版本。早期版本 androidx.credentials 会抛出异常当发生以下情况时，UnsupportedOperationException("Post-U not supported yet") 在 Android 14 上运行。

版本 1.0.0-alpha09

2023 年 6 月 7 日

发布了 androidx.credentials:credentials:1.0.0-alpha09 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha09。版本 1.0.0-alpha09 中包含这些提交内容。

bug 修复

验证异常类型是否准确且一致。（Id13d7）
支持获取通行密钥请求中的 JSON 格式。（I25100）
通行密钥检索流程向后兼容之前的 GMS 模块。(I23878)

版本 1.0.0-alpha08

2023 年 5 月 3 日

发布了 androidx.credentials:credentials:1.0.0-alpha08 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha08。版本 1.0.0-alpha08 中包含这些提交内容。

bug 修复

改进了调试输出的可读性和错误消息。

版本 1.0.0-alpha07

2023 年 4 月 19 日

发布了 androidx.credentials:credentials:1.0.0-alpha07 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha07。版本 1.0.0-alpha07 中包含这些提交内容。

bug 修复

修复了由配置更改导致的 bug（a75fca、b/276316128）
不要破坏 U 后的流程（适用于 U 之前的版本）（5418c9、b/278148300）

版本 1.0.0-alpha06

2023 年 4 月 5 日

发布了 androidx.credentials:credentials:1.0.0-alpha06 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha06。版本 1.0.0-alpha06 中包含这些提交内容。

新功能

更新与 Google ID 的集成，将适用于 com.google.android.libraries.identity.googleid:googleid:1.0.0

版本 1.0.0-alpha05

2023 年 3 月 22 日

发布了 androidx.credentials:credentials:1.0.0-alpha05 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha05。版本 1.0.0-alpha05 中包含这些提交内容。

bug 修复

在用户取消模态工作表时正确报告用户取消错误。（/I9ff3、b/271863184）

版本 1.0.0-alpha04

2023 年 3 月 8 日

发布了 androidx.credentials:credentials:1.0.0-alpha04 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha04。版本 1.0.0-alpha04 中包含这些提交内容。

API 变更

添加了在 Jetpack 库中设置来源的 android.permission.CREDENTIAL_MANAGER_SET_ORIGIN 要求。（Ibaad4）
添加了通行密钥 get 流程异常 (I4f654)
CredentialManager API 自动选择行为更新 (I576dd)
CreateCredentialRequest.DisplayInfo 现在使用 CharSequence 字段，而不是 String 字段。（I85e70）

bug 修复

添加了 ProGuard 规则，以确保 R8 不会移除播放身份验证模块。(9543977)

版本 1.0.0-alpha03

2023 年 2 月 22 日

发布了 androidx.credentials:credentials:1.0.0-alpha03 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha03。版本 1.0.0-alpha03 中包含这些提交内容。

新功能

添加了对“使用 Google 账号登录”功能的支持。

API 变更

允许 UnsupportedException 正常运行 (I68208)
添加新的异常类型，以将设备不包含必要标记等情况考虑在内 (If08dd)
CredentialManager 异常 API (I72947)

版本 1.0.0-alpha02

2023 年 2 月 8 日

发布了 androidx.credentials:credentials:1.0.0-alpha02 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

API 变更

CredentialManager API 签名变更 (Iabdec)
CredentialManager API 签名变更 (I977ed)
CredentialManager API 签名变更 (Ia6e9b)

bug 修复

WebAuthn 规范不再支持旧的“cable”，系统现在会针对传输列表返回其替换项“hybrid”。
传输原本是以二维列表的形式返回的，现已修正为正确的一维列表。

版本 1.0.0-alpha01

2023 年 1 月 11 日

发布了 androidx.credentials:credentials:1.0.0-alpha01 和 androidx.credentials:credentials-play-services-auth:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容。

新功能

此版本包含一个新的 Jetpack 库，可提供对用户凭据的统一访问权限。其中包括密码、通行密钥和联合凭据。该库应该用于提供安全顺畅的登录体验。
“androidx.credentials:credentials-play-services-auth:1.0.0-alpha01”是一个可选的库，可用于存储凭据，以及从 Google 密码管理工具中检索凭据。搭载 Android API 级别 33 或更低版本的设备需要此依赖项。

API 变更

添加了一个新库和多个新 API