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,以便開發人員在做為側邊功能表時指定自訂分頁的位置。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetDecorationType,以便開發人員指定自訂分頁的裝飾類型做為側邊功能表。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition,當「自訂分頁」做為側邊功能表時,開發人員可指定圓角的位置。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled,當「自訂分頁」做為側邊功能表時,開發人員可以啟用或停用最大化按鈕。(Ie3564)。
  • 在介面 CustomTabsCallback 中新增 onActivityLayout 回呼方法,讓開發人員瞭解「Custom」分頁所佔區域的座標,以及其顯示狀態。當「自訂分頁」首次在畫面上出現,且所有佔據區域變更時,系統就會呼叫此方法。(I443f6)。
  • 在介面 CustomTabsCallback 中加入 onWarmupCompleted 回呼方法,讓開發人員知道 CustomTabsClient#warmupfinishes 為瀏覽器程序暖機時。(I107cf)。
  • 已將工作階段 ID 新增至 CustomTabsSession#setEngagementSignalsCallbackCustomTabsSession#isEngagementSignalsApiAvailable 中的額外項目。(Iba7f1)。
  • 針對 Minmized 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-beta021.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-beta011.8.0-beta01 版包含以下修訂項目。

新功能

  • 新增最低化自訂分頁 API 的實驗性支援。(I67f2d)。

1.8.0-alpha01 版

2023 年 11 月 15 日

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

新功能

  • 新增了 CustomTabsIntent.Builder#setInitialActivityWidthPx,可讓開發人員指定「Custom」分頁的初始啟動寬度。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp,可讓開發人員指定自訂分頁視窗的最小寬度,以便做為側邊功能表。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetPosition,以便開發人員在做為側邊功能表時指定自訂分頁的位置。(I443f6)。
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization,當「自訂分頁」做為側邊功能表時,開發人員可以啟用或停用最大化按鈕。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetDecorationType,以便開發人員指定自訂分頁的裝飾類型做為側邊功能表。(I443f6)。
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition,當「自訂分頁」做為側邊功能表時,開發人員可指定圓角的位置。(I443f6)。
  • 在介面 CustomTabsCallback 中新增 onActivityLayout 回呼方法,讓開發人員瞭解「Custom」分頁所佔區域的座標,以及其顯示狀態。當「自訂分頁」首次在畫面上出現,且所有佔據區域變更時,系統就會呼叫此方法。(I443f6)。
  • 在介面 CustomTabsCallback 中新增 onWarmupCompleted 回呼方法,讓開發人員知道 CustomTabsClient#warmup 暖機瀏覽器程序的時間。(I107cf)。

修正錯誤

  • 將工作階段 ID 新增至 CustomTabsSession#setEngagementSignalsCallbackCustomTabsSession#isEngagementSignalsApiAvailable 中的額外項目。(Iba7f1)。

1.7 版

1.7.0 版

2023 年 11 月 15 日

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

自 1.6.0 版以來的重要變更

  • 新增了 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.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-alpha011.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-alpha021.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-alpha011.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.01.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-rc011.5.0-rc01 版包含此連結所列的修訂項目

  • 自 1.5.0-beta01 以來沒有變更

1.5.0-beta01 版

2023 年 1 月 11 日

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

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

1.5.0-alpha02 版

2022 年 12 月 7 日

發布 androidx.browser:browser:1.5.0-alpha021.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-alpha011.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.01.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-beta011.4.0-alpha01起沒有變更。1.4.0-beta01 版包含此連結所列的修訂項目

1.4.0-alpha01 版

2021 年 9 月 15 日

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

修正錯誤

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

1.3.0 版

1.3.0 版

2020 年 12 月 2 日

發布 androidx.browser:browser:1.3.01.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-rc011.3.0-beta01起沒有變更。1.3.0-rc01 版包含此連結所列的修訂項目

1.3.0-beta01 版

2020 年 10 月 28 日

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

API 變更

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

修正錯誤

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

1.3.0-alpha06 版

2020 年 10 月 1 日

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

新功能

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

API 變更

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

1.3.0-alpha05 版

2020 年 8 月 5 日

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

新功能

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

API 變更

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

1.3.0-alpha04 版

2020 年 6 月 24 日

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

新功能

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

1.3.0-alpha03 版

2020年6月10日

發布 androidx.browser:browser:1.3.0-alpha031.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-alpha011.3.0-alpha01 版包含此連結所列的修訂項目

新功能

  • 您可以透過呼叫 TrustedWebActivityServiceConnection#extraCommand 從瀏覽器將任意形式指令傳送至信任的網路活動用戶端。用戶端可在 TrustedWebActivityService#onExtraCommand 中處理。

API 變更

  • 提供給 CustomTabsSession#mayLauncherUrlCustomTabsService#mayLaunchUrl 的網址先前為 @Nullable

1.2.0 版

1.2.0 版

2019 年 12 月 18 日

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

自 1.0.0 版起的重大變更

  • Trusted Web Activities
    • Trusted Web Activities 功能現已穩定運作。
    • TrustedWebActivityIntentBuilder 可用來自訂及建立 TrustedWebActivityIntent,以啟動受信任的網路活動。
    • 納入或擴充 TrustedWebActivityService 可讓用戶端顯示瀏覽器直接傳遞的網路推播通知。
    • 瀏覽器可以使用 TrustedWebActivityServiceConnectionPool 來連結用戶端的 TrustedWebActivityServiceTrustedWebActivityServiceConnection 代表這類連線。
    • 可以啟動「Trusted Web Activities」,以便將資訊提供給網路分享目標。
  • 深色主題
    • 開發人員可透過 CustomTabColorSchemeParams 提供不同的主題顏色,在裝置處於淺色或深色模式時使用。
    • 開發人員可以要求瀏覽器使用淺色或深色模式。
  • 繼續工作階段
    • 您可以使用 ID 建立 CustomTabsSession,讓後續的自訂分頁同一用戶端和 ID 能合併。
  • 您可以為自訂分頁指定導覽列的顏色。
  • 瀏覽器動作的相關類別已淘汰,因為其功能使用率非常低,日後將從程式庫中移除。

1.2.0-rc01 版

2019 年 12 月 4 日

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

修正錯誤

  • 已修正程式碼範例的 Javadoc 格式。

1.2.0-beta01 版

2019 年 11 月 20 日

androidx.browser:browser:1.2.0-beta011.2.0-alpha09起沒有變更。1.2.0-beta01 版包含此連結所列的修訂項目

1.2.0-alpha09 版

2019年10月23日

發布了 androidx.browser:browser:1.2.0-alpha091.2.0-alpha09 版包含此連結所列的修訂項目

新功能

  • Token 類別可用來代表套件的身分,包含套件名稱和套件簽署憑證的簽名。
    • 經序列化處理到位元組 [],即為持續性。
    • TrustedWebActivityService 會使用這個 ID 來判斷 TWA 供應商可連線的來源。
    • TWA 供應商會使用 TrustedWebActivityConnectionPool 判斷可連線至哪些套件。
  • TrustedWebActivityService 會使用 TokenStore 介面判斷可連線至哪些應用程式。
    • 用戶端可呼叫 TokenStore#storeTrustedWebActivityService 只會載入權杖。
  • TrustedWebActivityServiceConnectionPool (原為 TrustedWebActivityServiceConnectionManager) 將不再儲存通過驗證的套件:
    • 現已移除 registerClientgetVerifiedPackages
    • 系統現在會將已驗證套件的集合手動提供給 execute (原為 connect) 和 serviceExistsForScope
  • TrustedWebActivityService 會委派到覆寫類別,以儲存已驗證的供應商。
    • 已移除 setVerifiedProvider
    • 用戶端必須實作 getTokenStore,以便傳回可用於儲存及擷取 TokenTokenStore

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-alpha081.2.0-alpha08 版包含此連結所列的修訂項目

新功能

  • 推出新的 Share Target API,以便支援 Trusted Web Activities。使用 Trusted Web Activities 的應用程式現在可將資料傳送至其「網路共用目標」,定義請見通訊協定 https://wicg.github.io/web-share-target/level-2/ (aosp/I47b93aosp/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。