Браузер

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

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

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

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

Groovy

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

Kotlin

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

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

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

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

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

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

Версия 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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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-бета02

7 февраля 2024 г.

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

Изменения API

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

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

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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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-бета01

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-бета01

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-бета01

28 октября 2020 г.

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

Изменения API

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

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

  • Проверка API для 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 для 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 . Параметр пакета теперь помечен как @NonNull вместо @Nullable . ( I64dbb )
  • Метод TrustedWebActivityServiceConnection.extraCommand переименован в sendExtraCommand ( Id29a8 ).
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() устарел в пользу нового #setDefaultShareMenuItemEnabled(boolean) и CustomTabsIntent.Builder#enableUrlBarHiding() устарел в пользу нового #setUrlBarHidingEnabled(boolean) . ( Иад702 )

Версия 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

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

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

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

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

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 .
    • Теперь окончательно.
    • Теперь выдает необработанные исключения RemoteException вместо того, чтобы оборачивать их в 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 для доверенных веб-действий. Приложения, использующие доверенные веб-действия, теперь могут отправлять данные в свою цель веб-ресурса, определенную протоколом 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 ).

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

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

7 августа 2019 г.

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

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

  • Темная тема

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

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

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

Изменения API

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

Версия 1.0.0

Версия 1.0.0

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

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

,

Браузер

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

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

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

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

Groovy

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

Kotlin

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

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

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

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

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

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

Версия 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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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-бета02

7 февраля 2024 г.

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

Изменения API

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

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

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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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-бета01

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-бета01

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-бета01

28 октября 2020 г.

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

Изменения API

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

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

  • Проверка API для 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 для 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 . Параметр пакета теперь помечен как @NonNull вместо @Nullable . ( I64dbb )
  • Метод TrustedWebActivityServiceConnection.extraCommand переименован в sendExtraCommand ( Id29a8 ).
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() устарел в пользу нового #setDefaultShareMenuItemEnabled(boolean) и CustomTabsIntent.Builder#enableUrlBarHiding() устарел в пользу нового #setUrlBarHidingEnabled(boolean) . ( Иад702 )

Версия 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

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

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

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

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

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 .
    • Теперь окончательно.
    • Теперь выдает необработанные исключения RemoteException вместо того, чтобы оборачивать их в 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 для доверенных веб-действий. Приложения, использующие доверенные веб-действия, теперь могут отправлять данные в свою цель веб-ресурса, определенную протоколом 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 ).

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

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

7 августа 2019 г.

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

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

  • Темная тема

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

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

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

Изменения API

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

Версия 1.0.0

Версия 1.0.0

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

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

,

Браузер

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

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

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

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

Groovy

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

Kotlin

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

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

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

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

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

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

Версия 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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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-бета02

7 февраля 2024 г.

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

Изменения API

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

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

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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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-бета01

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-бета01

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-бета01

28 октября 2020 г.

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

Изменения API

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

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

  • Проверка API для 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 для 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 . Параметр пакета теперь помечен как @NonNull вместо @Nullable . ( I64dbb )
  • Метод TrustedWebActivityServiceConnection.extraCommand переименован в sendExtraCommand ( Id29a8 ).
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() устарел в пользу нового #setDefaultShareMenuItemEnabled(boolean) и CustomTabsIntent.Builder#enableUrlBarHiding() устарел в пользу нового #setUrlBarHidingEnabled(boolean) . ( Иад702 )

Версия 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

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

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

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

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

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 .
    • Теперь окончательно.
    • Теперь выдает необработанные исключения RemoteException вместо того, чтобы оборачивать их в 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 для доверенных веб-действий. Приложения, использующие доверенные веб-действия, теперь могут отправлять данные в свою цель веб-ресурса, определенную протоколом 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 ).

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

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

7 августа 2019 г.

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

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

  • Темная тема

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

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

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

Изменения API

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

Версия 1.0.0

Версия 1.0.0

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

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

,

Браузер

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

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

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

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

Groovy

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

Kotlin

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

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

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

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

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

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

Версия 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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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-бета02

7 февраля 2024 г.

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

Изменения API

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

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

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 )
  • В интерфейс CustomTabsCallback добавлен метод обратного вызова onActivityLayout , позволяющий разработчикам знать координаты области, занимаемой настраиваемой вкладкой, и состояние, в котором она отображается. Это будет вызываться при первом отображении пользовательской вкладки на экране и каждый раз при изменении занимаемой площади. ( 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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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 , определяющий целевой язык, на котором должен запускаться пользовательский интерфейс Translate. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setBackgroundInteractionEnabled , который обеспечивает взаимодействие с фоновым приложением при запуске частичной настраиваемой вкладки. ( Ia792e )
  • Добавлен CustomTabsIntent.Builder#setShareIdentityEnabled , который позволяет настраиваемым вкладкам получать идентификационные данные вызывающего абонента. ( 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-бета01

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-бета01

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-бета01

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-бета01

28 октября 2020 г.

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

Изменения API

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

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

  • Проверка API для 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 для 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 . Параметр пакета теперь помечен как @NonNull вместо @Nullable . ( I64dbb )
  • Метод TrustedWebActivityServiceConnection.extraCommand переименован в sendExtraCommand ( Id29a8 ).
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() устарел в пользу нового #setDefaultShareMenuItemEnabled(boolean) и CustomTabsIntent.Builder#enableUrlBarHiding() устарел в пользу нового #setUrlBarHidingEnabled(boolean) . ( Иад702 )

Версия 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

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

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

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

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

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 .
    • Теперь окончательно.
    • Теперь выдает необработанные исключения RemoteException вместо того, чтобы оборачивать их в 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 для доверенных веб-действий. Приложения, использующие доверенные веб-действия, теперь могут отправлять данные в свою цель веб-ресурса, определенную протоколом 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 ).

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

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

7 августа 2019 г.

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

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

  • Темная тема

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

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

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

Изменения API

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

Версия 1.0.0

Версия 1.0.0

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

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