Webkit
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 9 月 4 日 | 1.9.0 | 1.12.0-rc01 | - | - |
宣告依附元件
如要新增 Webkit 的依附元件,必須將 Google Maven 存放區新增至您的 專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增所需構件的依附元件:
Groovy
dependencies { implementation "androidx.webkit:webkit:1.9.0" }
Kotlin
dependencies { implementation("androidx.webkit:webkit:1.9.0") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
版本 1.12
1.12.0-rc01 版
2024 年 9 月 4 日
發布 androidx.webkit:webkit:1.12.0-rc01
。這個版本包含 1.12.0-beta01
版本沒有任何變更。
1.12.0-beta01 版
2024 年 8 月 21 日
發布 androidx.webkit:webkit:1.12.0-beta01
。1.12.0-beta01 版包含這些修訂版本。
修正錯誤
- 由於使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3) 時,以及所有使用 AGP 8.1 以上版本 (例如 D8 8.1) 的建構作業,這項作業會自動透過 API 模型建立,因此我們不再手動列出新平台 API 的存取權。針對非使用 AGP 的用戶端,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ia60e0、b/345472586)
1.12.0-alpha02 版
2024 年 6 月 12 日
發布 androidx.webkit:webkit:1.12.0-alpha02
。1.12.0-alpha02 版包含這些修訂版本。
新功能
- 在
WebSettingsCompat
中新增 API,以啟用/停用「BackForwardCache
」。這個 API 仍在實驗階段,日後可能會變更。(I64a38)。 - 在
WebSettingsCompat
中新增 API,控管這個 WebSettings 的推測載入行為。目前僅支援預先算繪。這個 API 仍在實驗階段,日後可能會變更。(I13962)。
API 變更
- 部分方法現已視情況以
@UiThread
記錄。(I6c7e0、I44541) - 執行緒安全方法現已以
@AnyThread
記錄。(I70189)。 - 將
minSdkVersion
從 19 調高至 21。(Id7a43)。
1.12.0-alpha01 版
2024 年 4 月 17 日
發布 androidx.webkit:webkit:1.12.0-alpha01
。1.12.0-alpha01 版包含這些修訂版本。
API 變更
- 新增用來在
WebView. Developers
中啟用網路驗證的 API,可使用WebSettingsCompat#setWebAuthenticationSupport
在WebView
中為應用程式啟用/停用WebAuthn
呼叫。(I8187f)。
版本 1.11
版本 1.11.0
2024 年 5 月 1 日
發布 androidx.webkit:webkit:1.11.0
。1.11.0 版包含這些修訂版本。
自 1.10.0 版以來的重要變更
- 允許應用程式透過新的
setAudioMuted
和isAudioMuted
API 控制WebView
的音訊播放,這類似 Chrome 的分頁靜音功能。 - 推出
URLUtilCompat
,支援剖析使用filename*
編碼值屬性 (如 RFC 6266 中所定義) 的Content-Disposition
標頭。相容性 API 也會直接公開剖析Content-Disposition
標頭的方法,根據網址和 MIME 類型提供的建議檔案名稱。
1.11.0-rc01 版
2024 年 4 月 3 日
發布 androidx.webkit:webkit:1.11.0-rc01
。這個版本包含 1.11.0-beta01
版本沒有任何變更。
1.11.0-beta01 版
March 20, 2024
androidx.webkit:webkit:1.11.0-beta01
發布,沒有任何重大異動。1.11.0-beta01 版包含這些修訂版本。
1.11.0-alpha02 版
2024 年 2 月 21 日
發布 androidx.webkit:webkit:1.11.0-alpha02
。1.11.0-alpha02 版包含以下修訂項目。
新功能
- 新增用於忽略 (且取消忽略)
WebViews
的setAudioMuted
和isAudioMuted
方法。這個方法可避免WebView
播放音訊。(Ie7a33)。
API 變更
URLUtilCompat
為最終決定,因為其不應為子類別。(I49ec1)。
1.11.0-alpha01 版
2024 年 2 月 7 日
發布 androidx.webkit:webkit:1.11.0-alpha01
。1.11.0-alpha01 版包含以下修訂項目。
新功能
- 為
URLUtil.guessFileName
新增相容性。URLUtilCompat
的相容性版本支援剖析Content-Disposition
標頭 (這些標頭使用filename*
編碼值屬性,如 RFC 6266 中定義)。相容性 API 也會直接公開剖析Content-Disposition
標頭的方法,根據網址和 MIME 類型提供的建議檔案名稱。(If6ae7、b/309927164)
版本 1.10
1.10.0 版本
2024 年 1 月 24 日
發布 androidx.webkit:webkit:1.10.0
。1.10.0 版包含以下修訂項目。
自 1.9.0 版以來的重要變更
- 在 WebSettingsCompat 中新增 API,以完全停用 API,或在 API 回應中限制分享應用程式身分,藉此控制實驗性的 Android WebView Media Integrity API 行為。您可以針對所有來源切換這項設定,也可以依來源切換。
1.10.0-rc01 版
2024 年 1 月 10 日
發布 androidx.webkit:webkit:1.10.0-rc01
。這個版本包含 1.10.0-beta01
版本沒有任何變更。
1.10.0-beta01 版
2023 年 12 月 13 日
發布 androidx.webkit:webkit:1.10.0-beta01
。1.10.0-beta01 版包含以下修訂項目。
1.10.0-alpha01
沒有功能變更。
1.10.0-alpha01 版本
2023 年 11 月 29 日
發布 androidx.webkit:webkit:1.10.0-alpha01
。查看 1.10.0-alpha01 版的修訂項。
新功能
- 在
WebSettingsCompat
中新增 API,以完全停用 API,或在 API 回應中限制分享應用程式身分,藉此控制實驗性的 Android WebView Media Integrity API 行為。您可以針對所有來源切換這項設定,也可以依來源切換。
版本 1.9
1.9.0 版
2023 年 11 月 29 日
發布 androidx.webkit:webkit:1.9.0
。1.9.0 版包含以下修訂項目。
自 1.8.0 版以來的重要變更
- 針對 WebView 新增多重設定檔 API。
- Profile 介面擁有不同的 API,可用於取得與這個設定檔相關的資料,例如名稱、GeoLocationPermissions、ServiceWorkerController、CookieManager 和 WebStorage。這些物件僅適用於這個設定檔,且應用程式中的不同設定檔之間不會共用資訊。
- 您可以利用 WebViewCompat#setProfile 方法變更
WebView
執行個體使用的設定檔,並使用 WebViewCompat#getProfile 擷取 - 新推出的 ProfileStore 可讓您管理應用程式中可用的設定檔,包括預設設定檔。
- 現有 WebView API (例如 CookieManager#getInstance) 將繼續在預設設定檔上運作。
- 新增 API,可在載入網頁前插入及執行 JavaScript。
- WebViewCompat#addDocumentStartJavascript API 可讓應用程式將指令碼插入
WebView
,確保指令碼能在執行任何網頁指令碼前執行。這個 API 可讓應用程式指定要啟用指令碼的目標來源清單,確保指令碼只會在目標網頁上執行。這個 API 與 WebView#customersJavascript 不同,會在載入時執行內嵌 iframe 中的指令碼。應用程式能使用這個新的 API 搭配 WebViewCompat#addWebMessageListener,以可靠的方式在網頁上與 JavaScript 進行雙向通訊。
- WebViewCompat#addDocumentStartJavascript API 可讓應用程式將指令碼插入
- 新增 API,以修改 Privacy Sandbox Attribution Reporting 事件的登錄方式。
- 我們推出了新的 API WebSettingsCompat#setAttributionRegistrationBehavior,允許開發人員設定是否要將歸因來源和觸發條件登錄為來自應用程式本身,或來自 WebView 的網頁內容。這個方法也可以用來停用 WebView 中的 Attribution Reporting。此外,我們還新增了 API
WebSettingsCompat#getAttributionRegistrationBehavior
,以便取得目前行為。 - 詳情請參閱 Privacy Sandbox 說明文件。
- 我們推出了新的 API WebSettingsCompat#setAttributionRegistrationBehavior,允許開發人員設定是否要將歸因來源和觸發條件登錄為來自應用程式本身,或來自 WebView 的網頁內容。這個方法也可以用來停用 WebView 中的 Attribution Reporting。此外,我們還新增了 API
- 新增用於覆寫用戶端提示的使用者代理程式中繼資料的 API。
- 我們推出了 WebSettingsCompat#setUserAgentMetadata 這個新的 API,用於覆寫 WebView 的使用者代理程式中繼資料,以填入使用者代理程式用戶端提示。此外,我們也新增了另一個 API WebSettingsCompat#getUserAgentMetadata,以取得目前的使用者代理程式覆寫值。我們建議應用程式利用 WebSettings.setUserAgentString 變更預設的使用者代理程式字串,藉此設定正確的覆寫值,確保在任何情況下都能使用正確的值。
1.9.0-rc01 版本
2023 年 11 月 15 日
發布 androidx.webkit:webkit:1.9.0-rc01
。這個版本包含 1.9.0-beta01
版本沒有任何變更。
1.9.0-beta01 版本
2023 年 11 月 1 日
發布 androidx.webkit:webkit:1.9.0-beta01
。1.9.0-beta01 版包含以下修訂項目。
API 變更
- 解決使用者代理程式中繼資料 API 的是否可為空值問題。我們會更新
BrandVersion
類別以使用建構工具模式,讓UserAgentMetadata
類別的 getter 和 setter 的是否可為空值保持一致。(Ibf195)。 - 使用
@UiThread
為ProfileStore
、WebViewCompat#setProfile
和WebViewCompat.getProfile
加上註解。(I499b2)。
1.9.0-alpha01 版
2023 年 10 月 18 日
發布 androidx.webkit:webkit:1.9.0-alpha01
。1.9.0-alpha01 版包含以下修訂項目。
新功能
- 我們新增了多重設定檔 API,讓您可以在
WebViews
之間建立不同的瀏覽工作階段,而每個設定檔都有專屬的資料 (例如 Cookie)。您可以建立設定檔並指派給WebView
執行個體,日後就能在存取資料時擷取設定檔。我們提供單例模式ProfileStore
,可協助你透過 API 建立或刪除作業管理設定檔。getOrCreateProfile
、getProfile
、getAllProfileNames
和deleteProfile
。Profile
類別將有不同的 API,可用於取得這個設定檔的相關資料,例如名稱、GeoLocationPermissions
、ServiceWorkerController
、CookieManager
和WebStorage
。根據預設,每個WebView
都會以預設設定檔執行,但您可以使用WebViewCompat#setProfile
相關變更,使用WebViewCompat#getProfile
擷取WebView
的設定檔。(I32d22)。 - 新增 API,修改 Attribution Reporting 事件的登錄方式。我們推出了新的 API
WebSettingsCompat#setAttributionRegistrationBehavior
,可讓開發人員設定來源和觸發條件的登錄來源是應用程式本身,還是來自WebView
中的網路內容。這個方法也可以用來停用WebView
中的歸因報表。此外,我們還新增了 APIWebSettingsCompat#getAttributionRegistrationBehavior
,以便取得目前行為。詳情請參閱 Privacy Sandbox 說明文件。 (I661f2)。 - 新增 API 即可覆寫使用者代理程式中繼資料。我們推出了新的 API
WebSettingsCompat#setUserAgentMetadata
,用於覆寫 WebView 的使用者代理程式中繼資料,除了用於填入使用者代理程式用戶端提示,我們還新增了另一個 APIWebSettingsCompat#getUserAgentMetadata
,以便取得目前的使用者代理程式覆寫值。我們建議應用程式使用新的 API 來設定適當的覆寫值,不要仰賴變更使用者代理程式。(I74500)。 - 新增 API,以插入要在網頁載入期間執行的 JavaScript。
WebViewCompat.addDocumentStartJavascript
API 可讓應用程式在執行任何頁面指令碼之前,將指令碼插入 WebView。這個 API 可讓應用程式指定要啟用指令碼的目標來源清單,確保指令碼只會在目標網頁上執行。與WebView.evaluateJavascript
不同的是,這個 API 允許在嵌入式 iframe 中的指令碼在載入時執行。(Ide063)。
1.8 版
1.8.0 版
2023 年 9 月 6 日
發布 androidx.webkit:webkit:1.8.0
。1.8.0 版包含以下修訂項目。
自 1.7.0 版以來的重要變更
- 新增透過
WebMessagePortCompat#postMessage
、JavaScriptReplyProxy#postMessage
和WebViewCompat#postWebMessage
傳遞ArrayBuffer
的支援功能,透過WebMessagePortCompat
和WebMessageListener
接收 JavaScript 的ArrayBuffer
,並透過WebMessagePortCompat
接收來自 JavaScript 的可轉移ArrayBuffer
。(aosp/2596550、b/251152171)
1.8.0-rc01 版
2023 年 8 月 9 日
androidx.webkit:webkit:1.8.0-rc01
自 1.8.0-beta01
起沒有變更。1.8.0-rc01 版包含以下修訂項目。
1.8.0-beta01 版
2023 年 7 月 26 日
androidx.webkit:webkit:1.8.0-beta01
自 1.8.0-alpha01
起沒有變更。1.8.0-beta01 版包含以下修訂項目。
1.8.0-alpha01 版
2023 年 6 月 7 日
發布 androidx.webkit:webkit:1.8.0-alpha01
。1.8.0-alpha01 版包含以下修訂項目。
API 變更
- 請參閱「外部貢獻」部分。
外部貢獻
- 新增透過
WebMessagePortCompat#postMessage
、JsReplyProxy#postMessage
和WebViewCompat#postWebMessage
傳遞ArrayBuffer
的支援功能、透過WebMessagePortCompat
和WebMessageListener
接收 JavaScript 的ArrayBuffer
,以及透過WebMessagePortCompat
接收 JavaScript 的可轉移ArrayBuffer
。請注意,您將只能透過WebView
116 版使用這個 API。(Ie7567、b/251152171)
1.7 版
1.7.0 版
2023 年 5 月 24 日
發布 androidx.webkit:webkit:1.7.0
。1.7.0 版包含以下修訂項目。
自 1.6.0 版以來的重要變更
- 我們在
WebView
中新增了對圖片拖曳功能的支援。如要讓使用者從WebView
中移出圖片,可以按照類別說明文件的說明,將新的DropDataContentProvider
新增至應用程式的資訊清單。 - 我們新增了
ProcessGlobalConfig#setDirectoryBasePaths(Context,File,File)
API,可用於設定WebView
將用於目前程序的基本目錄。與ProcessGlobalConfig
上的所有方法一樣,必須先呼叫這個方法,才能將WebView
的第一個例項執行個體化。新增此方法可讓 Android 架構調整WebView
設定。對於一般用途應用程式,我們不建議使用這個方法。
1.7.0-rc01 版
2023 年 5 月 10 日
androidx.webkit:webkit:1.7.0-rc01
自 1.7.0-beta01
起沒有變更。1.7.0-rc01 版包含以下修訂項目。
1.7.0-beta01 版
2023 年 4 月 5 日
發布 androidx.webkit:webkit:1.7.0-beta01
。1.7.0-beta01 版包含以下修訂項目。
API 變更
- 微幅變更功能旗標和方法名稱,並將
setDirectoryBasePaths()
設為接受 File 而非字串 (Ib0d0a)
1.7.0-alpha03 版
2023 年 3 月 8 日
發布 androidx.webkit:webkit:1.7.0-alpha03
。1.7.0-alpha03 版包含以下修訂項目。
API 變更
- 新增
ProcessGlobalConfig#setDirectoryBasePath(String, String)
API,該 API 可用於設定WebView
將用於目前程序的基本目錄。(Ibd1a1、b/250553687)
修正錯誤
- 修正使用
DexGuard
時發生的無效ProGuard
規則導致建構錯誤 (Ia65c2、b/270034835)
1.7.0-alpha02 版
2023 年 2 月 8 日
發布 androidx.webkit:webkit:1.7.0-alpha02
。1.7.0-alpha02 版包含以下修訂項目。
修正錯誤
DropDataContentProvider
的說明文件錯誤。
1.7.0-alpha01 版
2023 年 1 月 25 日
發布 androidx.webkit:webkit:1.7.0-alpha01
。1.7.0-alpha01 版包含以下修訂項目。
新功能
1.6 版本
1.6.1 版
2023 年 3 月 22 日
發布 androidx.webkit:webkit:1.6.1
。1.6.1 版包含以下修訂項目。
修正錯誤
- 修正 ProGuard 剖析錯誤 (Ia65c2)
1.6.0 版
2023 年 1 月 25 日
發布 androidx.webkit:webkit:1.6.0
。1.6.0 版包含以下修訂項目。
自 1.5.0 版以來的重要變更
- 新增 ProcessGlobalConfig API,讓應用程式得以提供載入 WebView 前必須進行的組態設定,例如 WebView 資料目錄後置字串。這項設定必須在應用程式啟動時盡快完成並套用,確保啟動作業是在其他執行緒呼叫可將
WebView
載入處理程序的方法之前發生。 - 已新增 CookieManagerCompat API,以便透過新的
getCookieInfo
方法展開 android.webkit.CookieManager,這樣便能擷取特定 URL 上設定的所有 Cookie 的全部屬性。這與CookieManager
中現有的 getCookie API 不同,getCookie API 只會傳回 Cookie 的名稱和值屬性。 - 如果在
WebView
中由管理員進行設定,WebSettingsCompat
可採用新的方法啟用/停用EnterpriseAuthenticationAppLinkPolicy
的效果,並取得目前的設定。這項功能可讓 WebView 開啟驗證應用程式,而不是開啟驗證網址。這項功能不會影響非由企業政策管理的裝置。 - 在
WebSettingsCompat
中新增新的 API,以便讓應用程式將X-Requested-With
標頭中的應用程式套件名稱明確地傳送給許可清單來源。每次從WebView
收到要求時,傳統上都會傳送此標頭。
1.6.0-rc01 版
2023 年 1 月 11 日
發布 androidx.webkit:webkit:1.6.0-rc01
。1.6.0-rc01 版包含以下修訂項目。
修正錯誤
- 修正了在 SDK < 版本上執行時,
WebViewFeature.isStartupFeatureSupported(Context, String)
中的NullPointerException
L.(Ic7292)。
1.6.0-beta01 版
2022 年 12 月 7 日
發布 androidx.webkit:webkit:1.6.0-beta01
。1.6.0-beta01 版包含以下修訂項目。
API 變更
ProcessGlobalConfig
已變更為可使用一般建構函式和靜態套用方法。您應盡早為每個程序呼叫一次套用方法,如果多次呼叫,則會擲回IllegalStateException
。ProcessGlobalConfig
物件不再對 setter 呼叫次數有任何限制。(I456c3)。
1.6.0-alpha03 版本
2022 年 11 月 9 日
發布 androidx.webkit:webkit:1.6.0-alpha03
。1.6.0-alpha03 版包含以下修訂項目。
新功能
- 新增
ProcessGlobalConfig
類別,讓使用者在載入WebView
前設定處理程序全域設定。WebView
包含部分 process-global 設定參數,這些參數在載入WebView
後即無法變更 (例如WebView
資料目錄)。此類別可讓應用程式設定這些參數。這項設定必須在應用程式啟動時盡快完成並套用,確保啟動作業是在其他執行緒呼叫可將WebView
載入處理程序的方法之前發生。(I7c0e0、b/250553687) - 新增 API,讓應用程式將 X-Requested-With 標頭中的應用程式套件名稱明確傳送至已加入許可清單的來源。每次從
WebView
收到要求時,傳統上都會傳送此標頭。(I0adfe、b/226552535)
API 變更
- 所有 Android 版本皆支援
WebView
105 以上版本中的WebSettingsCompat#setAlgorithmicDarkeningAllowed
API。僅 Android Q 以上版的 API 支援先前的WebView
版本。因此,此 API 不再標示為@RequiresApi(Build.VERSION_CODES.Q)
。(I3ac1d)。
1.6.0-alpha02 版本
2022 年 10 月 24 日
發布 androidx.webkit:webkit:1.6.0-alpha02
。1.6.0-alpha02 版包含以下修訂項目。
新功能
- 新增
CookieManagerCompat
類別以及getCookieInfo
API,用於擷取特定網址上所有 Cookie 的所有屬性。這與CookieManager
中現有的getCookie
API 不同,後者只會傳回 Cookie 的名稱和值屬性。(I07365、b/242161756)
1.6.0-alpha01 版本
2022 年 8 月 24 日
發布 androidx.webkit:webkit:1.6.0-alpha01
。1.6.0-alpha01 版包含以下修訂項目。
新功能
- 在
WebSettingsCompat
中新增 API,以便在管理員透過WebView
進行設定時啟用/停用EnterpriseAuthenticationAppLinkPolicy
的效果。這項功能可讓WebView
開啟驗證應用程式,而不是開啟驗證網址。這項功能不會影響非由企業政策管理的裝置。
1.5.0 版本
1.5.0 版本
2022 年 8 月 24 日
發布 androidx.webkit:webkit:1.5.0
。1.5.0 版包含此連結所列的修訂項目。
自 1.4.0 版以來的重要異動
WebSettingsCompat
的新setAlgorithmicDarkeningAllowed
API 已取代舊的setForceDark
和setForceDarkStrategy
API。指定 SDK 33 以上版本 (T) 的應用程式應使用新的 API,因為舊的 API 將不再對這些應用程式產生任何作用。- 現在只要將
setReverseBypassEnabled
設為true
,即可透過ProxyCofig.Builder
設定網址許可清單,以便使用已設定的 Proxy。這個做法生效後,所有其他網址都會略過已設定的 Proxy。
1.5.0-rc01 版
2022 年 8 月 10 日
androidx.webkit:webkit:1.5.0-rc01
自 1.5.0-beta01
起沒有變更。1.5.0-rc01 版包含以下修訂項目。
1.5.0-beta01 版
2022 年 6 月 29 日
發布 androidx.webkit:webkit:1.5.0-beta01
。1.5.0-beta01 版包含此連結所列的修訂項目。
API 變更
- Alogrithimic Darkening 相關 API 現在會透過備註說明必須使用 API 級別 Q。API 不會對 API 級別 <問:由於這些裝置並不提供深色主題選項,(I0905e)。
1.5.0-alpha01 版本
2022 年 5 月 18 日
發布 androidx.webkit:webkit:1.5.0-alpha01
。1.5.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 在
WebViewCompat
上新增getVariationsHeader()
方法,取得WebView
傳送的 X-Client-Data 標頭值。傳回的值會是採用 Base64 編碼的 ClientVariations protobuf。 - 在
WebSettingsCompat
上新增 API 以允許/禁止針對 targetSdk >= 33 的應用程式進行演算法調暗。(I29597)。
API 變更
- 在
ProxyCofig.Builder
中新增方法即可設定反向略過。如果將反向略過設為 True,系統只會使用略過清單中的網址使用 Proxy 設定。(I9eaa2、b/168728599)
修正錯誤
- 修正深色主題說明文件中的錯字(I36ebf、b/194343633)
- 已修正以下錯誤:
WebViewAssetLoader.Builder
方法無預警地依順序執行。(If420d、b/182196765)
1.4.0 版本
1.4.0 版本
2020 年 12 月 16 日
發布 androidx.webkit:webkit:1.4.0
。1.4.0 版包含此連結所列的修訂項目。
自 1.3.0 版以來的重大異動
- 新增了
setSafeBrowsingAllowlist()
API 以取代setSafeBrowsingWhitelist()
。這項功能可讓應用程式更新程式碼,避免使用非包含性的術語,同時支援與已淘汰 API 相同的 Android SDK 和 WebView 版本。 - 修正了 setProxyOverride 中無法正確套用備用規則的錯誤。
1.4.0-rc02 版
2020 年 12 月 2 日
發布 androidx.webkit:webkit:1.4.0-rc02
。1.4.0-rc02 版包含以下修訂項目。
修正錯誤
- 修正使用 setProxyOverride 時無法正確套用備用規則的問題。
1.4.0-rc01 版本
2020 年 11 月 11 日
androidx.webkit:webkit:1.4.0-rc01
自 1.4.0-beta01
起沒有變更。1.4.0-rc01 版包含以下修訂項目。
1.4.0-beta01 版本
2020 年 10 月 14 日
androidx.webkit:webkit:1.4.0-beta01
自 1.4.0-alpha01
起沒有變更。1.4.0-beta01 版包含此連結所列的修訂項目。
1.4.0-alpha01 版
2020 年 9 月 16 日
發布 androidx.webkit:webkit:1.4.0-alpha01
。查看 1.4.0-alpha01 版的修訂項目。
API 變更
- 已將新的
WebViewCompat#setSafeBrowsingAllowlist()
API 新增至 取代setSafeBrowsingWhitelist()
。這有助於應用程式將程式碼更新為 避免使用非包容性的術語,同時支援相同的範圍 的 Android SDK 和 WebView 版本。(I8d65d)
1.3.0 版本
1.3.0 版本
2020 年 8 月 19 日
發布 androidx.webkit:webkit:1.3.0
。1.3.0 版包含此連結所列的修訂項目。
自 1.2.0 版以來的重大異動
- ForceDarkStrategy API 提供 WebView 調暗的控制項 (CSS/網路內容調暗及自動調暗) 功能。
- WebMessageListener 及其相關 API 提供一種簡單又安全的機制,可用來建立網頁內容和 WebView 嵌入式應用程式之間的通訊內容。
- 使用
isMultiProcessEnabled
API 檢查 WebView 是否在多個程序中執行。這可能會從 Android O 開始提供,也就是說,網頁內容和沙箱程序都是獨立的,而且與應用程式程序不同。這個沙箱轉譯器可以與同一個應用程式中的其他 WebView 共用,但不會與其他應用程式程序共用。
1.3.0-rc02 版本
2020 年 8 月 5 日
發布 androidx.webkit:webkit:1.3.0-rc02
。查看 1.3.0-rc02 版的修訂項。
修正錯誤
- 修正相容性問題,此問題會導致應用程式在 Android Studio 執行個體執行的情況下啟動時,
WebMessageListener
可能有時會在本機開發期間當機。
1.3.0-rc01 版本
2020 年 6 月 24 日
androidx.webkit:webkit:1.3.0-rc01
自 1.3.0-beta01
起沒有變更。1.3.0-rc01 版包含此連結所列的修訂項目。
1.3.0-beta01 版本
2020 年 6 月 10 日
發布 androidx.webkit:webkit:1.3.0-beta01
。1.3.0-beta01 版包含以下修訂項目。
新功能
- 使用
ForceDarkStrategy
API 可控制 WebView 暗度 (CSS/網頁內容調暗或自動調暗)。 WebMessageListener
API 提供一種簡單又安全的機制,可用來建立網頁內容和 WebView 嵌入式應用程式之間的通訊內容。- 使用
MultiProcessEnabled
API 可檢查 WebView 是否在多程序模式中執行。
1.3.0-alpha03 版
2020 年 5 月 27 日
發布 androidx.webkit:webkit:1.3.0-alpha03
。1.3.0-alpha03 版包含此連結所列的修訂項目。
API 變更
addWebMessageListener
方法現在會接收系統允許的來源規則Set<String>
(先前為List<String>
)。
1.3.0-alpha02 版本
2020 年 4 月 29 日
發布 androidx.webkit:webkit:1.3.0-alpha02
。查看 1.3.0-alpha02 版的修訂項。
新功能
- 使用 MultiProcessEnabled API 可檢查 WebView 是否在多程序模式中執行。
API 變更
- 所有深色策略常數現在前面都會加上
DARK_STRATEGY
。
1.3.0-alpha01 版本
2020 年 4 月 15 日
發布 androidx.webkit:webkit:1.3.0-alpha01
。1.3.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 使用
ForceDarkStrategy
API 可控制WebView
調暗 (CSS/網路內容調暗或自動調暗)。 WebMessageListener
API 提供一種簡單又安全的機制,可用來建立網頁內容和 WebView 嵌入式應用程式之間的通訊內容。
1.2.0 版本
1.2.0 版本
2020 年 3 月 4 日
發布 androidx.webkit:webkit:1.2.0
。1.2.0 版包含此連結所列的修訂項目。
自 1.1.0 版本以來的重大異動
- 新增 ForceDark API 以控制 WebView 是否應以深色模式轉譯。
1.2.0-rc01 版本
2020 年 2 月 19 日
androidx.webkit:webkit:1.2.0-rc01
自 1.2.0-beta01
起沒有變更。1.2.0-rc01 版包含此連結所列的修訂項目。
1.2.0-beta01 版本
2020 年 2 月 5 日
androidx.webkit:webkit:1.2.0-beta01
發布,且自 1.2.0-alpha01
版以來皆無異動。1.2.0-beta01 版包含此連結所列的修訂項目。
1.2.0-alpha01 版本
2019 年 12 月 18 日
發布了 androidx.webkit:webkit:1.2.0-alpha01
。1.2.0-alpha01 版本包含這些修訂版本。
新功能
- 使用 ForceDark API 可控制 WebView 是否應以深色模式轉譯。
1.1.0 版本
1.1.0 版本
2019 年 11 月 7 日
發布了 androidx.webkit:webkit:1.1.0
。1.1.0 版包含此連結所列的修訂項目。
自 1.0.0 版以來的重要變更
- 搭配 setWebViewClient() 和 setWebChromeClient() 使用 Getter API。
- 使用 ProxyController API 可針對應用程式的 WebView 設定網路要求 Proxy。
- 使用 WebViewAssetLoader API 可簡化透過要求攔截從應用程式資料目錄載入 APK 資產、資源和檔案。如此就可允許存取網路和本機資源,無須停用 CORS。
- 使用 TracingController API 可出於偵錯目的收集 WebView 追蹤資訊。
- 使用 RenderProcess API 可管理 WebView 轉譯器服務,以及偵測是否有因表現不良的內容而造成 WebView 轉譯器沒有回應。
- 更新現有的 API,加入是否可為空值 (
@NonNull
、@Nullable
) 和執行緒 (@UiThread
、@WorkerThread
) 註解。
1.1.0-rc01 版本
2019 年 10 月 9 日
發布了 androidx.webkit:webkit:1.1.0-rc01
。1.1.0-rc01 版包含這些修訂版本。
修正錯誤
- 修正如果傳遞空值用戶端就可能造成
setWebViewRenderProcessClient()
停止運作的問題。
1.1.0-beta01 版本
2019 年 9 月 5 日
發布了 androidx.webkit:webkit:1.1.0-beta01
。您可以前往這裡查看這個版本包含的修訂項目。
新功能
- 使用
WebViewAssetLoader
的新InternalStoragePathHandler
可載入應用程式資料目錄中的檔案。
API 變更
ProxyConfig#getProxyRules()
現在會回傳無法修改的ProxyRule
執行個體清單,這是一種新類別,可保存配置篩選器及其對應的 Proxy 網址。
修正錯誤
WebViewAssetLoader
的預設值為「text/plain」無法判斷檔案路徑的 MIME 類型時,MIME 類型 (而不是空值)。- 載入路徑名稱中含有特殊字元的檔案時,
WebViewAssetLoader
不會再捨棄NullPointerException
。
1.1.0-alpha02 版本
2019 年 8 月 7 日
發布 androidx.webkit:webkit:1.1.0-alpha02
。您可以前往這裡查看這個版本包含的修訂項目。
新功能
WebViewAssetLoader
會公開PathHandler
介面,允許應用程式建立自訂路徑處理功能。
API 變更
- 由於
WebViewAssetLoader
不應為子類別,因此現在為最終類別。 WebViewAssetLoader#PathHandler
的實作方式目前為公開且為最終。- ProxyConfig 方法名稱的小幅度變更。
ProxyController
:加入新方法addDirect()
和addDirect(String)
以直接連接至伺服器;已移除 DIRECT 字串。- 更新現有的 API,加入是否可為空值 (
@NonNull
、@Nullable
) 和執行緒 (@UiThread
、@WorkerThread
) 註解。
1.1.0-alpha01 版本
2019 年 5 月 7 日
發布了 androidx.webkit:webkit:1.1.0-alpha01
。您可以前往這裡查看這個版本包含的修訂項目。
新功能
- 使用 Getter API 補充
setWebViewClient()
和setWebChromeClient()
- 使用 ProxyController API 可針對應用程式的 WebView 設定網路要求 Proxy。
- 使用 AssetLoader API,可透過要求攔截簡化 APK 資產和資源載入,讓使用者不需停用 CORS 即可存取網路資源。
- 使用 TracingController API 可出於偵錯目的收集 WebView 追蹤資訊。
- 使用 RenderProcess API 可管理 WebView 轉譯器服務,以及偵測是否有因表現不良的內容而造成 WebView 轉譯器沒有回應。
修正錯誤
- 針對現有 API 的文件格式設定小幅度修正。