Браузер

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

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

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

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

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 ).

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

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

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

Браузер

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

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

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

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

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 ).

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

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

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

Браузер

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

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

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

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

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 ).

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

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

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

Браузер

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

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

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

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

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 ).

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

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

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