憑證
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 6 月 12 日 | 1.2.2 | - | 1.3.0-beta02 | 1.5.0-alpha02 版本 |
宣告依附元件
如要為憑證新增依附元件,必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Kotlin
dependencies { implementation("androidx.credentials:credentials:1.5.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.5.0-alpha02") }
Groovy
dependencies { implementation "androidx.credentials:credentials:1.5.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.5.0-alpha02" }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋:
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 文件。
這個構件沒有任何版本資訊。
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-alpha02 版
2024 年 6 月 12 日
發布 androidx.credentials:credentials:1.5.0-alpha02
和 androidx.credentials:credentials-play-services-auth:1.5.0-alpha02
。這個版本是以內部分支版本開發。
新功能
- 在憑證建立和擷取流程中,
CredentialManager
直接沿用BiometricPrompt
的功能,現在可透過 Jetpack for 提供者使用。
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 等自動填入 UI 等自動填入服務中顯示,例如鍵盤或下拉式選單建議。因此,當所有 API 都搭配使用時,系統會先向使用者顯示選取工具,如果關閉並輕觸上述其中一個欄位,就會顯示鍵盤/下拉式選單的建議。
API 變更
PendingGetCredentialRequest
類別採用 (現有的)GetCredentialRequest
,以及在非同步的情況下使用GetCredentialResponse
叫用回呼 (現有的)。- 為 Android View 類別新增擴充功能 setter API,可設定
PendingGetCredentialRequest
的執行個體。這個 API 的用途將產生指定的檢視畫面,這樣一來,使用者輕觸該檢視畫面時,鍵盤/下拉式選單建議等次要 UI 服務中就會顯示憑證建議。
1.3 版
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 版包含這些修訂版本。
修正錯誤
- 修正了在公開金鑰憑證流程中正確檢查
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 變更
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 版本包含以下修訂項目。
修正錯誤
- 移除 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 版包含此連結所列的修訂項目。
修正錯誤
- 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)
- 為 Create 要求公開自動選取功能 (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 版
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 版包含此連結所列的修訂項目。
修正錯誤
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 變更
- 新增了在 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-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 的新程式庫