本頁面由 Cloud Translation API 翻譯而成。

憑證

這個程式庫可針對使用者的憑證 (包括密碼、密碼金鑰和聯合憑證) 提供整合式存取權。請使用這個程式庫提供流暢安全的登入體驗。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 1 月 15 日	1.3.0	1.5.0-rc01	-	1.5.0-rc01

宣告依附元件

如要為憑證新增依附元件，您必須將 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"
}

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

意見回饋

您的意見可協助我們改善 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-rc01 版

2025 年 1 月 15 日

發布 androidx.credentials:credentials:1.5.0-rc01 和 androidx.credentials:credentials-play-services-auth:1.5.0-rc01。1.5.0-rc01 版包含這些修訂項目。

新功能

版本升級版本，以及小型導入更新

API 變更

為 IdentityCredential 新增 @Deprecated 註解，以便與架構保持一致。(I6ac90、b/140252778、b/217942278、b/251211046、b/239955609)

外部貢獻

淘汰 BuildCompat.isAtLeastV。呼叫端應直接檢查 SDK_INT 是否為 35。(I294d1)。

1.5.0-beta01 版

2024 年 10 月 30 日

發布 androidx.credentials:credentials:1.5.0-beta01 和 androidx.credentials:credentials-play-services-auth:1.5.0-beta01。1.5.0-beta01 版包含這些修訂項目。

新功能

以下新功能的 Beta 版：

憑證選取功能的次要 UI 體驗：如果應用程式開發人員在登入時呼叫 Credential Manager API，以便向使用者顯示選取器，現在就能使用新的 API，將相同的 GetCredentialRequest 與特定檢視畫面 (例如使用者名稱或密碼欄位) 建立關聯。接著，當使用者將焦點放在其中一個檢視畫面時，系統就會將對應的請求傳送至憑證管理工具。系統會從各個供應商收集結果憑證，並在自動填入功能的次要 UI (例如鍵盤或下拉式選單建議) 中顯示。因此，當所有 API 一起使用時，系統會先向使用者顯示選取器，如果使用者關閉選取器並輕觸上述任一欄位，系統就會顯示鍵盤/下拉式選單建議。
還原憑證。還原憑證可用於將使用者的憑證從舊裝置還原到新的 Android 裝置。為使用者建立 RestoreCredential 後，如果使用者在設定階段選取要從舊裝置轉移的應用程式，憑證就會自動轉移至使用者的新裝置。

API 變更

讓開發人員在 CryptoObject 和 BiometricPromptData Setter 中靈活設定條件。(Ie7e8e)。

1.5.0-alpha06 版

2024 年 10 月 16 日

發布 androidx.credentials:credentials:1.5.0-alpha06 和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha06。1.5.0-alpha06 版包含這些修訂項目。

新功能

準備程式庫，以便盡快進入穩定版。

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。
用於擷取 RestoreCredential 的 GetRestoreCredentialOption。
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。這個版本是在內部分支版本中開發而成。

新功能

CredentialManager 現可透過 Jetpack 為供應商提供的功能，直接在憑證建立和擷取流程中注入 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 與特定檢視畫面 (例如使用者名稱或密碼欄位) 建立關聯。

接著，當使用者將焦點放在其中一個檢視畫面時，系統就會將對應的請求傳送至憑證管理工具。系統會從各個供應商收集結果憑證，並在自動填入功能的次要 UI (例如鍵盤或下拉式選單建議) 中顯示。因此，當所有 API 一起使用時，系統會先向使用者顯示選取器，如果使用者關閉選取器並輕觸上述任一欄位，系統就會顯示鍵盤/下拉式選單建議。

API 變更

PendingGetCredentialRequest 類別會在非同步可用時，接收 (先前存在的) GetCredentialRequest，以及要使用 (先前存在的) GetCredentialResponse 叫用的回呼。
針對 Android View 類別提供新的擴充功能 setter API，可用於設定 PendingGetCredentialRequest 的例項。使用這個 API 會準備指定的檢視畫面，這樣當使用者輕觸該畫面時，憑證建議就會顯示在鍵盤/下拉式選單建議等次要 UI 體驗中。

1.3 版本

1.3.0 版本

2024 年 10 月 2 日

發布 androidx.credentials:credentials:1.3.0 和 androidx.credentials:credentials-play-services-auth:1.3.0。1.3.0 版包含這些修訂版本。

自 1.2.0 版以來的重要異動

進行多項重要改善，讓程式庫更可靠且一致，包括但不限於：

在所有 Android 版本上支援 preferImmediatelyAvailableCredentials。
改善 ProGuard 規則，減少應用程式大小增加的情形。
修正多項小錯誤。

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 前裝置上包含錯誤的公開金鑰憑證流程中，正確檢查 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 套件轉換 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 版包含這些修訂項目。

修正錯誤

將 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)
將原始 Bundle 公開給結構化資料轉換輔助程式 (If03a0)
公開 isDefaultIcon 和 isAutoSelectAllowedFromOption API (I05c59)
擴充憑證輸入 API 介面，以便包含圖示預設資訊 (I9fe00)
已在憑證項目中新增 entryGroupId 位元 (Id995c)
在 CredentialEntry API 途徑中新增 affiliationName 屬性。(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 版本 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 模組，為 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 版本

注意：所有專案應使用 androidx.credentials 的最新 1.2 版。先前版本的 androidx.credentials 在 Android 14 上執行時會擲回例外狀況 UnsupportedOperationException("Post-U not supported yet")。

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)
請勿中斷針對 Pre-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 規則，確保 Play 授權模組不會遭到 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)

修正錯誤

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