憑證

這個程式庫可針對使用者的憑證(包括密碼、密碼金鑰和聯合憑證) 提供整合式存取權。請使用這個程式庫提供流暢安全的登入體驗。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 4 月 3 日 1.2.2 - - 1.3.0-alpha02

宣告依附元件

如要為憑證新增依附元件,必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Kotlin

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

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

Groovy

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

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

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

意見回饋:

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

建立新問題

詳情請參閱 Issue Tracker 文件

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

Credentials e2ee 1.0 版。

1.0.0-alpha01 版

2024 年 4 月 3 日

發布 androidx.credentials:credentials-e2ee:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂版本

新功能

  • 支援從密碼金鑰建立 IdentityKey (Iba31e)

1.3 版

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 版本包含以下修訂項目。

修正錯誤

  • 移除 uvm 擴充功能,因為我們預計從 webauthn 規格中淘汰該擴充功能 (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)
  • 為 Create 要求公開自動選取功能 (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 模組之間,適用 get API 回溯相容的剖析功能。

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

  • 新增了在 Jetpack 程式庫中設定來源的 android.permission.CREDENTIAL_MANAGER_SET_ORIGIN 規定。(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 的新程式庫