浏览器

最新更新时间 当前稳定版 下一候选版本 Beta 版 Alpha 版
2020 年 1 月 8 日 1.2.0 - - 1.3.0-alpha01

声明依赖项

如需添加 Browser 的依赖项,您必须将 Google Maven 代码库添加到项目中。如需了解详情,请参阅 Google 的 Maven 代码库

在应用或模块的 build.gradle 文件中添加所需工件的依赖项:

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

如需详细了解依赖项,请参阅添加构建依赖项

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库的改进有自己的见解,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击加注星标按钮,为现有问题投票。

创建新问题

如需了解详情,请参阅问题跟踪器文档

版本 1.3.0

版本 1.3.0-alpha01

2020 年 1 月 8 日

发布了 androidx.browser:browser:1.3.0-alpha01版本 1.3.0-alpha01 中包含以下提交内容

新功能

  • 通过调用 TrustedWebActivityServiceConnection#extraCommand,自由格式命令可从浏览器传递到 Trusted Web Activity 客户端。该客户端可以在 TrustedWebActivityService#onExtraCommand 中处理这些命令。

API 变更

  • 提供给 CustomTabsSession#mayLauncherUrl 并在 CustomTabsService#mayLaunchUrl 中收到的网址已设为 @Nullable

版本 1.2.0

版本 1.2.0

2019 年 12 月 18 日

发布了 androidx.browser:browser:1.2.0,该版本与 1.2.0-rc01 相比没有变化。版本 1.2.0 中包含以下提交内容

自 1.0.0 以来的重要变更

  • Trusted Web Activity
    • Trusted Web Activity 的支持现在很稳定。
    • TrustedWebActivityIntentBuilder 可用于自定义和创建 TrustedWebActivityIntent,以启动 Trusted Web Activity。
    • 您可以添加或扩展 TrustedWebActivityService,以允许客户端显示浏览器向其发送的网络推送通知。
    • 浏览器可使用 TrustedWebActivityServiceConnectionPool 连接到客户端中的 TrustedWebActivityServiceTrustedWebActivityServiceConnection 表示此类连接。
    • 可以启动 Trusted Web Activity,并向 Web Share Target 提供信息。
  • 深色主题
    • 开发者可以(通过 CustomTabColorSchemeParams)提供要在设备处于光亮模式或深色模式时使用的不同主题背景颜色。
    • 开发者可以要求浏览器本身处于光亮模式或深色模式。
  • 会话恢复
    • 可以创建带有 ID 的 CustomTabsSession,这样能够合并从同一客户端和 ID 启动的后续自定义标签页。
  • 可以为“自定义标签页”指定导航栏颜色。
  • 浏览器操作相关类由于功能使用率极低而被标记为“已弃用”,并将从未来版本的库中删除。

版本 1.2.0-rc01

2019 年 12 月 4 日

发布了 androidx.browser:browser:1.2.0-rc01版本 1.2.0-rc01 中包含以下提交内容

问题修复

  • 修复了代码示例的 Javadoc 格式。

版本 1.2.0-beta01

2019 年 11 月 20 日

发布了 androidx.browser:browser:1.2.0-beta01,该版本与 1.2.0-alpha09 相比没有变化。版本 1.2.0-beta01 中包含这些提交内容

版本 1.2.0-alpha09

2019 年 10 月 23 日

发布了 androidx.browser:browser:1.2.0-alpha09版本 1.2.0-alpha09 中包含这些提交内容

新功能

  • Token 类可用于表示软件包的标识,其中包含软件包名称和软件包签名证书的签名。
    • 它旨在序列化为 byte[] 以保持持久性。
    • TrustedWebActivityService 使用它来确定允许哪种 TWA 提供程序与其连接。
    • TrustedWebActivityConnectionPool(根据 TWA 提供程序)使用它来确定连接到哪些软件包是有效的配置。
  • TrustedWebActivityService 现在使用 TokenStore 接口来确定允许哪个应用与其连接。
    • 由客户端来调用 TokenStore#storeTrustedWebActivityService 仅加载令牌。
  • TrustedWebActivityServiceConnectionPool(之前为 TrustedWebActivityServiceConnectionManager)不再存储一组经过验证的软件包:
    • 现已移除 registerClientgetVerifiedPackages
    • 现在,向 execute(之前为 connect)和 serviceExistsForScope 手动提供经过验证的软件包集合。
  • TrustedWebActivityService 委托给替换类来存储经过验证的提供程序。
    • 已移除 setVerifiedProvider
    • 客户端必须实现 getTokenStore,它会返回可用于存储和检索 TokenTokenStore

API 变更

  • TrustedWebActivityServiceConnectionManager 类:
    • 现在称为 TrustedWebActivityServiceConnectionPool
    • 现已最终确定。
    • 由静态 create 方法而不是公共构造函数构造而成。
  • TrustedWebActivityService 类:
    • 包含可替换方法的线程注释。
  • TrustedWebActivityServiceWrapper 类:
    • 现在称为 TrustedWebActivityServiceConnection
    • 现已最终确定。
    • 现在抛出原始的 RemoteException,而不是将它们封装在 RuntimeException 中。
  • ShareTarget#FileFormField 类现已最终确定。
  • TrustedWebUtils#splashScreensAreSupported 方法已重命名为 areSplashScreensSupported
  • TrustedWebActivityIntentBuilder#getUrl 方法已重命名为 TrustedWebActivityIntentBuilder#getUri
  • SplashScreenParamKey 静态字段已添加前缀 KEY_

版本 1.2.0-alpha08

2019 年 9 月 18 日

发布了 androidx.browser:browser:1.2.0-alpha08版本 1.2.0-alpha08 中包含这些提交内容

新功能

  • 引入了适用于 Trusted Web Activity 的新 Share Target API。使用 Trusted Web Activity 的应用现在可以将数据发送到它们的 Web Share Target(由协议 https://wicg.github.io/web-share-target/level-2/ 定义)(aosp/I47b93aosp/I0ec3e

API 变更

  • extraCallbackWithResult 回调添加到 ICustomTabsCallback 中 (aosp/Ic2cc2)
  • 将一些 CustomTabsSession 方法参数标记为 Nullable 或 NonNull (aosp/Iec460)
  • TrustedWebActivityIntentBuilder 现在会构建 TrustedWebActivityIntent 而不是原始 Intent (aosp/I03fb6)

问题修复

  • CustomTabsClient 现在可根据需要使用旧版 requestPostMessageChannel (aosp/Ibb324)
  • 修复了 CustomTabsSessionToken#equals (aosp/I7f249)
  • 如有可能,CustomTabsClient 现在使用旧版 newSession (aosp/Ie27dc)

外部贡献

版本 1.2.0-alpha07

2019 年 8 月 7 日

发布了 androidx.browser:browser:1.2.0-alpha07。点击此处可查看此版本中包含的提交。

新功能

  • 深色主题

    • 开发者可以提供在设备处于深色模式时使用的主题背景颜色。
    • 开发者还可以替换启动的浏览器应处于深色模式还是光亮模式。
    • 可以为“自定义标签”指定导航栏颜色。
  • Trusted Web Activity

    • TrustedWebActivityBuilder 可用于轻松创建和启动 Trusted Web Activity
    • TrustedWebActivityService 及相关类可用于与提供程序进行通信 - 接受关联网站的网络推送通知,并从客户端应用显示这些通知。这一部分 API 可能会发生更改。
  • 自定义标签会话 ID

    • 现在可以创建带有 ID 的自定义标签会话,从而允许合并由具有相同 ID 的应用启动的会话。

API 变更

  • 与浏览器操作相关的类和方法已标记为已弃用。遗憾的是,尽管我们对该功能抱有很大的期望,但最终几乎没有人使用它,并且最终只有一个浏览器提供对该功能的支持。我们在弃用该功能,以简化代码和 API。

版本 1.0.0

版本 1.0.0

2018 年 9 月 21 日

发布了 browser-1.0.0。