реквизиты для входа

Эта библиотека обеспечивает унифицированный доступ к учетным данным пользователя. Сюда могут входить пароли, ключи доступа и федеративные учетные данные. Эту библиотеку следует использовать для обеспечения бесперебойного и безопасного входа в систему.
Последнее обновление Стабильный выпуск Релиз-кандидат Бета-версия Альфа-релиз
24 июля 2024 г. 1.2.2 1.3.0-rc01 - 1.5.0-альфа03

Объявление зависимостей

Чтобы добавить зависимость от учетных данных, необходимо добавить в проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

Котлин

dependencies {
    implementation("androidx.credentials:credentials:1.5.0-alpha03")

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

классный

dependencies {
    implementation "androidx.credentials:credentials:1.5.0-alpha03"

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

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см. в документации по системе отслеживания проблем .

Для этого артефакта нет примечаний к выпуску.

Учетные данные e2ee версии 1.0.

Версия 1.0.0-альфа02

17 апреля 2024 г.

androidx.credentials:credentials-e2ee:1.0.0-alpha02 выпущен. Эта версия содержит файлы исходного кода, отсутствовавшие в предыдущей версии.

Версия 1.0.0-альфа01

3 апреля 2024 г.

androidx.credentials:credentials-e2ee:1.0.0-alpha01 выпущен. Версия 1.0.0-alpha01 содержит эти коммиты .

Новые возможности

  • Поддержка создания IdentityKey из ключа доступа ( Iba31e ).

Версия 1.5

Версия 1.5.0-альфа03

24 июля 2024 г.

Выпущены androidx.credentials:credentials:1.5.0-alpha03 и androidx.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-альфа02

12 июня 2024 г.

androidx.credentials:credentials:1.5.0-alpha02 и androidx.credentials:credentials-play-services-auth:1.5.0-alpha02 выпущены. Эта версия разработана во внутренней ветке.

Новые возможности

  • Возможность CredentialManager напрямую внедрять BiometricPrompt в потоки создания и получения учетных данных теперь доступна для использования через Jetpack для поставщиков.

Изменения API

  • Добавлен BiometricPromptData на поверхность API, чтобы можно было использовать новый встроенный поток BiometricPrompt через CredentialManager ( I3b159 ).
  • Изменены все классы и подклассы записей в CreateEntry и CredentialEntry , чтобы получить возможность использования BiometricPromptData для поставщиков. ( I16936 , I8e5bc )
  • Добавлены типы, необходимые для кодирования ошибки и результатов из внедренных потоков BiometricPrompt с помощью CredentialManager . ( I8e5bc )

Версия 1.5.0-альфа01

29 мая 2024 г.

Выпущены androidx.credentials:credentials:1.5.0-alpha01 и androidx.credentials:credentials-play-services-auth:1.5.0-alpha01 . Эта версия разработана во внутренней ветке.

Новые возможности

Вторичный интерфейс пользовательского интерфейса для выбора учетных данных. Разработчики приложений, которые вызывают API-интерфейсы Credential Manager в момент входа в систему, чтобы предоставить пользователю селектор, теперь могут использовать новые API-интерфейсы для связывания одного и того же GetCredentialRequest с заданным представлением, например именем пользователя или именем пользователя. поле пароля.

Впоследствии, когда пользователь сосредоточится на одном из этих представлений, соответствующий запрос будет отправлен в Credential Manager. Полученные учетные данные объединяются между поставщиками и отображаются при автозаполнении, как и дополнительные пользовательские интерфейсы, такие как клавиатура или раскрывающиеся списки. Таким образом, когда все API используются вместе, пользователю сначала предоставляется селектор, а если он отклоняется и нажимает на одно из полей, упомянутых выше, затем ему предлагаются предложения клавиатуры или раскрывающегося списка.

Изменения API

  • Класс PendingGetCredentialRequest , который принимает (ранее существующий) GetCredentialRequest и обратный вызов, который нужно вызвать с помощью (ранее существующего) GetCredentialResponse , если он доступен асинхронно.
  • Новый API установки расширений для класса Android View, который позволяет устанавливать экземпляр PendingGetCredentialRequest . Использование этого API подготовит данное представление, так что, когда пользователь нажмет на него, предложения учетных данных будут отображаться во дополнительных элементах пользовательского интерфейса, таких как предложения клавиатуры или раскрывающегося списка.

Версия 1.3

Версия 1.3.0-rc01

10 июля 2024 г.

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

12 июня 2024 г.

Выпущены 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 в потоках учетных данных открытого ключа, содержащих ошибку на устройствах до U ( I31b37 ).

Версия 1.3.0-бета01

29 мая 2024 г.

Выпущены androidx.credentials:credentials:1.3.0-beta01 и androidx.credentials:credentials-play-services-auth:1.3.0-beta01 . Версия 1.3.0-beta01 содержит эти коммиты .

Изменения API

  • Переименуйте API преобразования reateCredentialRequest Bundle. ( I46b95 )
  • Обновите API Priorityhints ( Ida554 ).

Версия 1.3.0-альфа04

14 мая 2024 г.

Выпущены androidx.credentials:credentials:1.3.0-alpha04 и androidx.credentials:credentials-play-services-auth:1.3.0-alpha04 . Версия 1.3.0-alpha04 содержит эти коммиты .

Исправление ошибок

  • Перейдите к 21 в качестве minSdkVersion по умолчанию для библиотек AndroidX. ( I6ec7f )
  • Поддержка создания PRF для Android версии 13 и ниже.
  • Поддержка preferImmediatelyAvailableCredentials для Android версии 13 и ниже.

Версия 1.3.0-альфа03

17 апреля 2024 г.

Выпущены androidx.credentials:credentials:1.3.0-alpha03 и androidx.credentials:credentials-play-services-auth:1.3.0-alpha03 . Эта версия содержит файлы исходного кода, отсутствовавшие в предыдущей версии.

Версия 1.3.0-альфа02

3 апреля 2024 г.

Выпущены 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

  • Расширена поверхность API параметров учетных данных, чтобы она содержала информацию о приоритетах отображения ( Ied6fe ).
  • Предоставляется необработанный пакет помощникам преобразования структурированных данных ( If03a0 ).
  • Открытые API isDefaultIcon и isAutoSelectAllowedFromOption ( I05c59 ).
  • Расширена поверхность API ввода учетных данных, чтобы она содержала информацию о значении значка по умолчанию ( I9fe00 ).
  • Добавлен бит entryGroupId к записям учетных данных ( Id995c ).
  • Добавлено новое свойство affiliationName в поверхность API CredentialEntry . ( I6261e )
  • Открытые API- fromXYZEntry для использования в платформе ( I645a1 ).

Исправления ошибок — предоставлено запасное решение, когда диспетчер учетных данных платформы недоступен. ( b/310701473 ) — исправление NPE, вызванное API clearCredentialState ( b/327686881 ).

Версия 1.3.0-альфа01

13 декабря 2023 г.

Выпущены androidx.credentials:credentials:1.3.0-alpha01 и androidx.credentials:credentials-play-services-auth:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Исправление ошибок

  • Минимальная версия APK, необходимая для сервисов Google Play, теперь — 2023 v08.23 (версия APK версии APK 230815045), и эта проверка встроена в библиотеку. ( аосп/2856137 )
  • Исправлена ​​ошибка уже возобновления, вызванная состоянием гонки нескольких текущих запросов ( Ic3567 ).

Версия 1.2

Версия 1.2.2

3 апреля 2024 г.

androidx.credentials:credentials:1.2.2 и androidx.credentials:credentials-play-services-auth:1.2.2 выпущены. Версия 1.2.2 содержит эти коммиты .

Исправление ошибок

  • Исправлена ​​ошибка уже возобновления, вызванная состоянием гонки нескольких текущих запросов ( Ic3567 ).
  • Исправление NPE, вызванное API clearCredentialState ( b/327686881 ).

Версия 1.2.1

6 марта 2024 г.

androidx.credentials:credentials:1.2.1 и androidx.credentials:credentials-play-services-auth:1.2.1 выпущены. Версия 1.2.1 содержит эти коммиты .

Исправление ошибок

  • Предоставлено запасное решение, когда диспетчер учетных данных платформы недоступен. ( б/310701473 )

Версия 1.2.0

1 ноября 2023 г.

Выпущены 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

4 октября 2023 г.

androidx.credentials:credentials:1.2.0-rc01 и androidx.credentials:credentials-play-services-auth:1.2.0-rc01 выпущены. Версия 1.2.0-rc01 содержит эти коммиты.

  • Обновление версии вместе с небольшими обновлениями реализации.

Версия 1.2.0-бета04

20 сентября 2023 г.

Выпущены 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 )
  • Обновлен анализ json PublicKeyCredential для использования обновленных методов toJson() . ( I708e3 , I00402 )

Исправление ошибок

  • Исправлены отсутствующие правила Proguard ( b/288120539 ).

Версия 1.2.0-бета03

23 августа 2023 г.

androidx.credentials:credentials:1.2.0-beta03 и androidx.credentials:credentials-play-services-auth:1.2.0-beta03 выпущены. Версия 1.2.0-beta03 содержит эти коммиты.

Исправление ошибок

  • Удаляет расширения uvm из-за запланированного прекращения поддержки спецификации webauthn. ( I2d46d )
  • Обеспечьте соответствие спецификации webauthn в отношении свойств clientExtensions , credProps и rk ( I3ab01 ).

Версия 1.2.0-бета02

1 августа 2023 г.

androidx.credentials:credentials:1.2.0-beta02 и androidx.credentials:credentials-play-services-auth:1.2.0-beta02 выпущены. Версия 1.2.0-beta02 содержит эти коммиты.

Исправление ошибок

  • b/293743991 — исправлено постоянное значение для поля authenticatorData , чтобы правильно анализировать свойство authenticationResponseJson в PublicKeyCredential.

Версия 1.2.0-бета01

26 июля 2023 г.

Выпущены 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 )
  • Удалено использование экспериментального API isAtLeastU() ( 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-альфа05

7 июня 2023 г.

Выпущены androidx.credentials:credentials:1.2.0-alpha05 и androidx.credentials:credentials-play-services-auth:1.2.0-alpha05 . Эта версия разработана во внутренней ветке.

Новые возможности

  • Обратная совместимость синтаксического анализа API-интерфейса get в модулях GMS, представленных вместе с общедоступной веткой.

Версия 1.2.0-альфа04

10 мая 2023 г.

androidx.credentials:credentials:1.2.0-alpha04 и androidx.credentials:credentials-play-services-auth:1.2.0-alpha04 выпущены. Эта версия разработана во внутренней ветке.

Версия 1.2.0-альфа03

12 апреля 2023 г.

androidx.credentials:credentials:1.2.0-alpha03 и androidx.credentials:credentials-play-services-auth:1.2.0-alpha03 выпущены. Это было выпущено из внутренней ветки.

Версия 1.2.0-альфа02

8 марта 2023 г.

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-альфа01

8 февраля 2023 г.

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-альфа09

7 июня 2023 г.

Выпущены 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-альфа08

3 мая 2023 г.

Выпущены androidx.credentials:credentials:1.0.0-alpha08 и androidx.credentials:credentials-play-services-auth:1.0.0-alpha08 . Версия 1.0.0-alpha08 содержит эти коммиты.

Исправление ошибок

  • Улучшена читаемость вывода отладки и сообщений об ошибках.

Версия 1.0.0-альфа07

19 апреля 2023 г.

Выпущены 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-альфа06

5 апреля 2023 г.

Выпущены 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-альфа05

22 марта 2023 г.

androidx.credentials:credentials:1.0.0-alpha05 и androidx.credentials:credentials-play-services-auth:1.0.0-alpha05 выпущены. Версия 1.0.0-alpha05 содержит эти коммиты.

Исправление ошибок

  • Правильно сообщайте об ошибке отмены пользователя, когда пользователь отменяет модальный лист. ( /I9ff3 , б/271863184 )

Версия 1.0.0-альфа04

8 марта 2023 г.

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. ( Ибаад4 )
  • Добавлены исключения потока получения ключа доступа ( I4f654 ).
  • Обновление поведения автоматического выбора API CredentialManager ( I576dd )
  • CreateCredentialRequest.DisplayInfo теперь использует поля CharSequence , а не String . ( I85e70 )

Исправление ошибок

  • Добавьте правила proguard, чтобы гарантировать, что модуль аутентификации воспроизведения не будет удален R8. ( 9543977 )

Версия 1.0.0-альфа03

22 февраля 2023 г.

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 ).
  • API исключения CredentialManager ( I72947 )

Версия 1.0.0-альфа02

8 февраля 2023 г.

androidx.credentials:credentials:1.0.0-alpha02 и androidx.credentials:credentials-play-services-auth:1.0.0-alpha02 выпущены. Версия 1.0.0-alpha02 содержит эти коммиты.

Изменения API

  • Изменения подписи API CredentialManager ( Iabdec )
  • Изменения подписи API CredentialManager ( I977ed )
  • Изменения подписи API CredentialManager ( Ia6e9b )

Исправление ошибок

  • Старый «кабель» больше не поддерживается в спецификации webauthn , и его замена, «гибрид», теперь возвращается в список транспорта.
  • Транспорты были возвращены в виде двумерных списков, исправлено, чтобы это был правильный 1d список.

Версия 1.0.0-альфа01

11 января 2023 г.

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.