Браузер

Отображение веб-страниц в браузере пользователя по умолчанию.
Последнее обновление Стабильный релиз Кандидат на релиз Бета-релиз Альфа-релиз
20 мая 2025 г. 1.8.0 - - 1.9.0-альфа04

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

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

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

классный

dependencies {
    implementation "androidx.browser:browser:1.8.0"
}

Котлин

dependencies {
    implementation("androidx.browser:browser:1.8.0")
}

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

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

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

Создать новый выпуск

Более подробную информацию смотрите в документации Issue Tracker .

Версия 1.9

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

20 мая 2025 г.

Выпущен androidx.browser:browser:1.9.0-alpha04 . Версия 1.9.0-alpha04 содержит эти коммиты .

Изменения API

  • Добавлен новый дополнительный объект Intent для пользовательских вкладок ( I911e0 )
  • Добавлены режимы Browser и MiminalUi в TWADisplayMode ( I230b5 )
  • Добавлен API проверки возможностей для эфемерного просмотра ( I17d42 )
  • Удалить экспериментальную аннотацию для PendingSession API ( Id6fe3 )
  • Добавлен API проверки возможностей вкладки аутентификации ( Ifc029 )
  • Удалены экспериментальные аннотации минимизации сигналов пользовательской вкладки ( If2b44 )

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

23 апреля 2025 г.

Выпущен androidx.browser:browser:1.9.0-alpha03 . Версия 1.9.0-alpha03 содержит эти коммиты .

Изменения API

  • Удалена экспериментальная аннотация из вкладки «Аутентификация» ( I786ff ).

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

9 апреля 2025 г.

Выпущен androidx.browser:browser:1.9.0-alpha02 . Версия 1.9.0-alpha02 содержит эти коммиты .

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

Изменения API

  • Добавлены перегрузки для CustomTabsClient#createPendingAuthTabSession . ( I71c3a )
  • Обновленные API вкладки аутентификации ( Iaf9b1 )
  • TrustedWebActivityIntent теперь включает клиентский режим API Launch Handler, который позволяет браузеру использовать этот API. ( Ifc95c )
  • TrustedWebActivityIntent теперь включает URI файлов, открытых с помощью зарегистрированных фильтров намерений приложения, и предоставляет браузеру разрешения на чтение и запись этих файлов. ( I2134a )
  • TrustedWebActivityIntent теперь включает изначально запущенный URL в свои дополнительные данные, добавляя контекст для браузера при использовании обработчиками протоколов. ( I3759a )
  • Добавлен новый API для включения/отключения кнопки закрытия для пользовательских вкладок. ( I35acd )
  • Добавлена ​​поддержка настройки значка кнопки «Закрыть» на вкладке «Аутентификация» ( Iaf877 )

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

29 января 2025 г.

Выпущен androidx.browser:browser:1.9.0-alpha01 . Версия 1.9.0-alpha01 содержит эти коммиты .

Изменения API

  • Добавлена ​​поддержка подключения/сеанса браузера на вкладке «Аутентификация». ( I6e47b )
  • Добавлен новый API CustomTabsSession#isEphemeralBrowsingSupported , который определяет, поддерживается ли эфемерный просмотр ( Ie4dea , b/384548523 )
  • Добавлена ​​поддержка параметров цветовой схемы в API Auth Tab. ( I630e1 )
  • Добавлена ​​экспериментальная опция временного просмотра в пользовательские вкладки ( I9549d )
  • Обновлены экспериментальные API-интерфейсы вкладки аутентификации ( I8b674 )
  • Добавить новый API для проверки того, поддерживает ли поставщик пользовательских вкладок многосетевой режим. ( I4307a )
  • Добавить новую категорию фильтра намерений обслуживания для поддержки нескольких сетей. ( I4354a )
  • Добавить новый API для установки/получения привязанной сети при запуске URL-адреса через пользовательскую вкладку. ( I493e1 )
  • Добавлены экспериментальные API-интерфейсы вкладки аутентификации ( I9b4d4 )
  • Новые экспериментальные API для PendingSession ( Ib40e5 )

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

  • Обновлены Javadocs AuthTabIntent ( I2490c )
  • Исправлена ​​поддержка сеанса на вкладке «Аутентификация» ( I4e280 )
  • Эта библиотека теперь использует аннотации nullness JSpecify , которые являются type-use. Разработчики Kotlin должны использовать следующий аргумент компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict (это значение по умолчанию, начиная с версии 2.1.0 компилятора Kotlin). ( Ic7bf5 , b/326456246 )
  • Удалено ручное описание доступа к новым API платформы, поскольку это происходит автоматически через моделирование API при использовании R8 с AGP 7.3 или более поздней версии (например, R8 версии 3.3) и для всех сборок при использовании AGP 8.1 или более поздней версии (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется обновиться до D8 версии 8.1 или более поздней версии. Подробнее см. в этой статье . ( I9496c , b/345472586 )

Внешний вклад

  • Введен новый вызов IPC ICustomTabsService#prefetchWithMultipleUrls , чтобы избежать множественных вызовов IPC для одного URL-адреса. ( Ie5025 )
  • Заставить CustomTabsSession#prefetch распространять идентификатор сеанса CustomTabsSession id(mID) в CustomTabsService . ( I4ec7b )
  • Добавить новый экспериментальный API CustomTabsSession#prefetch(List<Uri>, PrefetchOptions) , который перегружает существующий API для приема нескольких URL-адресов. ( I54f35 )
  • Добавить новый экспериментальный API CustomTabsSession#prefetch(Uri, PrefetchOptions) , который пытается предварительно загрузить главную страницу (без подресурсов) для будущих навигаций. ( I340cf )

Версия 1.8

Версия 1.8.0

6 марта 2024 г.

Выпущен androidx.browser:browser:1.8.0 . Версия 1.8.0 содержит эти коммиты .

Важные изменения по сравнению с версией 1.7.0

  • Добавлен CustomTabsIntent.Builder#setInitialActivityWidthPx , который позволяет разработчикам указывать начальную ширину запуска пользовательской вкладки. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetPosition , который позволяет разработчикам указывать положение пользовательской вкладки, когда она действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetDecorationType , который позволяет разработчикам указывать тип оформления пользовательской вкладки, когда она действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition , который позволяет разработчикам указывать положение закругленных углов, когда пользовательская вкладка действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled , который позволяет разработчикам включать или отключать кнопку максимизации, когда пользовательская вкладка действует как боковой лист. ( Ie3564 )
  • Добавлен метод обратного вызова onActivityLayout для интерфейса CustomTabsCallback , чтобы позволить разработчикам узнать координаты области, занимаемой Custom Tab, и состояние, в котором она отображается. Он будет вызываться, когда Custom Tab впервые отображается на экране, и каждый раз, когда изменяется занимаемая область. ( I443f6 )
  • Добавлен метод обратного вызова onWarmupCompleted для интерфейса CustomTabsCallback , чтобы информировать разработчиков о том, когда CustomTabsClient#warmupfinishes завершает процесс прогрева браузера. ( I107cf )
  • Добавлен идентификатор сеанса в дополнительные функции CustomTabsSession#setEngagementSignalsCallback и CustomTabsSession#isEngagementSignalsApiAvailable . ( Iba7f1 )
  • Добавлена ​​экспериментальная поддержка API минимизированных пользовательских вкладок. ( I67f2d )

Версия 1.8.0-rc01

21 февраля 2024 г.

androidx.browser:browser:1.8.0-rc01 выпущен без изменений с 1.8.0-beta02. Версия 1.8.0-rc01 содержит эти коммиты.

Версия 1.8.0-beta02

7 февраля 2024 г.

Выпущен androidx.browser:browser:1.8.0-beta02 . Версия 1.8.0-beta02 содержит эти коммиты.

Изменения API

  • Переименован CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization в CustomTabsIntent Builder#setActivitySideSheetMaximizationEnabled и сделан публичным API. Он позволяет разработчикам включать или отключать кнопку максимизации, когда Custom Tab действует как боковой лист. ( Ie3564 )

Версия 1.8.0-beta01

29 ноября 2023 г.

Выпущен androidx.browser:browser:1.8.0-beta01 . Версия 1.8.0-beta01 содержит эти коммиты.

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

  • Добавить экспериментальную поддержку API минимизированных пользовательских вкладок. ( I67f2d )

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

15 ноября 2023 г.

Выпущен androidx.browser:browser:1.8.0-alpha01 . Версия 1.8.0-alpha01 содержит эти коммиты.

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

  • Добавлен CustomTabsIntent.Builder#setInitialActivityWidthPx , который позволяет разработчикам указывать начальную ширину запуска пользовательской вкладки. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp , который позволяет разработчикам указывать минимальную ширину окна пользовательских вкладок, чтобы оно действовало как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetPosition , который позволяет разработчикам указывать положение пользовательской вкладки, когда она действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization , который позволяет разработчикам включать или отключать кнопку максимизации, когда пользовательская вкладка действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetDecorationType , который позволяет разработчикам указывать тип оформления пользовательской вкладки, когда она действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition , который позволяет разработчикам указывать положение закругленных углов, когда пользовательская вкладка действует как боковой лист. ( I443f6 )
  • Добавлен метод обратного вызова onActivityLayout для интерфейса CustomTabsCallback , чтобы позволить разработчикам узнать координаты области, занимаемой Custom Tab, и состояние, в котором она отображается. Он будет вызываться, когда Custom Tab впервые отображается на экране, и каждый раз, когда изменяется занимаемая область. ( I443f6 )
  • Добавлен метод обратного вызова onWarmupCompleted для интерфейса CustomTabsCallback , чтобы информировать разработчиков о завершении процесса прогрева браузера CustomTabsClient#warmup . ( I107cf )

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

  • Добавлен идентификатор сеанса в дополнительные функции CustomTabsSession#setEngagementSignalsCallback и CustomTabsSession#isEngagementSignalsApiAvailable . ( Iba7f1 )

Версия 1.7

Версия 1.7.0

15 ноября 2023 г.

Выпущен androidx.browser:browser:1.7.0 . Версия 1.7.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.6.0

  • Добавлен CustomTabsIntent.Builder#setBookmarksButtonEnabled , который включает кнопку закладок в дополнительном меню. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setDownloadButtonEnabled , который включает кнопку загрузки в дополнительном меню. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled , который позволяет отправлять начальные URL-адреса во внешние приложения-обработчики. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setTranslateLanguage , который указывает целевой язык, на котором должен запускаться пользовательский интерфейс переводчика. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который включает взаимодействие с фоновым приложением при запуске частичной пользовательской вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , позволяющий Custom Tabs получать идентификационные данные вызывающего абонента. ( I7bf2b )
  • Добавлен CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture , который устанавливает PendingIntent для отправки, когда пользователь проводит пальцем вверх от нижней панели инструментов. ( Id42a2 )

Версия 1.7.0-rc01

1 ноября 2023 г.

androidx.browser:browser:1.7.0-rc01 выпущен без изменений. Версия 1.7.0-rc01 содержит эти коммиты.

  • Никаких изменений с момента альфа-01

Версия 1.7.0-beta01

18 октября 2023 г.

androidx.browser:browser:1.7.0-beta01 выпущен без изменений. Версия 1.7.0-beta01 содержит эти коммиты.

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

4 октября 2023 г.

Выпущен androidx.browser:browser:1.7.0-alpha01 . Версия 1.7.0-alpha01 содержит эти коммиты.

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

  • Добавлен CustomTabsIntent.Builder#setBookmarksButtonEnabled , который включает кнопку закладок в дополнительном меню. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setDownloadButtonEnabled , который включает кнопку загрузки в дополнительном меню. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled , который позволяет отправлять начальные URL-адреса во внешние приложения-обработчики. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setTranslateLanguage , который указывает целевой язык, на котором должен запускаться пользовательский интерфейс переводчика. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который включает взаимодействие с фоновым приложением при запуске частичной пользовательской вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , позволяющий Custom Tabs получать идентификационные данные вызывающего абонента. ( I7bf2b )
  • Добавлен CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture , который устанавливает PendingIntent для отправки, когда пользователь проводит пальцем вверх от нижней панели инструментов. ( Id42a2 )

Версия 1.6

Версия 1.6.0

9 августа 2023 г.

androidx.browser:browser:1.6.0 выпущен без изменений с 1.6.0-rc01. Версия 1.6.0 содержит эти коммиты.

Версия 1.6.0-rc01

26 июля 2023 г.

androidx.browser:browser:1.6.0-rc01 выпущен без изменений с 1.6.0-beta01. Версия 1.6.0-rc01 содержит эти коммиты.

Версия 1.6.0-beta01

21 июня 2023 г.

androidx.browser:browser:1.6.0-beta01 выпущен без изменений с 1.6.0-alpha02. Версия 1.6.0-beta01 содержит эти коммиты.

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

7 июня 2023 г.

Выпущен androidx.browser:browser:1.6.0-alpha02 . Версия 1.6.0-alpha02 содержит эти коммиты.

Изменения API

  • Удален CustomTabsSession#getGreatestScrollPercentage . ( I6c5ba )
  • Добавлен новый API requestPostMessageChannel , который позволяет указать целевой источник. Это означает, что пользователи могут быть уверены, что их сообщения будут доставлены только на тот сайт, который они ожидают. ( Id5b7f )

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

  • Обновлена ​​документация EngagementSignalsCallback . ( Ie833c )

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

3 мая 2023 г.

Выпущен androidx.browser:browser:1.6.0-alpha01 . Версия 1.6.0-alpha01 содержит эти коммиты.

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

  • Добавлен API сигналов взаимодействия, который позволяет разработчикам получать обратные вызовы для взаимодействий пользователя на веб-странице, таких как прокрутка. ( I835e6 )

Изменения API

  • Обновленный API сигналов взаимодействия для упрощения поверхности API на стороне реализации пользовательских вкладок. ( Iaa6dc )

Версия 1.5

Версия 1.5.0

8 февраля 2023 г.

Выпущен androidx.browser:browser:1.5.0 . Версия 1.5.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.4.0

  • Добавлен CustomTabsIntent.Builder#setInitialActivityHeightPx , который позволяет разработчикам указывать начальную высоту запуска пользовательской вкладки и, при необходимости, поведение изменения размера (фиксированное или изменяемое). ( I48bd3 )
  • Добавлен CustomTabsIntent.Builder#setToolbarCornerRadiusDp , который позволяет разработчикам указывать радиус верхнего угла панели инструментов. ( I48bd3 )
  • Добавлен CustomTabsIntent.Builder#setCloseButtonPosition , который позволяет разработчикам устанавливать положение кнопки закрытия на панели инструментов. ( I48bd3 )
  • Добавлен метод обратного вызова onActivityResized для взаимодействия CustomTabsCallback , чтобы сообщать разработчикам об изменении размера пользовательской вкладки. ( Ic864e )
  • Сделать части API CustomTabsCallback асинхронными. ( Ic86df )
  • Заполняет текущий язык приложения в Accept-Language по умолчанию для соответствия языковому интерфейсу Android для каждого приложения. ( I3d1d7 )
  • Добавлено @RequiresPermission в API, требующие предоставления разрешения POST_NOTIFICATIONS в SDK 33 и выше. Это было разработано во внутренней ветке. b/238790278 для справки.

Версия 1.5.0-rc01

25 января 2023 г.

Выпущен androidx.browser:browser:1.5.0-rc01 . Версия 1.5.0-rc01 содержит эти коммиты.

  • Никаких изменений с версии 1.5.0-beta01.

Версия 1.5.0-beta01

11 января 2023 г.

Выпущен androidx.browser:browser:1.5.0-beta01 . Версия 1.5.0-beta01 содержит эти коммиты.

  • Никаких изменений с версии 1.5.0-alpha02

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

7 декабря 2022 г.

Выпущен androidx.browser:browser:1.5.0-alpha02 . Версия 1.5.0-alpha02 содержит эти коммиты.

Изменения API

  • Изменено поведение CustomTabsCallback#onActivityResized и добавлены новые параметры.
  • Переименован EXTRA_ACTIVITY_RESIZE_BEHAVIOR в EXTRA_ACTIVITY_RESIZE_HEIGHT_BEHAVIOR , чтобы лучше отразить его зависимость от высоты. ( Ic864e )
  • Сделать части API CustomTabsCallback асинхронными. ( Ic86df )

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

24 октября 2022 г.

Выпущен androidx.browser:browser:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит эти коммиты.

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

  • Добавлен CustomTabsIntent.Builder#setInitialActivityHeightPx , который позволяет разработчикам указывать начальную высоту запуска пользовательской вкладки и, при необходимости, поведение изменения размера (фиксированное или изменяемое). ( I48bd3 )
  • Добавлен CustomTabsIntent.Builder#setToolbarCornerRadiusDp , который позволяет разработчикам указывать радиус верхнего угла панели инструментов. ( I48bd3 )
  • Добавлен CustomTabsIntent.Builder#setCloseButtonPosition , который позволяет разработчикам устанавливать положение кнопки закрытия на панели инструментов. ( I48bd3 )
  • Добавлен метод обратного вызова onActivityResized для взаимодействия с CustomTabsCallback, чтобы сообщать разработчикам об изменении размера пользовательской вкладки (разворачивании до полной высоты или сворачивании до первоначальной высоты запуска). ( Id99ce )
  • Заполняет текущий язык приложения в Accept-Language по умолчанию для соответствия языковому интерфейсу Android для каждого приложения. ( I3d1d7 )

Изменения API

  • Добавлено @RequiresPermission в API, требующие предоставления разрешения POST_NOTIFICATIONS в SDK 33 и выше. Это было разработано во внутренней ветке. b/238790278 для справки.

Версия 1.4.0

Версия 1.4.0

3 ноября 2021 г.

Выпущен androidx.browser:browser:1.4.0 . Версия 1.4.0 содержит эти коммиты.

Важные изменения по сравнению с версией 1.3.0

  • Отметьте PendingIntents как PendingIntent.FLAG_IMMUTABLE для совместимости с Android 12.

Версия 1.4.0-rc01

13 октября 2021 г.

androidx.browser:browser:1.4.0-rc01 выпущен без изменений с 1.4.0-beta01. Версия 1.4.0-rc01 содержит эти коммиты.

Версия 1.4.0-beta01

29 сентября 2021 г.

androidx.browser:browser:1.4.0-beta01 выпущен без изменений с 1.4.0-alpha01 . Версия 1.4.0-beta01 содержит эти коммиты.

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

15 сентября 2021 г.

Выпущен androidx.browser:browser:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит эти коммиты.

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

  • Отметьте PendingIntents как PendingIntent.FLAG_IMMUTABLE для совместимости с Android 12.

Версия 1.3.0

Версия 1.3.0

2 декабря 2020 г.

Выпущен androidx.browser:browser:1.3.0 . Версия 1.3.0 содержит эти коммиты.

Основные возможности версии 1.2.0

  • Команды свободной формы могут быть переданы из браузера в клиент Trusted Web Activity с помощью вызова TrustedWebActivityServiceConnection#sendExtraCommand . Клиент может обрабатывать их в TrustedWebActivityService#onExtraCommand
  • Добавлен интерфейс TrustedWebActivityCallback , который может использоваться клиентом Trusted Web Activity для возврата данных в браузер.
  • Добавлен CustomTabsIntent#setShareState , который позволяет разработчикам указывать, показывать ли опцию общего доступа или нет (или оставить это на усмотрение браузера).
  • Разработчики теперь могут устанавливать ориентацию экрана по умолчанию с помощью метода setScreenOrientation в TrustedWebActivityIntentBuilder
  • Метод setNavigationBarDividerColor добавлен в CustomTabColorSchemeParams для поддержки изменения цвета разделителя панели навигации.
  • Добавлен CustomTabsIntent.Builder#setDefaultColorSchemeParams для замены устаревших методов #setNavigationBarColor , #setNavigationBarDividerColor , #setToolbarColor и #setSecondaryToolbarColor
  • Добавлен метод CustomTabsClient#bindCustomTabsServicePreservePriority , позволяющий подключаться к службе пользовательских вкладок без использования флага Context.BIND_WAIVE_PRIORITY .

Версия 1.3.0-rc01

11 ноября 2020 г.

androidx.browser:browser:1.3.0-rc01 выпущен без изменений с 1.3.0-beta01 . Версия 1.3.0-rc01 содержит эти коммиты.

Версия 1.3.0-beta01

28 октября 2020 г.

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

Изменения API

  • Переименован bindCustomTabServicePreservePriority в bindCustomTabsServicePreservePriority ( I29ac1 )

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

  • Проверка API lint для MissingGetterMatchingBuilder включена для androidx ( I4bbea , b/138602561 )

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

1 октября 2020 г.

Выпущен androidx.browser:browser:1.3.0-alpha06 . Версия 1.3.0-alpha06 содержит эти коммиты.

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

  • Добавляет CustomTabsIntent#setShareState, который позволяет разработчику включить или отключить состояние общего доступа или оставить это на усмотрение браузера. ( I153fe )
  • Добавляет CustomTabsIntent.Builder#setDefaultColorSchemeParams, который следует использовать вместо устаревших методов #setNavigationBarColor, #setNavigationBarDividerColor, #setToolbarColor, #setSecondaryToolbarColor. ( I09012 )

Изменения API

  • Проверка API lint для StaticFinalBuilder включена для androidx ( I2b11b , b/138602561 )
  • Добавляет CustomTabsService#KEY_SUCCESS и TrustedWebActivityService#KEY_SUCCESS, которые можно использовать для указания на успешное выполнение extraCommand. ( I6f7b5 )

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

5 августа 2020 г.

Выпущен androidx.browser:browser:1.3.0-alpha05 . Версия 1.3.0-alpha05 содержит эти коммиты.

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

  • Разрешить настройку ориентации запускаемых доверенных веб-активностей.
  • Разрешить настройку цвета разделителя панели навигации для доверенных веб-активностей и пользовательских вкладок.

Изменения API

  • Добавлен метод setScreenOrientation в TrustedWebActivityIntentBuilder .
  • Добавлен @IntDef для ScreenOrientation.LockType для представления типа блокировки ( I802d2 ).
  • Добавлен метод setNavigationBarDividerColor в TrustedWebActivityIntentBuilder и CustomTabColorSchemeParams . ( Ia04dd )
    • Добавлены @IntDef в методы TrustedWebActivityIntentBuilder , которые принимают цветовую схему.

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

24 июня 2020 г.

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

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

  • Добавлен метод CustomTabsClient#bindCustomTabServicePreservePriority , позволяющий подключаться к службе пользовательских вкладок без использования флага Context.BIND_WAIVE_PRIORITY .

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

10 июня 2020 г.

Выпущен androidx.browser:browser:1.3.0-alpha03 . Версия 1.3.0-alpha03 содержит эти коммиты.

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

  • Добавлен интерфейс TrustedWebActivityCallback , который может использоваться клиентом Trusted Web Activity для возврата данных в браузер. ( I64dbb )

Изменения API

  • TrustedWebActivityServiceConnection.extraCommand теперь также принимает параметр @Nullable TrustedWebActivityCallback . Параметр bundle теперь помечен как @NonNull вместо @Nullable . ( I64dbb )
  • Метод TrustedWebActivityServiceConnection.extraCommand переименован в sendExtraCommand ( Id29a8 )
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() устарел в пользу нового #setDefaultShareMenuItemEnabled(boolean) , а CustomTabsIntent.Builder#enableUrlBarHiding() устарел в пользу нового #setUrlBarHidingEnabled(boolean) . ( Iad702 )

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

8 января 2020 г.

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

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

  • Команды свободной формы могут быть переданы из браузера в клиент Trusted Web Activity путем вызова TrustedWebActivityServiceConnection#extraCommand . Клиент может обрабатывать их в TrustedWebActivityService#onExtraCommand .

Изменения API

  • URL-адрес, предоставленный CustomTabsSession#mayLauncherUrl и полученный в CustomTabsService#mayLaunchUrl был сделан @Nullable .

Версия 1.2.0

Версия 1.2.0

18 декабря 2019 г.

androidx.browser:browser:1.2.0 выпущен без изменений с 1.2.0-rc01 . Версия 1.2.0 содержит эти коммиты .

Основные изменения по сравнению с версией 1.0.0

  • Доверенные веб-активности
    • Поддержка Trusted Web Activity теперь стабильна.
    • TrustedWebActivityIntentBuilder можно использовать для настройки и создания TrustedWebActivityIntent для запуска Trusted Web Activity.
    • Службу TrustedWebActivityService можно включить или расширить, чтобы позволить клиентам отображать push-уведомления, передаваемые им браузером.
    • TrustedWebActivityServiceConnectionPool может использоваться браузерами для подключения к TrustedWebActivityService s в клиентах. TrustedWebActivityServiceConnection представляет такое подключение.
    • Доверенные веб-действия могут быть запущены для предоставления информации целевому ресурсу Web Share.
  • Темная тема
    • Разработчики могут предоставить (через CustomTabColorSchemeParams ) различные цвета темы, которые будут использоваться, когда устройство находится в светлом или темном режиме.
    • Разработчики могут запросить, чтобы браузер работал в светлом или темном режиме.
  • Возобновление сеанса
    • CustomTabsSession можно создавать с идентификатором, что позволяет объединять последующие запуски пользовательских вкладок с одного и того же клиента и идентификатора.
  • Цвет панели навигации можно указать для пользовательских вкладок.
  • Классы, связанные с действиями браузера, помечены как устаревшие из-за невероятно низкого использования функций и будут удалены в будущей версии библиотеки.

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

  • Исправлено форматирование Javadoc для примеров кода.

Версия 1.2.0-beta01

20 ноября 2019 г.

androidx.browser:browser:1.2.0-beta01 выпущен без изменений с 1.2.0-alpha09 . Версия 1.2.0-beta01 содержит эти коммиты .

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

23 октября 2019 г.

Выпущен androidx.browser:browser:1.2.0-alpha09 . Версия 1.2.0-alpha09 содержит эти коммиты .

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

  • Класс Token может использоваться для представления идентификатора пакета; он содержит как имя пакета, так и подпись сертификата подписи пакета.
    • Он предназначен для сериализации в byte[] для сохранения.
    • Он используется TrustedWebActivityService для определения того, какому поставщику TWA разрешено к нему подключаться.
    • Он используется TrustedWebActivityConnectionPool поставщиком TWA для определения того, к каким пакетам можно подключаться.
  • Интерфейс TokenStore теперь используется TrustedWebActivityService для определения того, какому приложению разрешено к нему подключаться.
    • Клиент должен сам вызывать TokenStore#store , TrustedWebActivityService только загружает токены.
  • TrustedWebActivityServiceConnectionPool (ранее TrustedWebActivityServiceConnectionManager) больше не хранит набор проверенных пакетов:
    • registerClient и getVerifiedPackages теперь удалены.
    • Коллекция проверенных пакетов теперь предоставляется вручную для execute (ранее connect ) и serviceExistsForScope .
  • TrustedWebActivityService делегирует переопределяющему классу полномочия по сохранению проверенного поставщика.
    • setVerifiedProvider был удален.
    • Клиент должен реализовать getTokenStore , который возвращает TokenStore , который можно использовать для хранения и извлечения Token .

Изменения API

  • Класс TrustedWebActivityServiceConnectionManager :
    • Теперь называется TrustedWebActivityServiceConnectionPool .
    • Теперь это окончательно.
    • Создается статическим методом create вместо открытого конструктора.
  • Класс TrustedWebActivityService :
    • Имеет аннотации потоков для переопределяемых методов.
  • Класс TrustedWebActivityServiceWrapper :
    • Теперь называется TrustedWebActivityServiceConnection .
    • Теперь это окончательно.
    • Теперь выдает необработанные RemoteExceptions вместо того, чтобы оборачивать их в RuntimeExceptions.
  • Класс ShareTarget#FileFormField теперь является окончательным.
  • Метод TrustedWebUtils#splashScreensAreSupported переименован в areSplashScreensSupported .
  • Метод TrustedWebActivityIntentBuilder#getUrl переименован в TrustedWebActivityIntentBuilder#getUri .
  • Статические поля SplashScreenParamKey имеют префикс KEY_ .

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

18 сентября 2019 г.

Выпущен androidx.browser:browser:1.2.0-alpha08 . Версия 1.2.0-alpha08 содержит эти коммиты .

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

  • Представлены новые API Share Target для Trusted Web Activities. Приложения, использующие Trusted Web Activities, теперь могут отправлять данные в свой Web Share Target, определенный протоколом https://wicg.github.io/web-share-target/level-2/ ( aosp/I47b93 , aosp/I0ec3e )

Изменения API

  • Добавлен обратный вызов extraCallbackWithResult в ICustomTabsCallback ( aosp/Ic2cc2 )
  • Некоторые параметры метода CustomTabsSession помечены как Nullable или NonNull ( aosp/Iec460 )
  • TrustedWebActivityIntentBuilder теперь создает TrustedWebActivityIntent вместо необработанного намерения ( aosp/I03fb6 )

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

  • CustomTabsClient теперь при необходимости использует устаревший requestPostMessageChannel ( aosp/Ibb324 )
  • Исправлен CustomTabsSessionToken#equals ( aosp/I7f249 )
  • CustomTabsClient теперь использует устаревший newSession если это возможно ( aosp/Ie27dc )

Внешний вклад

  • Проверка API lint для MinMaxConstant включена для androidx ( aosp/I29b78 ) ( b/138602561 )

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

7 августа 2019 г.

Выпущен androidx.browser:browser:1.2.0-alpha07 . Коммиты, включенные в эту версию, можно найти здесь .

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

  • Темная тема

    • Разработчики могут предоставить цвета темы, которые будут использоваться, когда устройство находится в темном режиме.
    • Разработчики также могут переопределить, должен ли запущенный браузер работать в темном или светлом режиме.
    • Цвет панели навигации можно указать для пользовательских вкладок.
  • Доверенные веб-активности

    • TrustedWebActivityBuilder можно использовать для простого создания и запуска Trusted Web Activities .
    • TrustedWebActivityService и связанные с ним классы могут использоваться для связи с провайдером — приема push-уведомлений для связанного веб-сайта и отображения их из клиентского приложения. Эта часть API может измениться.
  • Идентификаторы сеансов пользовательских вкладок

    • Сеансы пользовательских вкладок теперь можно создавать с идентификаторами, что позволяет объединять два сеанса, запущенных одним и тем же приложением с одним и тем же идентификатором.

Изменения API

  • Классы и методы, связанные с Browser Actions, были помечены как устаревшие. К сожалению, хотя мы возлагали большие надежды на эту функцию, в итоге ее почти никто не использовал, и только один браузер в итоге предоставил ее поддержку. Мы объявляем ее устаревшей, чтобы сохранить простоту кода и API.

Версия 1.0.0

Версия 1.0.0

21 сентября 2018 г.

Выпущен браузер 1.0.0.