Браузер

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

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

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

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

классный 

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

Котлин

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

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

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

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

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

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

Версия 1.9

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

29 января 2025 г.

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

Изменения API

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

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

  • Обновлена ​​Javaдокументация AuthTabIntent ( I2490c ).
  • Исправлена ​​поддержка сеансов на вкладке Auth ( I4e280 ).
  • Эта библиотека теперь использует аннотации NULL JSpecify , которые являются типизированными. Разработчики Kotlin должны использовать следующие аргументы компилятора для обеспечения правильного использования: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode ( Ic7bf5 , b/326456246 )
  • Убрано ручное определение доступа к API новой платформы, поскольку это происходит автоматически посредством моделирования API при использовании R8 с AGP 7.3 или новее (например, R8 версии 3.3) и для всех сборок при использовании AGP 8.1 или новее (например, D8 версии 8.1). Клиентам, не использующим AGP, рекомендуется выполнить обновление до D8 версии 8.1 или более поздней. Более подробную информацию можно найти в этой статье . ( I9496c , б/345472586 )

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

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

Версия 1.8

Версия 1.8.0

6 марта 2024 г.

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

Важные изменения с версии 1.7.0

  • Добавлен CustomTabsIntent.Builder#setInitialActivityWidthPx , который позволяет разработчикам указывать начальную ширину запуска пользовательской вкладки. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetPosition , который позволяет разработчикам указывать положение пользовательской вкладки, когда она выступает в качестве бокового листа. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetDecorationType , который позволяет разработчикам указывать тип оформления пользовательской вкладки, когда она действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition , который позволяет разработчикам указывать положение закругленных углов, когда пользовательская вкладка действует как боковой лист. ( I443f6 )
  • Добавлен CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled , который позволяет разработчикам включать или отключать кнопку максимизации, когда пользовательская вкладка действует как боковой лист. ( Ie3564 )
  • В интерфейс 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 )
    • В методы TrustedWebActivityIntentBuilder добавлены @IntDef , использующие цветовую схему.

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

24 июня 2020 г.

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

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

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

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

10 июня 2020 г.

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

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

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

Изменения API

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

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

8 января 2020 г.

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

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

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

Изменения API

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

Версия 1.2.0

Версия 1.2.0

18 декабря 2019 г.

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

Основные изменения с версии 1.0.0

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

Версия 1.2.0-rc01

4 декабря 2019 г.

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

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

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

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

20 ноября 2019 г.

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

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

23 октября 2019 г.

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

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

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

Изменения API

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

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

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

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

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

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

Изменения API

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

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

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

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

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

7 августа 2019 г.

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

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

  • Темная тема

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

  • Доверенные веб-действия

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

  • Идентификаторы сеансов пользовательских вкладок

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

Изменения API

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

Версия 1.0.0

Версия 1.0.0

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

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