透過集合功能整理內容 你可以依據偏好儲存及分類內容。

瀏覽器

在使用者的預設瀏覽器中顯示網頁。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 10 月 24 日 1.4.0 - - 1.5.0-alpha01

宣告依附元件

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

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

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

Kotlin

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

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

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.5 版本

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)

修正錯誤

  • 已為 Android 啟用 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 版本包含這些修訂版本。

新功能

  • 允許設定「信任的網路活動」的方向。
  • 允許設定「信任的網路活動和自訂分頁」的導覽列分隔線顏色。

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 版起的重大異動

  • 受信任的網路活動
    • 信任網路活動功能現已穩定運作。
    • TrustedWebActivityIntentBuilder 可用來自訂及建立 TrustedWebActivityIntent,以啟動受信任的網路活動。
    • 納入或擴充 TrustedWebActivityService 可讓用戶端顯示瀏覽器直接傳遞的網路推播通知。
    • 瀏覽器可以使用 TrustedWebActivityServiceConnectionPool 來連結用戶端的 TrustedWebActivityServiceTrustedWebActivityServiceConnection 代表這類連線。
    • 推出值得信賴的網路活動,可將資訊提供給網路分享目標。
  • 深色主題
    • 開發人員可透過 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。使用「信任網路活動」的應用程式現在可將資料傳送至其「網路共用目標」,定義請見通訊協定 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。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 深色主題

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

    • TrustedWebActivityBuilder 可用來輕鬆建立及啟動信任的網路活動
    • TrustedWebActivityService 和相關類別可用來與供應商溝通,接受連結網站的網路推播通知,並透過用戶端應用程式顯示通知。這部分的 API 必須自行變更。
  • 自訂分頁工作階段 ID

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

API 異動

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

1.0.0 版

1.0.0 版

2018 年 9 月 21 日

瀏覽器 1.0.0 版已推出。