Ứng dụng Công cụ cho nhà phát triển WebView là một tiện ích trên thiết bị để quản lý và gỡ lỗi chính thành phần WebView của hệ thống. Công cụ này tách biệt với Công cụ cho nhà phát triển Chrome, chạy trên máy phát triển và cho phép bạn gỡ lỗi từ xa nội dung web trực tiếp (HTML, CSS và JavaScript) đang chạy trong một phiên bản WebView.
Công cụ cho nhà phát triển WebView là một ứng dụng đồng hành được tự động cài đặt trên thiết bị của bạn cùng với thành phần hệ thống WebView. Ứng dụng này được chia thành 4 khu vực:
- Trang chủ: Xem thông tin phiên bản và chuyển WebView mặc định sang phiên bản kênh phát hành trước.
- Sự cố: Liệt kê và tải báo cáo sự cố WebView lên.
- Cờ: Đặt cờ nhà phát triển để thay đổi hành vi của WebView.
- Nhật ký mạng: Liệt kê và chia sẻ nhật ký mạng cấp thấp của WebView.
Chạy Công cụ cho nhà phát triển WebView
Trên các thiết bị chạy Android 16 trở lên và đã bật Chế độ nhà phát triển, bạn có thể chạy WebView DevTools bằng cách chuyển đến phần Cài đặt > Hệ thống > Tuỳ chọn cho nhà phát triển > WebView DevTools.
Trên tất cả các bản phát hành Android gần đây, bạn có thể chạy WebView DevTools bằng lệnh adb:
adb shell am start -a "com.android.webview.SHOW_DEV_UI"
Ngoài ra, nếu cài đặt một kênh phát hành trước của WebView, chẳng hạn như Beta, Dev hoặc Canary, bạn có thể sử dụng biểu tượng trình chạy Công cụ cho nhà phát triển WebView.
Trong lần đầu tiên bạn chạy WebView DevTools, công cụ này sẽ yêu cầu quyền nhận thông báo để hiện một thông báo liên tục liệt kê các cờ dành cho nhà phát triển mà bạn bật.
Chuyển sang kênh phát hành trước
Các tính năng và bản sửa lỗi mới nhất của WebView sẽ được cung cấp trước tiên trong các kênh phát hành trước. Bạn có thể kiểm thử ứng dụng của mình dựa trên những thay đổi này bằng cách chuyển đổi nhà cung cấp WebView của thiết bị bằng WebView DevTools. Việc kiểm thử trên các kênh phát hành trước giúp đảm bảo ứng dụng của bạn tương thích với các phiên bản WebView sắp ra mắt trước khi phát hành cho người dùng.
- Cài đặt phiên bản Beta, Dev hoặc Canary của WebView, tuỳ thuộc vào sự đánh đổi mà bạn muốn giữa độ ổn định và quyền truy cập vào các thay đổi mới nhất.
- Mở ứng dụng WebView DevTools rồi nhấn vào Change Provider (Thay đổi nhà cung cấp).
- Nếu bạn không thấy lựa chọn đó, hãy nhấn vào biểu tượng 3 dấu chấm ở góc trên cùng bên phải rồi chọn Thay đổi nhà cung cấp WebView.
Để biết thêm thông tin, hãy xem bài viết Dùng thử WebView Beta, Dev hoặc Canary.
Kênh WebView
Các kênh WebView dựa trên các kênh phát hành của Chrome. Mỗi kênh đại diện cho một mức độ ổn định và mới mẻ khác nhau của mã. Sau đây là thông tin tóm tắt nhanh về thời điểm sử dụng từng kênh WebView:
Canary: Cập nhật hằng ngày. Kênh này có những thay đổi mới nhất, bao gồm cả các tính năng mới và bản sửa lỗi ngay khi chúng được hợp nhất vào cơ sở mã Chromium. Hãy sử dụng kênh này nếu bạn muốn kiểm thử cách ứng dụng web của mình chạy trong WebView với một thay đổi mới được hợp nhất, nhưng hãy lưu ý rằng kênh này có thể không ổn định hoặc chứa lỗi.
Dev: Cập nhật 1 hoặc 2 lần mỗi tuần. Kênh này ổn định hơn Canary nhưng vẫn chứa những thay đổi mới nhất. Đây là lựa chọn phù hợp nhất cho những nhà phát triển muốn thử nghiệm các tính năng mới nhưng ít gặp phải lỗi không liên quan hơn so với Canary.
Beta: Cập nhật khoảng mỗi tuần một lần, với một bản cập nhật lớn mỗi 4 tuần. Kênh này cho phép bạn xem trước các tính năng trong bản phát hành ổn định tiếp theo của WebView khoảng 4 đến 6 tuần trước khi bản phát hành ổn định ra mắt. Sử dụng tính năng này để kiểm thử ứng dụng web của bạn với bản phát hành WebView sắp tới nhằm xác minh khả năng tương thích.
Ổn định: Cập nhật 4 tuần một lần đối với các bản phát hành chính, với các bản phát hành nhỏ 2 – 3 tuần một lần đối với các bản sửa lỗi khẩn cấp. Đây là kênh phát hành công khai của WebView, được phát hành cho tất cả người dùng. Đây là kênh ổn định nhất, đã trải qua quá trình kiểm thử ở các kênh khác. Hãy sử dụng lựa chọn này nếu bạn muốn trải nghiệm ứng dụng web của mình trong WebView theo cách mà hầu hết người dùng đang làm hiện tại, có thể là để tái hiện một lỗi mà họ đã báo cáo.
Giao diện người dùng khi gặp sự cố
Nếu gặp sự cố WebView trong khi phát triển ứng dụng, bạn có thể liệt kê, tải lên và gửi báo cáo lỗi cho các sự cố đó bằng WebView DevTools.
- Sau khi ứng dụng gặp sự cố, hãy khởi động lại ứng dụng để đảm bảo báo cáo sự cố được tạo.
- Mở ứng dụng WebView DevTools rồi nhấn vào Sự cố.
Để biết thêm thông tin, hãy xem tài liệu về Giao diện người dùng gặp sự cố.
Giao diện người dùng gắn cờ
Ứng dụng Công cụ cho nhà phát triển WebView cho phép bạn đặt một số cờ hữu ích để thay đổi hành vi của tất cả WebView trên thiết bị. Hầu hết các cờ chỉ được dùng để phát triển chính WebView, nhưng một số cờ hữu ích cho nhà phát triển ứng dụng Android.
highlight-all-webviews: Xác định WebView bằng cách thêm một tông màu vàng lên trên WebView.net-log: Bật tính năng ghi nhật ký cấp thấp về hoạt động mạng của WebView.webview-log-js-console-messages: Làm cho nhật ký bảng điều khiển JavaScript xuất hiện trong Logcat.
Để biết thêm thông tin, hãy xem tài liệu về Giao diện người dùng cờ.
Nhật ký mạng
Nếu bạn không thể giải quyết các vấn đề về kết nối máy chủ trong WebView bằng Công cụ của Chrome cho nhà phát triển, hãy sử dụng WebView DevTools để ghi lại nhật ký mạng cấp thấp.
- Bật tính năng gỡ lỗi WebView trong mã ứng dụng của bạn.
- Trong Công cụ cho nhà phát triển WebView, hãy mở Cờ, tìm
net-logrồi bật cờ này. Khởi động lại ứng dụng để cờ này có hiệu lực. - Thực hiện các thao tác kích hoạt hành vi mạng mà bạn muốn gỡ lỗi. Sau khi bạn tái hiện được vấn đề, hãy đóng ứng dụng.
- Mở phần Nhật ký mạng của Công cụ cho nhà phát triển WebView để xác định vị trí và chia sẻ tệp nhật ký mạng.
- Bạn có thể tải tệp nhật ký JSON vào Netlog Viewer (một công cụ trực tuyến để trực quan hoá nhật ký mạng) nhằm kiểm tra các sự kiện mạng cấp thấp, thông tin về ổ cắm và thông tin chi tiết về thời gian.
Để biết thêm thông tin, hãy xem bài viết Gỡ lỗi mạng trong WebView.