憑證

這個程式庫可針對使用者的憑證(包括密碼、密碼金鑰和聯合憑證) 提供整合式存取權。請使用這個程式庫提供流暢安全的登入體驗。
最近更新時間 穩定版 候選版 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"
}

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

意見回饋

您的意見可協助我們改善 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-alpha05androidx.credentials:credentials-play-services-auth:1.5.0-alpha05。1.5.0-alpha05 版包含這些修訂版本

API 變更

  • 支援新的憑證類型 - DigitalCredential (I12952)
  • 公開套件轉換 API:提供更多 asBundlefromBundle 輔助程式,以讓這些類別更輕鬆地在處理序間通訊 (IPC) 中傳遞 (I1a017)
  • PendingIntentHandler 回溯相容。(I34c13)。
  • CallingAppInfo 回溯相容 (I65085)
  • 公開 ClearCredentialRequestTypes 常數。

1.5.0-alpha04 版

2024 年 8 月 7 日

發布 androidx.credentials:credentials:1.5.0-alpha04androidx.credentials:credentials-play-services-auth:1.5.0-alpha04。1.5.0-alpha04 版包含這些修訂版本

API 變更

  • 已新增 CreateRestoreCredentialRequestisCloudBackupEnabled 參數預設值。

修正錯誤

  • 已移除 credentials-play-services-authminSdkVersion

1.5.0-alpha03 版

2024 年 7 月 24 日

發布 androidx.credentials:credentials:1.5.0-alpha03androidx.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-alpha02androidx.credentials:credentials-play-services-auth:1.5.0-alpha02。這個版本是在內部分支版本中開發。

新功能

  • 現在可以透過 Jetpack 供應商使用 CredentialManager,在憑證建立和擷取流程中直接引入 BiometricPrompt

API 變更

  • 已將 BiometricPromptData 新增至 API 介面,以允許透過 CredentialManager 使用新的 BiometricPrompt 資料流 (I3b159)
  • 已修改 CreateEntryCredentialEntry 中的所有項目類別和子類別,取得提供者的 BiometricPromptData 公用程式。(I16936I8e5bc)
  • 新增了對錯誤編碼所需的類型,以及透過 CredentialManager 標記的 BiometricPrompt 資料流產生的結果。(I8e5bc)。

1.5.0-alpha01 版本

2024 年 5 月 29 日

發布 androidx.credentials:credentials:1.5.0-alpha01androidx.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-rc01androidx.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-beta02androidx.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-beta01androidx.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-alpha04androidx.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-alpha03androidx.credentials:credentials-play-services-auth:1.3.0-alpha03。這個版本包含先前版本缺少的來源 jar。

1.3.0-alpha02 版本

2024 年 4 月 3 日

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

新功能

  • 新增了 API,可協助在 getCredentialcreateCredential 呼叫期間,協助憑證項目清楚顯示憑證選取器。

API 變更

  • 擴充 Credential Options API 介面,納入顯示優先順序資訊 (Ied6fe)
  • 向結構化資料轉換輔助工具公開原始套件 (If03a0)
  • 已公開 isDefaultIconisAutoSelectAllowedFromOption 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-alpha01androidx.credentials:credentials-play-services-auth:1.3.0-alpha011.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.2androidx.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.1androidx.credentials:credentials-play-services-auth:1.2.1。1.2.1 版包含這些修訂版本

修正錯誤

  • 平台憑證管理工具無法使用時,提供的備用解決方案。(b/310701473)。

1.2.0 版本

2023 年 11 月 1 日

發布 androidx.credentials:credentials:1.2.0androidx.credentials:credentials-play-services-auth:1.2.01.2.0 版包含此連結所列的修訂項目。

自 1.0.0 版以來的重要變更

  • 這個版本加入了一組新的 API,可支援憑證提供者 儲存及擷取密碼、每位使用者的密碼金鑰要求。

1.2.0-rc01 版本

2023 年 10 月 4 日

發布 androidx.credentials:credentials:1.2.0-rc01androidx.credentials:credentials-play-services-auth:1.2.0-rc011.2.0-rc01 版包含此連結所列的修訂項目。

  • 採用較新的版本,搭配微幅實作更新

1.2.0-beta04 版

2023 年 9 月 20 日

發布 androidx.credentials:credentials:1.2.0-beta04androidx.credentials:credentials-play-services-auth:1.2.0-beta041.2.0-beta04 版包含以下修訂項目。

新功能

  • 新增「使用 Google 登入」的「取得登入意圖」流程。(Ib6559I7a042)。
  • 已為許可清單中的套件新增單一簽章檢查功能。(Ie6ff5)。
  • 更新 PublicKeyCredential JSON 剖析功能,以便使用更新後的 toJson() 方法。(I708e3I00402)

修正錯誤

1.2.0-beta03 版本

2023 年 8 月 23 日

發布 androidx.credentials:credentials:1.2.0-beta03androidx.credentials:credentials-play-services-auth:1.2.0-beta031.2.0-beta03 版本包含以下修訂項目。

修正錯誤

  • 系統預計從 webauthn 規格淘汰,因此移除 uvm 擴充功能。(I2d46d)。
  • 確保符合與 clientExtensionscredProps 和 rk 屬性相關的 WebAuthn 規格 (I3ab01)

1.2.0-beta02 版

2023 年 8 月 1 日

發布 androidx.credentials:credentials:1.2.0-beta02androidx.credentials:credentials-play-services-auth:1.2.0-beta021.2.0-beta02 版包含此連結所列的修訂項目。

修正錯誤

1.2.0-beta01 版本

2023 年 7 月 26 日

發布 androidx.credentials:credentials:1.2.0-beta01androidx.credentials:credentials-play-services-auth:1.2.0-beta011.2.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 公開 API,以決定是否填入來源 (Ia91f4)
  • 讓自訂例外狀況在語意上正確顯示 (Ibf6f4)
  • 新增測試 API (I61c1d)
  • 新增測試 API (Iaeb6f)
  • 移除實驗性 isAtLeastU() API 的用法 (Ie9117b/289269026)
  • 公開納入許可清單的自訂來源 getter (I0c1b4)
  • 新增了 VisibleForTest 註解 (I5467a)
  • 新增 VisibleForTest 註解 (Idf57a)
  • 移除僅供測試的 API (Idcc05)
  • 將提供者項目類別公開至較低的 API 級別 (I2e00a)
  • 新增測試 API (Id6b9e)

修正錯誤

  • 新增測試 API (I0d243)
  • 新增測試 API (I6fa12)
  • 在建立要求中公開自動選取功能 (I84eee)
  • 更詳細的 JSON 編碼錯誤 (I7a865)
  • 針對非活動結構定義參數,妥善回報開發人員錯誤 (/I20dd7b/288288940)
  • 已修正提供者傳回的例外狀況例外狀況剖析 (Iaa2afI0d243I55151)
  • 改善 toSlice 的說明文件

1.2.0-alpha05 版本

2023 年 6 月 7 日

發布 androidx.credentials:credentials:1.2.0-alpha05androidx.credentials:credentials-play-services-auth:1.2.0-alpha05。這個版本是在內部分支版本中開發。

新功能

  • 在整個 GMS 模組與公用分支一起導入的 GMS 模組中,回溯相容剖析功能。

1.2.0-alpha04 版本

2023 年 5 月 10 日

發布 androidx.credentials:credentials:1.2.0-alpha04androidx.credentials:credentials-play-services-auth:1.2.0-alpha04。這個版本是在內部分支版本中開發。

1.2.0-alpha03 版本

2023 年 4 月 12 日

發布 androidx.credentials:credentials:1.2.0-alpha03androidx.credentials:credentials-play-services-auth:1.2.0-alpha03。這個項目已從內部分支版本發布。

1.2.0-alpha02 版本

2023 年 3 月 8 日

發布 androidx.credentials:credentials:1.2.0-alpha02androidx.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-alpha01androidx.credentials:credentials-play-services-auth:1.2.0-alpha011.2.0-alpha01 版本包含以下修訂項目。

新功能

  • 這個版本加入了一組新的 API,可支援憑證提供者 儲存及擷取密碼、每位使用者的密碼金鑰要求。

API 變更

  • 新增 API,支援憑證提供者。

1.0 版本

1.0.0-alpha09 版本

2023 年 6 月 7 日

發布 androidx.credentials:credentials:1.0.0-alpha09androidx.credentials:credentials-play-services-auth:1.0.0-alpha091.0.0-alpha09 版包含此連結所列的修訂項目。

修正錯誤

  • 驗證例外狀況類型是否正確且一致。(Id13d7)。
  • 支援取得密碼金鑰要求時的 JSON 格式。(I25100)。
  • 密碼金鑰擷取流程與舊版 GMS 模組回溯相容 (I23878)。

1.0.0-alpha08 版本

2023 年 5 月 3 日

發布 androidx.credentials:credentials:1.0.0-alpha08androidx.credentials:credentials-play-services-auth:1.0.0-alpha081.0.0-alpha08 版包含此連結所列的修訂項目。

修正錯誤

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

1.0.0-alpha07 版本

2023 年 4 月 19 日

發布 androidx.credentials:credentials:1.0.0-alpha07androidx.credentials:credentials-play-services-auth:1.0.0-alpha071.0.0-alpha07 版包含此連結所列的修訂項目。

修正錯誤

1.0.0-alpha06 版本

2023 年 4 月 5 日

發布 androidx.credentials:credentials:1.0.0-alpha06androidx.credentials:credentials-play-services-auth:1.0.0-alpha061.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-alpha05androidx.credentials:credentials-play-services-auth:1.0.0-alpha051.0.0-alpha05 版包含此連結所列的修訂項目。

修正錯誤

  • 在使用者取消回應表單時正確回報使用者取消錯誤。(/I9ff3b/271863184)

1.0.0-alpha04 版本

2023 年 3 月 8 日

發布 androidx.credentials:credentials:1.0.0-alpha04androidx.credentials:credentials-play-services-auth:1.0.0-alpha041.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-alpha03androidx.credentials:credentials-play-services-auth:1.0.0-alpha031.0.0-alpha03 版包含此連結所列的修訂項目

新功能

  • 新增「使用 Google 帳戶登入」功能。

API 變更

  • 允許 UnsupportedException 正常運作 (I68208)
  • 新增例外狀況類型,以因應裝置不含必要標記等情況 (If08dd)
  • CredentialManager 例外狀況 API (I72947)

1.0.0-alpha02 版

2023 年 2 月 8 日

發布 androidx.credentials:credentials:1.0.0-alpha02androidx.credentials:credentials-play-services-auth:1.0.0-alpha021.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-alpha01androidx.credentials:credentials-play-services-auth:1.0.0-alpha011.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 這個版本包含新的 Jetpack 程式庫,可針對使用者的憑證(包括密碼、密碼金鑰和聯合憑證) 提供整合式存取權。請使用這個程式庫提供流暢安全的登入體驗。
  • 「androidx.credentials:credentials-play-services-auth:1.0.0-alpha01」是選用程式庫,可讓您將憑證儲存至 Google 密碼管理工具並從中擷取。搭載 Android API 級別 33 以下版本的裝置需要此依附元件。

API 變更

  • 推出使用新版 API 的新程式庫