このページは Cloud Translation API によって翻訳されました。

証明書

API リファレンス
androidx.credentials

このライブラリはユーザーの認証情報への統一アクセスを提供します。パスワード、パスキー、フェデレーションの認証情報などが含まれます。このライブラリは、シームレスで安全なログインエクスペリエンスを提供するために使用します。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2024 年 7 月 10 日	1.2.2	1.3.0-rc01	-	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 のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

認証情報 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 に含まれる commit については、こちらをご覧ください。

新機能

パスキーからの 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 がリリースされました。このバージョンは内部ブランチで開発されています。

新機能

プロバイダ向けに、Jetpack を介して認証情報の作成と取得フローに BiometricPrompt を直接埋め込む機能を CredentialManager で利用できるようになりました。

API の変更

API サーフェスに BiometricPromptData を追加し、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 エクスペリエンス: ログイン時に認証情報マネージャー API を呼び出してユーザーにセレクタを提示するアプリデベロッパーは、新しい API を使用して、同じ GetCredentialRequest をユーザー名やパスワードフィールドなどの特定のビューに関連付けることができるようになりました。

その後、ユーザーがこれらのビューのいずれかにフォーカスすると、対応するリクエストが認証情報マネージャーに送信されます。取得された認証情報は複数のプロバイダから集約され、キーボードやプルダウンの候補といった二次 UI のように自動入力で表示されます。そのため、すべての API を一緒に使用すると、ユーザーにはまずセレクタが表示されます。このセレクタを閉じて上記のフィールドのいずれかをタップすると、キーボードやプルダウンの候補が表示されます。

API の変更

（既存の）GetCredentialRequest と、非同期的に使用可能な場合に（既存の）GetCredentialResponse で呼び出されるコールバックを受け取る PendingGetCredentialRequest クラス。
Android View クラス用の新しい拡張機能セッター 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 には、こちらの commit が含まれています。

新機能

バージョンバンプリリースと小規模な実装アップデート。

バージョン 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 に含まれる commit については、こちらをご覧ください。

バグの修正

U 以前のデバイスでエラーを含む公開鍵認証情報フローで CONSTRAINT_ERR ではなく NOT_ALLOWED_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 に含まれる commit については、こちらをご覧ください。

API の変更

reateCredentialRequest Bundle コンバージョン API の名前を変更。（I46b95）。
Preferredhints 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 に含まれる commit については、こちらをご覧ください。

バグの修正

AndroidX ライブラリのデフォルトの minSdkVersion を 21 に移動しました。（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 に含まれる commit については、こちらをご覧ください。

新機能

getCredential または createCredential の呼び出し中に認証情報セレクタに認証情報エントリが明確に表示されるようにする新しい API を追加しました。

API の変更

表示の優先度に関する情報を含めるために Credential Options API サーフェスを拡張しました（Ied6fe）。
未加工のバンドルを構造化データ変換ヘルパーに公開しました（If03a0）
isDefaultIcon API と 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 に含まれる commit については、こちらをご覧ください。

バグの修正

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 に含まれる commit については、こちらをご覧ください。

バグの修正

複数の処理中のリクエストの競合状態に起因するすでに再開中のエラーを修正（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 に含まれる commit については、こちらをご覧ください。

バグの修正

プラットフォームの認証情報マネージャーが利用できない場合の代替ソリューションを提供しました。（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 に含まれる commit については、こちらをご覧ください。

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 に含まれる commit については、こちらをご覧ください。

バージョンバンプリリースと小規模な実装アップデート

バージョン 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 に含まれる commit については、こちらをご覧ください。

新機能

「Google でログイン」のログインインテント取得フローを追加しました。（Ib6559、I7a042）。
許可リストに登録されたパッケージの単一署名チェックを追加しました。（Ie6ff5）。
更新された toJson() メソッドを使用するように PublicKeyCredential JSON 解析を更新しました。（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 に含まれる commit については、こちらをご覧ください。

バグの修正

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 に含まれる commit については、こちらをご覧ください。

バグの修正

b/293743991 - PublicKeyCredential の authenticationResponseJson プロパティを正しく解析できるように、authenticatorData フィールドの定数値を修正します。

バージョン 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 に含まれる commit については、こちらをご覧ください。

API の変更

オリジンにデータが入力されているかどうかを判断する API を公開しました（Ia91f4）。
カスタム例外を意味的に正しいものにしました。（Ibf6f4）
テスト API を追加（I61c1d）
テスト API を追加（Iaeb6f）
試験運用版の isAtLeastU() API の使用を削除しました（Ie9117、b/289269026）。
許可リストを受け取るカスタムの送信元ゲッターを公開しました。（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 に含まれる commit については、こちらをご覧ください。

新機能

このリリースでは、ユーザーのリクエストごとにパスワードやパスキーを保存および取得する際に認証情報プロバイダをサポートするための新しい API セットが追加されました。

API の変更

Credential Provider をサポートする新しい API を追加しました。

バージョン 1.0

注: すべてのプロジェクトで最新バージョンの androidx.credentials を使用する必要があります。以前のバージョンの 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 に含まれる commit については、こちらをご覧ください。

バグの修正

例外タイプが正確かつ一貫していることを検証します。（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 に含まれる commit については、こちらをご覧ください。

バグの修正

デバッグ出力の読みやすさとエラーメッセージを改善しました。

バージョン 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 に含まれる commit については、こちらをご覧ください。

バグの修正

構成の変更に起因するバグを修正（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 に含まれる commit については、こちらをご覧ください。

新機能

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 に含まれる commit については、こちらをご覧ください。

バグの修正

ユーザーがモーダルシートをキャンセルしたときに、ユーザーのキャンセルエラーを適切に報告します。（/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 に含まれる commit については、こちらをご覧ください。

API の変更

Jetpack ライブラリでオリジンを設定するための android.permission.CREDENTIAL_MANAGER_SET_ORIGIN 要件を追加しました。（Ibaad4）。
パスキー取得フロー例外を追加しました（I4f654）。
CredentialManager API の自動選択の動作の更新（I576dd）
CreateCredentialRequest.DisplayInfo は、String フィールドではなく CharSequence フィールドを使用するようになりました。（I85e70）。

バグの修正

Play 認証モジュールが R8 によって削除されないように ProGuard ルールを追加。（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 に含まれる commit については、こちらをご覧ください。

API の変更

CredentialManager API 署名を変更しました。（Iabdec）
CredentialManager API 署名を変更しました。（I977ed）
CredentialManager API 署名を変更しました。（Ia6e9b）

バグの修正

webauthn 仕様で古い「cable」がサポートされなくなり、その代わりとして、トランスポートリストで「hybrid」が返されるようになりました。
トランスポートが 2 次元リストで返されていた問題を、正しい 1 次元リストになるよう修正しました。

バージョン 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 に含まれる commit については、こちらをご覧ください。

新機能

このリリースには、ユーザーの認証情報への統一アクセスを提供する新しい Jetpack ライブラリが含まれています。パスワード、パスキー、フェデレーション認証情報などが含まれます。このライブラリは、シームレスで安全なログインエクスペリエンスを提供する場合に使用する必要があります。
「androidx.credentials:credentials-play-services-auth:1.0.0-alpha01」は、認証情報を Google パスワードマネージャーに保存し、そこから取得できるライブラリ（オプション）です。Android API レベル 33 以前を搭載しているデバイスでは、この依存関係が必要です。

API の変更

新しい API を含む新しいライブラリを追加