Browser

在使用者的預設瀏覽器中顯示網頁。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 10 月 8 日 1.9.0 - - 1.10.0-alpha02

宣告依附元件

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

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

Groovy

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

Kotlin

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

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

意見回饋

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

建立新問題

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

1.10 版

1.10.0-alpha02 版

2025 年 10 月 8 日

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

API 變更

  • 公開 AuthTabIntent.AuthenticateUserResultContract (I1e598、b/425405218)
  • 重新命名視窗控制項疊加層顯示模式，使其與其他模式保持一致。(I10b67)

1.10.0-alpha01 版

2025 年 8 月 13 日

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

API 變更

  • 新增對 display_override TWA 資訊清單屬性 (Ib036b) 的支援
  • 移除過時的 @RequiresApi(21) 註解 (Ic4792)
  • 移除過時的 @RequiresApi(21) 註解 (I9103b)
  • 允許在 ContentActionSelectedData 中使用空值 pageUrl (Ifed54)
  • 新增 Intent，允許在外部應用程式中啟動初始網址 (Id9349)
  • 新增 Intent，允許在外部應用程式中啟動初始網址 (Ifed54)

修正錯誤

1.9 版

1.9.0 版

2025 年 7 月 30 日

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

1.9.0-rc01 版本

2025 年 7 月 16 日

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

API 變更

  • 為自訂分頁新增「內容選單項目」(Iab7d0)

修正錯誤

  • 更新 setOpenInBrowserButtonState 的 JavaDocs (Iae1f2)

1.9.0-beta01 版本

2025 年 7 月 2 日

發布 androidx.browser:browser:1.9.0-beta01。1.9.0-beta01 版與前一個 Alpha 版相比沒有任何異動。

1.9.0-alpha05 版本

2025 年 6 月 18 日

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

API 變更

  • 從暫時性瀏覽 API 移除實驗性註解 (If8b1b)

1.9.0-alpha04 版

2025 年 5 月 20 日

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

API 變更

  • 新增自訂分頁的意圖額外資訊 (I911e0)
  • 在 TWADisplayMode 中新增 Browser 和 MiminalUi 模式 (I230b5)
  • 新增暫時瀏覽功能檢查 API (I17d42)
  • 移除 PendingSession API 的實驗性註解 (Id6fe3)
  • 新增「驗證」分頁功能檢查 API (Ifc029)
  • 移除了自訂分頁縮到最小信號的實驗性註解 (If2b44)

1.9.0-alpha03 版

2025 年 4 月 23 日

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

API 變更

  • 從「驗證」分頁中移除實驗性註解。(I786ff)

1.9.0-alpha02 版

2025 年 4 月 9 日

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

新功能

  • 新增多個漸進式網頁應用程式 API 的支援，例如「啟動處理常式」、「通訊協定處理常式」和「檔案處理常式」

API 變更

  • 已為 CustomTabsClient#createPendingAuthTabSession 新增超載。(I71c3a)
  • 更新了「驗證」分頁 API (Iaf9b1)
  • TrustedWebActivityIntent 現在包含 Launch Handler API 用戶端模式，可供瀏覽器使用這項 API。(Ifc95c)
  • TrustedWebActivityIntent 現在包含透過應用程式註冊意圖篩選器開啟的檔案 URI，並授予瀏覽器對這些檔案的讀寫權限。(I2134a)
  • TrustedWebActivityIntent 現在會在額外資訊中加入原始啟動的網址，供通訊協定處理常式使用時，為瀏覽器新增背景資訊。(I3759a)
  • 新增 API，可啟用/停用自訂分頁的關閉按鈕。(I35acd)
  • 在驗證分頁中新增了關閉按鈕圖示自訂支援 (Iaf877)

1.9.0-alpha01 版

2025 年 1 月 29 日

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

API 變更

  • 在「驗證」分頁中新增瀏覽器連線/工作階段支援。(I6e47b)
  • 新增 CustomTabsSession#isEphemeralBrowsingSupported API，用於判斷是否支援臨時瀏覽 (Ie4dea、b/384548523)
  • 在 Auth Tab API 中新增色彩配置參數支援。(I630e1)
  • 在自訂分頁中新增實驗性暫時性瀏覽選項 (I9549d)
  • 更新實驗性 Auth Tab API (I8b674)
  • 新增 API，檢查 Custom Tabs 提供者是否支援多重網路。(I4307a)
  • 新增服務意圖篩選器類別，支援多個網路。(I4354a)
  • 新增 API，以便透過自訂分頁啟動網址時，設定/取得繫結網路。(I493e1)
  • 新增實驗性「驗證」分頁 API (I9b4d4)
  • PendingSession 的全新實驗性 API (Ib40e5)

修正錯誤

  • 更新 AuthTabIntent Javadocs (I2490c)
  • 修正「驗證」分頁中的工作階段支援 (I4e280)
  • 這個程式庫現在使用 JSpecify 空值註解，這些註解屬於型別用途。Kotlin 開發人員應使用下列編譯器引數，強制執行正確用法：-Xjspecify-annotations=strict (這是 Kotlin 編譯器 2.1.0 版的預設值)。(Ic7bf5、b/326456246)
  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(I9496c、b/345472586)

外部貢獻

  • 導入新的 IPC 呼叫 ICustomTabsService#prefetchWithMultipleUrls，避免單一網址進行多個 IPC 呼叫。(Ie5025)
  • 讓 CustomTabsSession#prefetch 將 CustomTabsSession 的工作階段 id(mID) 傳播至 CustomTabsService。(I4ec7b)
  • 新增實驗性 API CustomTabsSession#prefetch(List<Uri>, PrefetchOptions)，可多載現有 API 以接受多個網址。(I54f35)
  • 新增實驗性 API CustomTabsSession#prefetch(Uri, PrefetchOptions)，嘗試預先擷取主要頁面 (不含子資源)，以供日後瀏覽。(I340cf)

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，以便開發人員在「Custom」分頁做為側邊功能表時，指定裝飾類型。(I443f6)
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition，以便開發人員在「Custom」分頁做為側邊功能表時，指定圓角位置。(I443f6)
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetMaximizationEnabled，以便開發人員在「Custom」分頁做為側邊功能表時，啟用或停用最大化按鈕。(Ie3564)
  • 在介面 CustomTabsCallback 中加入 onActivityLayout 回呼方法，讓開發人員知道「Custom」分頁佔用的區域座標，以及顯示狀態。系統會在自訂分頁首次顯示在畫面上時，以及每次佔用區域變更時呼叫此方法。(I443f6)
  • 在介面 CustomTabsCallback 中加入 onWarmupCompleted 回呼方法，讓開發人員知道何時要 CustomTabsClient#warmupfinishes 暖機瀏覽器程序。(I107cf)
  • 在 CustomTabsSession#setEngagementSignalsCallback 和 CustomTabsSession#isEngagementSignalsApiAvailable 的 extras 中新增工作階段 ID。(Iba7f1)
  • 新增對縮小自訂分頁 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，以便開發人員指定「Custom」分頁的初始啟動寬度。(I443f6)
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetBreakpointDp，開發人員可指定「Custom」分頁視窗的最小寬度，使其做為側邊工作表。(I443f6)
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetPosition，以便開發人員指定「Custom」分頁在做為側邊功能表時的位置。(I443f6)
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetEnableMaximization，以便開發人員在「Custom」分頁做為側邊功能表時，啟用或停用最大化按鈕。(I443f6)
  • 新增 CustomTabsIntent.Builder#setActivitySideSheetDecorationType，以便開發人員在「Custom」分頁做為側邊功能表時，指定裝飾類型。(I443f6)
  • 新增了 CustomTabsIntent.Builder#setActivitySideSheetRoundedCornersPosition，以便開發人員在「Custom」分頁做為側邊功能表時，指定圓角位置。(I443f6)
  • 在介面 CustomTabsCallback 中加入 onActivityLayout 回呼方法，讓開發人員知道「Custom」分頁佔用的區域座標，以及顯示狀態。系統會在自訂分頁首次顯示在畫面上時，以及每次佔用區域變更時呼叫此方法。(I443f6)
  • 在介面 CustomTabsCallback 中加入 onWarmupCompleted 回呼方法，讓開發人員知道何時 CustomTabsClient#warmup 完成瀏覽器程序預熱。(I107cf)

修正錯誤

  • 在 CustomTabsSession#setEngagementSignalsCallback 和 CustomTabsSession#isEngagementSignalsApiAvailable 的 extras 中新增工作階段 ID。(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，指定要觸發翻譯 UI 的目標語言。(Ia792e)
  • 新增 CustomTabsIntent.Builder#setBackgroundInteractionEnabled，在啟動部分「Custom」分頁時，可與背景應用程式互動。(Ia792e)
  • 新增 CustomTabsIntent.Builder#setShareIdentityEnabled，可讓自訂分頁取得呼叫端的 ID。(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，在啟動部分「Custom」分頁時，可與背景應用程式互動。(Ia792e)
  • 新增 CustomTabsIntent.Builder#setShareIdentityEnabled，可讓自訂分頁取得呼叫端的 ID。(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，簡化 Custom Tabs 實作端的 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。