Webkit

Tài liệu tham khảo API
androidx.webkit

Hoạt động với API WebView hiện đại trên Android 5 trở lên.

Bản cập nhật mới nhất	Bản phát hành ổn định	Bản phát hành dùng thử	Bản phát hành beta	Bản phát hành Alpha
Ngày 29 tháng 6 năm 2022	1.4.0	-	1.5.0-beta01	-

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Webkit, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

Groovy

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

Kotlin

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

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.5.0

Phiên bản 1.5.0-beta01

Ngày 29 tháng 6 năm 2022

Phát hành androidx.webkit:webkit:1.5.0-beta01. Phiên bản beta 1.5.0 bao gồm các thay đổi sau.

Thay đổi API

Các API liên quan đến Alogrithimic Darkening nay được chú thích để đòi hỏi API cấp Q. API này sẽ không có ảnh hưởng nào đến API có cấp độ thấp hơn Q, vì những thiết bị này không hỗ trợ giao diện tối. (I0905e)

Phiên bản 1.5.0-alpha01

Ngày 18 tháng 5 năm 2022

Phát hành androidx.webkit:webkit:1.5.0-alpha01. Phiên bản 1.5.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Thêm một phương thức getVariationsHeader() mới trên WebViewCompat để nhận giá trị tiêu đề X-Client-Data do WebView gửi. Giá trị được trả về sẽ là một protobuf ClientVariations được mã hóa dưới dạng base64.
Thêm API trên WebSettingsCompat để cho phép/không cho phép thuật toán làm tối đối với ứng dụng có targetSdk >= 33. (I29597)

Thay đổi API

Thêm một phương thức mới trong ProxyCofig.Builder để thiết lập chế độ bỏ qua đảo ngược. Đặt chế độ bỏ qua đảo ngược thành true có nghĩa là chỉ các URL trong danh sách bỏ qua mới sử dụng cài đặt proxy. (I9eaa2, b/168728599)

Sửa lỗi

Đã sửa lỗi chính tả trong tài liệu có giao diện tối. (I36ebf, b/194343633)
Đã khắc phục lỗi trong đó các phương thức WebViewAssetLoader.Builder vô tình phụ thuộc vào đơn đặt hàng. (If420d, b/182196765)

Phiên bản 1.4.0

Ngày 16 tháng 12 năm 2020

Phát hành androidx.webkit:webkit:1.4.0. Phiên bản 1.4.0 bao gồm các thay đổi sau.

Những thay đổi lớn kể từ phiên bản 1.3.0

Thêm một API setSafeBrowsingAllowlist() mới để thay thế setSafeBrowsingWhitelist(). Điều này giúp ứng dụng cập nhật mã của chúng để tránh thuật ngữ không dành cho tất cả mọi người trong khi vẫn hỗ trợ cùng một phạm vi các SDK Android và phiên bản WebView như API không dùng nữa.
Khắc phục lỗi trong setProxyOverride khiến quy tắc dự phòng không được áp dụng chính xác.

Phiên bản 1.4.0-rc02

Ngày 2 tháng 12 năm 2020

Phát hành androidx.webkit:webkit:1.4.0-rc02. Phiên bản 1.4.0-rc02 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục các quy tắc dự phòng không được áp dụng chính xác khi sử dụng setProxyOverride.

Phiên bản 1.4.0-rc01

Ngày 11 tháng 11 năm 2020

androidx.webkit:webkit:1.4.0-rc01 được phát hành mà không có thay đổi nào kể từ 1.4.0-beta01. Phiên bản 1.4.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.4.0-beta01

Ngày 14 tháng 10 năm 2020

androidx.webkit:webkit:1.4.0-beta01 được phát hành mà không có thay đổi nào kể từ 1.4.0-alpha01. Phiên bản 1.4.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.4.0-alpha01

Ngày 16 tháng 9 năm 2020

Phát hành androidx.webkit:webkit:1.4.0-alpha01. Phiên bản 1.4.0-alpha01 bao gồm các thay đổi sau.

Thay đổi về API

Thêm một API WebViewCompat#setSafeBrowsingAllowlist() mới để thay thế setSafeBrowsingWhitelist(). Điều này giúp ứng dụng cập nhật mã của chúng để tránh thuật ngữ không dành cho tất cả mọi người trong khi vẫn hỗ trợ cùng một phạm vi các SDK Android và phiên bản WebView như API không dùng nữa. (I8d65d)

Phiên bản 1.3.0

Ngày 19 tháng 8 năm 2020

Phát hành androidx.webkit:webkit:1.3.0. Phiên bản 1.3.0 bao gồm các thay đổi sau.

Thay đổi lớn kể từ phiên bản 1.2.0

API ForceDarkStrategy cung cấp nhiều quyền kiểm soát hơn trong chế độ làm tối WebView (chế độ làm tối nội dung CSS/web so với chế độ làm tối tự động).
WebMessageListener và các API liên quan của nó cung cấp một cơ chế đơn giản và an toàn để thiết lập hoạt động giao tiếp giữa nội dung web và ứng dụng nhúng WebView.
API isMultiProcessEnabled để kiểm tra xem WebView có đang chạy trong nhiều tiến trình hay không. Điều này có thể bắt đầu trong Android O và có nghĩa là nội dung web hiển thị trong quy trình kết xuất hình ảnh hộp cát riêng biệt với quy trình đăng ký. Quy trình kết xuất hình ảnh hộp cát này có thể được chia sẻ với các WebView khác trong cùng một ứng dụng nhưng không được chia sẻ với các quy trình đăng ký khác.

Phiên bản 1.3.0-rc02

Ngày 5 tháng 8 năm 2020

Phát hành androidx.webkit:webkit:1.3.0-rc02. Phiên bản 1.3.0-rc02 bao gồm các thay đổi sau.

Sửa lỗi

Phiên bản này khắc phục sự cố về khả năng tương thích, trong đó đôi khi WebMessageListener gặp sự cố trong quá trình phát triển cục bộ nếu ứng dụng của bạn khởi động bằng trạng thái chạy tức thì Android Studio.

Phiên bản 1.3.0-rc01

Ngày 24 tháng 6 năm 2020

androidx.webkit:webkit:1.3.0-rc01 được phát hành mà không có thay đổi nào kể từ 1.3.0-beta01. Phiên bản 1.3.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.3.0-beta01

Ngày 10 tháng 6 năm 2020

Phát hành androidx.webkit:webkit:1.3.0-beta01. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.

Tính năng mới

API ForceDarkStrategy để kiểm soát chế độ làm tối WebView (làm tối nội dung CSS/web tối so với chế độ làm tối tự động).
API WebMessageListener cung cấp một cơ chế đơn giản và an toàn để thiết lập hoạt động giao tiếp giữa nội dung web và ứng dụng nhúng WebView.
API MultiProcessEnabled để kiểm tra xem WebView có đang chạy trong chế độ đa tiến trình hay không.

Phiên bản 1.3.0-alpha03

Ngày 27 tháng 5 năm 2020

Phát hành androidx.webkit:webkit:1.3.0-alpha03. Phiên bản 1.3.0-alpha03 bao gồm các thay đổi sau.

Thay đổi về API

Phương thức addWebMessageListener hiện nhận Set<String> theo các quy tắc gốc được phép (trước đây là List<String>).

Phiên bản 1.3.0-alpha02

Ngày 29 tháng 4 năm 2020

Phát hành androidx.webkit:webkit:1.3.0-alpha02. Phiên bản 1.3.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

API MultiProcessEnabled để kiểm tra xem WebView có đang chạy trong chế độ đa tiến trình hay không.

Thay đổi về API

Giờ đây, tất cả hằng số chiến lược làm tối đều có tiền tố là DARK_STRATEGY.

Phiên bản 1.3.0-alpha01

Ngày 15 tháng 4 năm 2020

Phát hành androidx.webkit:webkit:1.3.0-alpha01. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

API ForceDarkStrategy để kiểm soát chế độ làm tối WebView (làm tối nội dung CSS/web tối so với chế độ làm tối tự động).
API WebMessageListener cung cấp một cơ chế đơn giản và an toàn để thiết lập hoạt động giao tiếp giữa nội dung web và ứng dụng nhúng WebView.

Phiên bản 1.2.0

Ngày 4 tháng 3 năm 2020

Phát hành androidx.webkit:webkit:1.2.0. Phiên bản 1.2.0 bao gồm các thay đổi sau.

Thay đổi lớn từ phiên bản 1.1.0

Thêm API ForceDark để kiểm soát xem có nên hiển thị WebView ở chế độ làm tối hay không.

Phiên bản 1.2.0-rc01

Ngày 19 tháng 2 năm 2020

androidx.webkit:webkit:1.2.0-rc01 được phát hành mà không có thay đổi nào kể từ 1.2.0-beta01. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.

Phiên bản 1.2.0-beta01

Ngày 5 tháng 2 năm 2020

androidx.webkit:webkit:1.2.0-beta01 được phát hành mà không có thay đổi nào kể từ 1.2.0-alpha01. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.2.0-alpha01

Ngày 18 tháng 12 năm 2019

Phát hành androidx.webkit:webkit:1.2.0-alpha01. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

API ForceDark để kiểm soát xem có nên hiển thị WebView ở chế độ làm tối hay không.

Phiên bản 1.1.0

Ngày 7 tháng 11 năm 2019

Phát hành androidx.webkit:webkit:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Thay đổi quan trọng kể từ phiên bản 1.0.0

API phương thức Getter để bổ sung cho setWebViewClient() và setWebChromeClient().
API ProxyController để đặt proxy yêu cầu mạng cho WebView của ứng dụng.
API WebViewAssetLoader để đơn giản hoá việc tải các thành phần, tài nguyên và tệp của APK từ thư mục dữ liệu ứng dụng thông qua tính năng chặn yêu cầu. Điều này cho phép truy cập vào tài nguyên web và tài nguyên trên máy mà không cần tắt CORS.
API TracingController để thu thập thông tin theo dõi WebView cho mục đích gỡ lỗi.
API RenderProcess để quản lý các dịch vụ trình kết xuất hình ảnh WebView và phát hiện nội dung hoạt động kém hiệu quả khiến các trình kết xuất WebView không phản hồi.
Cập nhật các API hiện tại để bao gồm các chú thích (@NonNull, @Nullable) và chuỗi (@UiThread, @WorkerThread) có tính chất rỗng.

Phiên bản 1.1.0-rc01

Ngày 9 tháng 10 năm 2019

Phát hành androidx.webkit:webkit:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

Khắc phục lỗi trong đó setWebViewRenderProcessClient() có thể gặp sự cố nếu chuyển máy khách rỗng.

Phiên bản 1.1.0-beta01

Ngày 5 tháng 9 năm 2019

Phát hành androidx.webkit:webkit:1.1.0-beta01. Bạn có thể xem các thay đổi trong phiên bản này tại đây.

Tính năng mới

InternalStoragePathHandler mới trong WebViewAssetLoader để tải tệp từ thư mục dữ liệu của ứng dụng.

Thay đổi về API

Giờ đây, ProxyConfig#getProxyRules() trả về danh sách các phiên bản ProxyRule không thể sửa đổi. Lớp này là một lớp mới có chứa bộ lọc giao thức và URL proxy tương ứng.

Sửa lỗi

WebViewAssetLoader mặc định là loại MIME "text/plain" (thay vì rỗng) khi không thể dự đoán loại MIME từ đường dẫn tệp.
WebViewAssetLoader không còn gửi NullPointerException khi tải các tệp có các ký tự đặc biệt trong tên đường dẫn nữa.

Phiên bản 1.1.0-alpha02

Ngày 7 tháng 8 năm 2019

Phát hành androidx.webkit:webkit:1.1.0-alpha02. Bạn có thể xem các thay đổi trong phiên bản này tại đây.

Tính năng mới

WebViewAssetLoader hiển thị giao diện PathHandler để cho phép các ứng dụng tạo chức năng xử lý đường dẫn tuỳ chỉnh.

Thay đổi về API

Giờ đây, WebViewAssetLoader là lớp cuối cùng vì lớp này không được phân lớp con.
Các nội dung triển khai WebViewAssetLoader#PathHandler giờ được công khai và là cuối cùng.
Các thay đổi nhỏ đối với tên phương thức ProxyConfig.
ProxyController: đã thêm các phương thức mới addDirect() và addDirect(String) để kết nối trực tiếp với máy chủ; đã xoá chuỗi DIRECT.
Cập nhật các API hiện tại để bao gồm các chú thích (@NonNull, @Nullable) và chuỗi (@UiThread, @WorkerThread) có tính chất rỗng.

Phiên bản 1.1.0-alpha01

Ngày 7 tháng 5 năm 2019

androidx.webkit:webkit:1.1.0-alpha01 được phát hành. Bạn có thể xem các thay đổi trong phiên bản này tại đây.

Tính năng mới

Các API phương thức Getter bổ sung cho setWebViewClient() và setWebChromeClient()
API ProxyController để đặt proxy yêu cầu mạng cho WebView của ứng dụng.
API AssetLoader để đơn giản hoá việc tải các thành phần và tài nguyên của APK thông qua tính năng chặn yêu cầu, cho phép truy cập vào các tài nguyên web mà không cần tắt CORS.
API TracingController để thu thập thông tin theo dõi WebView cho mục đích gỡ lỗi.
API RenderProcess để quản lý các dịch vụ trình kết xuất hình ảnh WebView và phát hiện nội dung hoạt động kém hiệu quả khiến các trình kết xuất WebView không phản hồi.

Sửa lỗi

Các bản sửa lỗi nhỏ về định dạng tài liệu cho API hiện tại.