Browser

在使用者的預設瀏覽器中顯示網頁。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 3 月 6 日 1.8.0 - - -

宣告依附元件

如要在瀏覽器上新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.8 版

1.8.0 版

2024 年 3 月 6 日

發布 androidx.browser:browser:1.8.0。1.8.0 版包含這些修訂版本。

自 1.7.0 版以來的重要變更

  • 新增 CustomTabsIntent.Builder#setInitialActivityWidthPx，以便開發人員指定「Custom」分頁的初始啟動寬度。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetPosition，讓開發人員在做為側邊面板時，指定「Custom」分頁的位置。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetDecorationType，讓開發人員在自訂分頁做為側邊面板時，指定裝飾類型。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition，讓開發人員在自訂分頁做為側邊資訊列時，指定圓角的位置。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled，讓開發人員在自訂分頁做為側邊資訊卡時，啟用或停用最大化按鈕。(Ie3564)。
  • 在介面 CustomTabsCallback 中加入 onActivityLayout 回呼方法，讓開發人員知道「Custom」分頁所佔據區域的座標，以及顯示的狀態。每次畫面上首次顯示「自訂分頁」，以及每次所在的區域變更時，系統就會呼叫此方法。(I443f6)。
  • 在介面 CustomTabsCallback 中新增 onWarmupCompleted 回呼方法，讓開發人員知道何時 CustomTabsClient#warmupfinishes 正在暖化瀏覽器程序。(I107cf)。
  • 已在 CustomTabsSession#setEngagementSignalsCallback 和 CustomTabsSession#isEngagementSignalsApiAvailable 中的額外項目中新增工作階段 ID。(Iba7f1)
  • 新增對「Minimized Custom Tabs」API 的實驗性支援。(I67f2d)。

1.8.0-rc01 版

2024 年 2 月 21 日

發布 androidx.browser:browser:1.8.0-rc01，且自 1.8.0-beta02 版以來皆無變更。1.8.0-rc01 版包含以下修訂項目。

1.8.0-beta02 版

2024 年 2 月 7 日

發布 androidx.browser:browser:1.8.0-beta02。1.8.0-beta02 版包含以下修訂項目。

API 變更

  • 已將 CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization 重新命名為 CustomTabsIntent Builder#setActivitySideSheetMaximizationEnabled，並將其設為公開 API。開發人員可在自訂分頁做為側邊面板時，啟用或停用最大化按鈕。(Ie3564)。

1.8.0-beta01 版

2023 年 11 月 29 日

發布 androidx.browser:browser:1.8.0-beta01。1.8.0-beta01 版包含以下修訂項目。

新功能

  • 新增實驗性功能，支援最小化自訂分頁 API。(I67f2d)。

1.8.0-alpha01 版

2023 年 11 月 15 日

發布 androidx.browser:browser:1.8.0-alpha01。1.8.0-alpha01 版包含以下修訂項目。

新功能

  • 新增了 CustomTabsIntent.Builder#setInitialActivityWidthPx，可讓開發人員指定自訂分頁的初始啟動寬度。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp，可讓開發人員指定自訂分頁視窗的最小寬度，以便做為側邊工作表使用。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetPosition，讓開發人員在做為側邊資訊頁時，指定「Custom」分頁的位置。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization，讓開發人員在自訂分頁做為側邊資訊卡時，啟用或停用最大化按鈕。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetDecorationType，讓開發人員在自訂分頁做為側邊面板時，指定裝飾類型。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition，讓開發人員在自訂分頁做為側邊資訊列時，指定圓角的位置。(I443f6)。
  • 在介面 CustomTabsCallback 中加入 onActivityLayout 回呼方法，讓開發人員知道「Custom」分頁所占據區域的座標，以及顯示的狀態。系統會在自訂分頁首次顯示在畫面上，以及每次佔用區域變更時呼叫此方法。(I443f6)。
  • 在介面 CustomTabsCallback 中新增 onWarmupCompleted 回呼方法，讓開發人員知道CustomTabsClient#warmup何時完成瀏覽器程序暖機(I107cf)。

修正錯誤

  • 已將工作階段 ID 新增至 CustomTabsSession#setEngagementSignalsCallback 和 CustomTabsSession#isEngagementSignalsApiAvailable 中的額外資料。(Iba7f1)

1.7 版

1.7.0 版

2023 年 11 月 15 日

發布 androidx.browser:browser:1.7.0。1.7.0 版包含以下修訂項目。

自 1.6.0 版以來的重要變更

  • 新增 CustomTabsIntent.Builder#setBookmarksButtonEnabled，啟用溢位選單中的書籤按鈕。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setDownloadButtonEnabled，可在溢位選單中啟用下載按鈕。(Ia792e)。
  • 新增了 CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled，允許將初始網址傳送至外部處理常式應用程式。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setTranslateLanguage，用於指定 Translate UI 應以哪種語言觸發。(Ia792e)。
  • 新增了 CustomTabsIntent.Builder#setBackgroundInteractionEnabled，可在啟動部分「Custom」分頁時與背景應用程式互動。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setShareIdentityEnabled，讓自訂分頁取得呼叫者的身分。(I7bf2b)。
  • 新增 CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture，設定在使用者從底部工具列向上滑動時傳送 PendingIntent。(Id42a2)。

1.7.0-rc01 版

2023 年 11 月 1 日

androidx.browser:browser:1.7.0-rc01 發布，內容無變更。1.7.0-rc01 版包含以下修訂項目。

  • 自 alpha-01 版以來沒有任何異動

1.7.0-beta01 版

2023 年 10 月 18 日

androidx.browser:browser:1.7.0-beta01 發布，內容無變更。1.7.0-beta01 版包含以下修訂項目。

1.7.0-alpha01 版

2023 年 10 月 4 日

發布 androidx.browser:browser:1.7.0-alpha01。1.7.0-alpha01 版包含以下修訂項目。

新功能

  • 新增 CustomTabsIntent.Builder#setBookmarksButtonEnabled，啟用溢位選單中的書籤按鈕。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setDownloadButtonEnabled，可在溢位選單中啟用下載按鈕。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setSendToExtraDefaultHandlerEnabled，可將初始網址傳送至外部處理常式應用程式。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setTranslateLanguage，指定要用於觸發翻譯 UI 的指定語言。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setBackgroundInteractionEnabled，可在啟動部分自訂分頁時與背景應用程式互動。(Ia792e)。
  • 新增 CustomTabsIntent.Builder#setShareIdentityEnabled，讓自訂分頁取得呼叫者的身分。(I7bf2b)
  • 新增 CustomTabsIntent.Builder#setSecondaryToolbarSwipeUpGesture，設定在使用者從底部工具列向上滑動時傳送 PendingIntent。(Id42a2)。

1.6 版本

1.6.0 版

2023 年 8 月 9 日

發布了 androidx.browser:browser:1.6.0，且自 1.6.0-rc01 以來皆無異動。1.6.0 版包含以下修訂項目。

1.6.0-rc01 版

2023 年 7 月 26 日

發布了 androidx.browser:browser:1.6.0-rc01，且自 1.6.0-beta01 版以來皆無異動。1.6.0-rc01 版包含以下修訂項目。

1.6.0-beta01 版

2023 年 6 月 21 日

發布 androidx.browser:browser:1.6.0-beta01，且自 1.6.0-alpha02 版以來皆無異動。1.6.0-beta01 版包含以下修訂項目。

1.6.0-alpha02 版本

2023 年 6 月 7 日

發布 androidx.browser:browser:1.6.0-alpha02。1.6.0-alpha02 版包含以下修訂項目。

API 變更

  • 已移除 CustomTabsSession#getGreatestScrollPercentage。(I6c5ba)
  • 新增 requestPostMessageChannel API，可用於指定目標來源。也就是說，使用者可能確定訊息只會傳送至他們預期的網站。(Id5b7f)

修正錯誤

  • 已更新 EngagementSignalsCallback 說明文件。(Ie833c)

1.6.0-alpha01 版本

2023 年 5 月 3 日

發布 androidx.browser:browser:1.6.0-alpha01。1.6.0-alpha01 版包含這些修訂項目。

新功能

  • 新增了 Engagement Signals API，讓開發人員能接收使用者在網頁中互動 (例如捲動) 的回呼。(I835e6)

API 變更

  • 更新 Engagement Signals API ，簡化自訂分頁導入端的 API 介面。(Iaa6dc)。

1.5 版本

1.5.0 版

2023 年 2 月 8 日

發布 androidx.browser:browser:1.5.0。1.5.0 版包含此連結所列的修訂項目。

自 1.4.0 版以來的重要異動

  • 新增 CustomTabsIntent.Builder#setInitialActivityHeightPx，以便開發人員指定「Custom」分頁的初始啟動高度，並視需要指定調整大小行為 (固定或可調整大小) (I48bd3)
  • 新增了 CustomTabsIntent.Builder#setToolbarCornerRadiusDp，以便開發人員指定工具列的上圓角半徑。(I48bd3)
  • 新增了 CustomTabsIntent.Builder#setCloseButtonPosition，以便開發人員設定工具列上的關閉按鈕位置。(I48bd3)
  • 在介面 CustomTabsCallback 中加入 onActivityResized 回呼方法，讓開發人員知道何時要調整「Custom」分頁的大小 (Ic864e)。
  • 讓部分 CustomTabsCallback API 非同步。(Ic86df)
  • 讓系統預設填入 Accept-Language 中目前應用程式的語言，藉此與每個 Android 應用程式的語言體驗保持一致 (I3d1d7)。
  • 將 @RequiresPermission 加入需要為 SDK 33 以上版本授予 POST_NOTIFICATIONS 權限的 API。這是在內部分支版本中開發而成。如需參考，請參閱 b/238790278。

1.5.0-rc01 版

2023 年 1 月 25 日

發布了 androidx.browser:browser:1.5.0-rc01。1.5.0-rc01 版包含此連結所列的修訂項目。

  • 自 1.5.0-beta01 以來沒有變更

1.5.0-beta01 版

2023 年 1 月 11 日

發布 androidx.browser:browser:1.5.0-beta01。1.5.0-beta01 版包含此連結所列的修訂項目。

  • 自 1.5.0-alpha02 以來沒有任何異動

1.5.0-alpha02 版

2022 年 12 月 7 日

發布了 androidx.browser:browser:1.5.0-alpha02。1.5.0-alpha02 版包含此連結所列的修訂項目。

API 變更

  • 已變更 CustomTabsCallback#onActivityResized 行為並新增新參數。
  • EXTRA_ACTIVITY_RESIZE_BEHAVIOR 已重新命名為 EXTRA_ACTIVITY_RESIZE_HEIGHT_BEHAVIOR，以更能反映其為特定高度。(Ic864e)
  • 讓部分 CustomTabsCallback API 非同步。(Ic86df)

1.5.0-alpha01 版

2022 年 10 月 24 日

發布 androidx.browser:browser:1.5.0-alpha01。1.5.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 新增了 CustomTabsIntent.Builder#setInitialActivityHeightPx，以便開發人員指定「Custom」分頁的初始啟動高度，並視需要指定調整大小行為 (固定或調整大小)。(I48bd3)
  • 新增了 CustomTabsIntent.Builder#setToolbarCornerRadiusDp，以便開發人員指定工具列的上圓角半徑。(I48bd3)
  • 新增了 CustomTabsIntent.Builder#setCloseButtonPosition，以便開發人員設定工具列上的關閉按鈕位置。(I48bd3)
  • 新增了 CustomTabsCallback 介面的 onActivityResized 回呼方法，以便開發人員知道何時調整「Custom」分頁的大小 (展開至完整高度或最小化至初始啟動高度)。(Id99ce)
  • 根據預設，填入在 Accept-Language 中目前應用程式的語言，以符合 Android 每個應用程式的語言體驗。(I3d1d7)

API 變更

  • 將 @RequiresPermission 新增至需要為 SDK 33 以上版授予 POST_NOTIFICATIONS 權限的 API。這是在內部分支版本中開發而成。如需參考，請參閱 b/238790278。

1.4.0 版

1.4.0 版

2021 年 11 月 3 日

發布了 androidx.browser:browser:1.4.0。1.4.0 版包含此連結所列的修訂項目。

自 1.3.0 版之後的重要變更

  • 將 PendingIntent 標示為 PendingIntent.FLAG_IMMUTABLE (與 Android 12 相容)。

1.4.0-rc01 版

2021年10月13日

androidx.browser:browser:1.4.0-rc01 自 1.4.0-beta01 版起沒有任何變更。1.4.0-rc01 版包含此連結所列的修訂項目。

1.4.0-beta01 版

2021 年 9 月 29 日

androidx.browser:browser:1.4.0-beta01 自 1.4.0-alpha01起沒有變更。1.4.0-beta01 版包含此連結所列的修訂項目。

1.4.0-alpha01 版

2021 年 9 月 15 日

發布了 androidx.browser:browser:1.4.0-alpha01。1.4.0-alpha01 版包含此連結所列的修訂項目。

修正錯誤

  • 將 PendingIntent 標示為 PendingIntent.FLAG_IMMUTABLE，以便與 Android 12 相容。

1.3.0 版

1.3.0 版

2020 年 12 月 2 日

發布了 androidx.browser:browser:1.3.0。1.3.0 版包含此連結所列的修訂項目。

自 1.2.0 版以來的主要功能

  • 您可以透過呼叫 TrustedWebActivityServiceConnection#sendExtraCommand 從瀏覽器將任意形式指令傳送至信任的網路活動用戶端。用戶端可在 TrustedWebActivityService#onExtraCommand 中處理這些作業
  • 新增 TrustedWebActivityCallback 介面，可供信任的網路活動用戶端用來將資料傳回瀏覽器。
  • 新增 CustomTabsIntent#setShareState，可讓開發人員指定是否要顯示共用選項 (或讓瀏覽器不要顯示這個分享選項)。
  • 開發人員現在可以在 TrustedWebActivityIntentBuilder 中，使用 setScreenOrientation 方法設定預設螢幕方向
  • 系統會將 setNavigationBarDividerColor 方法新增至 CustomTabColorSchemeParams，以變更導覽列分隔線的顏色。
  • 已新增 CustomTabsIntent.Builder#setDefaultColorSchemeParams 以取代現已淘汰的 #setNavigationBarColor、#setNavigationBarDividerColor、#setToolbarColor 和 #setSecondaryToolbarColor 方法
  • 已新增 CustomTabsClient#bindCustomTabsServicePreservePriority 方法，允許不使用 Context.BIND_WAIVE_PRIORITY 旗標而連線至自訂分頁服務。

1.3.0-rc01 版

2020 年 11 月 11 日

androidx.browser:browser:1.3.0-rc01 自 1.3.0-beta01起沒有變更。1.3.0-rc01 版包含此連結所列的修訂項目。

1.3.0-beta01 版

2020 年 10 月 28 日

發布了 androidx.browser:browser:1.3.0-beta01。1.3.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 已將 bindCustomTabServicePreservePriority 重新命名為 bindCustomTabsServicePreservePriority (I29ac1)

修正錯誤

  • 為 AndroidX 啟用 MissingGetterMatchingBuilder 的 API Lint 檢查功能 (I4bbea、b/138602561)

1.3.0-alpha06 版

2020 年 10 月 1 日

發布了 androidx.browser:browser:1.3.0-alpha06。1.3.0-alpha06 版包含此連結所列的修訂項目。

新功能

  • 新增 CustomTabsIntent#setShareState，方便開發人員將共用狀態設為啟用、已停用或保留在瀏覽器中。(I153fe)
  • 新增 CustomTabsIntent.Builder#setDefaultColorSchemeParams，用來取代目前已淘汰的 #setNavigationBarColor、#setBrowsingBarDividerColor、#setToolbarColor、#setsecondaryToolbarColor 方法。(I09012)

API 變更

  • Staticx 已啟用的 StaticFinalBuilder API 精簡版檢查 (I2b11b、b/138602561)
  • 新增 CustomTabsService#KEY_SUCCESS 和 TrustedWebActivityService#KEY_SUCCESS，用來表示 additionalCommand 成功。(I6f7b5)

1.3.0-alpha05 版

2020 年 8 月 5 日

發布了 androidx.browser:browser:1.3.0-alpha05。1.3.0-alpha05 版包含此連結所列的修訂項目。

新功能

  • 允許設定已啟動的「Trusted Web Activities」的方向。
  • 允許設定「Trusted Web Activities」和「Custom」分頁的導覽列分隔線顏色。

API 變更

  • 在 TrustedWebActivityIntentBuilder 中新增了 setScreenOrientation 方法。
  • 已新增 ScreenOrientation.LockType 的 @IntDef，代表鎖定類型 (I802d2)
  • 已將 setNavigationBarDividerColor 方法新增至 TrustedWebActivityIntentBuilder 和 CustomTabColorSchemeParams。(Ia04dd)
    • 新增@IntDefs到TrustedWebActivityIntentBuilder處理色彩配置的方法。

1.3.0-alpha04 版

2020 年 6 月 24 日

發布了 androidx.browser:browser:1.3.0-alpha04。1.3.0-alpha04 版包含此連結所列的修訂項目。

新功能

  • 已新增 CustomTabsClient#bindCustomTabServicePreservePriority 方法，允許不使用 Context.BIND_WAIVE_PRIORITY 旗標而連線至自訂分頁服務。

1.3.0-alpha03 版

2020年6月10日

發布了 androidx.browser:browser:1.3.0-alpha03。1.3.0-alpha03 版包含此連結所列的修訂項目。

新功能

  • 新增 TrustedWebActivityCallback 介面，可供信任的網路活動用戶端用來將資料傳回瀏覽器。(I64dbb)

API 變更

  • TrustedWebActivityServiceConnection.extraCommand 現在也會使用 @Nullable TrustedWebActivityCallback 參數。軟體包參數現在會標示為 @NonNull，而非 @Nullable。(I64dbb)
  • TrustedWebActivityServiceConnection.extraCommand 方法已重新命名為 sendExtraCommand (Id29a8)
  • CustomTabsIntent.Builder#addDefaultShareMenuItem() 已淘汰，並改用新的 #setDefaultShareMenuItemEnabled(boolean) 和 CustomTabsIntent.Builder#enableUrlBarHiding()，並已淘汰 #setUrlBarHidingEnabled(boolean)。(Iad702)

1.3.0-alpha01 版

2020 年 1 月 8 日

發布了 androidx.browser:browser:1.3.0-alpha01。1.3.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 您可以透過呼叫 TrustedWebActivityServiceConnection#extraCommand 從瀏覽器將任意形式指令傳送至信任的網路活動用戶端。用戶端可在 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 Activities
    • Trusted Web Activities 功能現已穩定運作。
    • TrustedWebActivityIntentBuilder 可用來自訂及建立 TrustedWebActivityIntent，以啟動受信任的網路活動。
    • 納入或擴充 TrustedWebActivityService 可讓用戶端顯示瀏覽器直接傳遞的網路推播通知。
    • 瀏覽器可以使用 TrustedWebActivityServiceConnectionPool 來連結用戶端的 TrustedWebActivityService。TrustedWebActivityServiceConnection 代表這類連線。
    • 可以啟動「Trusted Web Activities」，以便將資訊提供給網路分享目標。
  • 深色主題
    • 開發人員可透過 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 類別可用來代表套件的身分，包含套件名稱和套件簽署憑證的簽名。
    • 經序列化處理到位元組 []，即為持續性。
    • TrustedWebActivityService 會使用這個 ID 來判斷 TWA 供應商可連線的來源。
    • TWA 供應商會使用 TrustedWebActivityConnectionPool 判斷可連線至哪些套件。
  • TrustedWebActivityService 會使用 TokenStore 介面判斷可連線至哪些應用程式。
    • 用戶端可呼叫 TokenStore#store，TrustedWebActivityService 只會載入權杖。
  • TrustedWebActivityServiceConnectionPool (原為 TrustedWebActivityServiceConnectionManager) 將不再儲存通過驗證的套件：
    • 現已移除 registerClient 和 getVerifiedPackages。
    • 系統現在會將已驗證套件的集合手動提供給 execute (原為 connect) 和 serviceExistsForScope。
  • TrustedWebActivityService 會委派到覆寫類別，以儲存已驗證的供應商。
    • 已移除 setVerifiedProvider
    • 用戶端必須實作 getTokenStore，以便傳回可用於儲存及擷取 Token 的 TokenStore。

API 變更

  • TrustedWebActivityServiceConnectionManager 類別:
    • 現已改名為 TrustedWebActivityServiceConnectionPool。
    • 終於來到最後。
    • 由靜態 create 方法 (而非公開建構函式) 建構。
  • TrustedWebActivityService 類別:
    • 提供可覆寫方法的執行緒註解。
  • TrustedWebActivityServiceWrapper 類別:
    • 現已改名為 TrustedWebActivityServiceConnection。
    • 終於來到最後。
    • 現在，擲回原始的 RemoteExceptions，而非將其在 RuntimeExceptions 中包裝。
  • 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 版包含此連結所列的修訂項目。

新功能

  • 推出新的 Share Target API，以便支援 Trusted Web Activities。使用 Trusted Web Activities 的應用程式現在可將資料傳送至其「網路共用目標」，定義請見通訊協定 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-alpha07 版

2019 年 8 月 7 日

發布了 androidx.browser:browser:1.2.0-alpha07。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 深色主題

    • 開發人員可以設定主題，當裝置處於深色模式時，即可使用。
    • 開發人員也可以覆寫新啟動的瀏覽器，該模式應為深色模式或淺色模式。
    • 你可以在自訂分頁中指定導覽列的顏色。

  • Trusted Web Activities

    • TrustedWebActivityBuilder 可用來輕鬆建立及啟動Trusted Web Activities。
    • TrustedWebActivityService 和相關類別可用來與供應商溝通，接受連結網站的網路推播通知，並透過用戶端應用程式顯示通知。這部分的 API 必須自行變更。

  • 自訂分頁工作階段 ID

    • 您現在可透過 ID 建立自訂分頁工作階段，以便合併相同應用程式在相同編號下啟動的兩個工作階段。

API 變更

  • 瀏覽器動作的相關類別和方法已標示為已淘汰。可惜的是，雖然我們很期待此功能能正常運作，但幾乎所有人都暫時無法使用此功能，而且只有一個瀏覽器可以提供支援。我們即將淘汰這個程式碼，讓程式碼和 API 保持精簡。

1.0.0 版

1.0.0 版

2018 年 9 月 21 日

發布了 browser-1.0.0。