本頁面由 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-beta01")

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

Groovy

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

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

如要進一步瞭解依附元件，請參閱新增建構依附元件。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

憑證 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 參數預設值。

修正錯誤

已移除 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。

修正錯誤

新增 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 變更

已將 BiometricPromptData 新增至 API 介面，以允許透過 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。這個版本是在內部分支版本中開發。

新功能

選取憑證的次要 UI 體驗：應用程式開發人員在登入時呼叫 Credential Manager API，以選取工具呈現使用者，現在可以使用新的 API 將相同的 GetCredentialRequest 與特定檢視畫面 (例如使用者名稱或密碼欄位) 建立關聯。

之後當使用者著重查看其中一個檢視畫面時，對應的要求就會傳送至 Credential Manager。系統會匯總各供應商的結果，並自動填入，如次要 UI，例如鍵盤或下拉式選單建議。因此，當所有 API 搭配使用時，使用者會先看到一個選取器，如果使用者在上述任一欄位關閉後輕觸畫面，則會顯示鍵盤/下拉式選單建議。

API 變更

PendingGetCredentialRequest 類別採用 (既有的) GetCredentialRequest，且如果非同步可用，可使用 (既有的) GetCredentialResponse 叫用回呼。
適用於 Android View 類別的全新擴充功能 setter API，可用於設定 PendingGetCredentialRequest 的執行個體。這個 API 的使用方式會準備指定的檢視畫面，在使用者輕觸檢視畫面時，憑證建議會顯示在次要 UI 體驗中，例如鍵盤/下拉式選單建議功能。

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 版包含這些修訂版本。

修正錯誤

修正了邏輯，以便在採用 U-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)。
更新優先提示 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 版包含這些修訂版本。

修正錯誤

移至 21 做為 androidx 程式庫的預設 minSdkVersion。(I6ec7f)。
支援在 Android 13 以下版本建立 PRF。
支援 Android 13 以下版本的 preferImmediatelyAvailableCredentials。

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 介面，納入顯示優先順序資訊 (Ied6fe)
向結構化資料轉換輔助工具公開原始套件 (If03a0)
已公開 isDefaultIcon 和 isAutoSelectAllowedFromOption API (I05c59)
擴充憑證項目 API 介面，加入預設圖示的相關資訊 (I9fe00)
將 entryGroupId 位元新增至憑證項目 (Id995c)
已將新的 affiliationName 屬性新增至 CredentialEntry API 介面。(I6261e)。
公開要在架構中使用的 fromXYZEntry API (I645a1)

修正錯誤 - 在平台憑證管理工具無法使用時提供備用解決方案。(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 版本包含以下修訂項目。

修正錯誤

現在 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 版包含這些修訂版本。

修正錯誤

修正因多個傳輸中要求競爭狀況而造成的已恢復錯誤 (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 版包含這些修訂版本。

修正錯誤

平台憑證管理工具無法使用時，提供的備用解決方案。(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 登入」的「取得登入意圖」流程。(Ib6559、I7a042)。
已為許可清單中的套件新增單一簽章檢查功能。(Ie6ff5)。
更新 PublicKeyCredential JSON 剖析功能，以便使用更新後的 toJson() 方法。(I708e3、I00402)

修正錯誤

已修正缺少的 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 版本包含以下修訂項目。

修正錯誤

系統預計從 webauthn 規格淘汰，因此移除 uvm 擴充功能。(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 版包含此連結所列的修訂項目。

修正錯誤

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)

修正錯誤

新增測試 API (I0d243)
新增測試 API (I6fa12)
在建立要求中公開自動選取功能 (I84eee)
更詳細的 JSON 編碼錯誤 (I7a865)
針對非活動結構定義參數，妥善回報開發人員錯誤 (/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 模組與公用分支一起導入的 GMS 模組中，回溯相容剖析功能。

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 版本

注意：所有專案應使用最新的 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 版包含此連結所列的修訂項目。

修正錯誤

驗證例外狀況類型是否正確且一致。(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 版包含此連結所列的修訂項目。

修正錯誤

改善偵錯輸出內容的可讀性和錯誤訊息。

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 版包含此連結所列的修訂項目。

修正錯誤

修正設定變更造成的錯誤 (a75fca、b/276316128)
請勿中斷僅限 U 之前的 SDK 的 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 版包含此連結所列的修訂項目。

修正錯誤

在使用者取消回應表單時正確回報使用者取消錯誤。(/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 變更

新增了 android.permission.CREDENTIAL_MANAGER_SET_ORIGIN 規定，用於在 Jetpack 程式庫中設定來源。(Ibaad4)。
新增密碼金鑰取得流程例外狀況 (I4f654)
CredentialManager API 自動選取行為更新 (I576dd)
CreateCredentialRequest.DisplayInfo 現在使用 CharSequence，而不是 String 欄位。(I85e70)。

修正錯誤

新增 ProGuard 規則，確保 R8 不會移除 Play 驗證模組。(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)

修正錯誤

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 的新程式庫