Bạn có thể gặp khó khăn khi thiết lập Hoạt động đáng tin cậy trên web, đặc biệt là nếu bạn chỉ muốn hiển thị trang web của mình. Hướng dẫn này sẽ hướng dẫn bạn cách tạo một dự án nhỏ sử dụng Hoạt động đáng tin cậy trên web.
Khi đọc xong hướng dẫn này, bạn sẽ:
- Đã sử dụng Bubblewrap để tạo một ứng dụng sử dụng Hoạt động đáng tin cậy trên web và vượt qua quy trình xác minh.
- Tìm hiểu thời điểm khoá ký được sử dụng.
- Có thể xác định chữ ký mà Ứng dụng Android của bạn đang được tạo.
- Biết cách tạo tệp Digital Asset Links cơ bản.
Để làm theo hướng dẫn này, bạn cần:
- Node.js 10 trở lên.
- Một trình mô phỏng hoặc điện thoại Android đã kết nối và được thiết lập để phát triển. Bật tính năng gỡ lỗi qua USB nếu bạn đang sử dụng điện thoại thực.
- Một trình duyệt di động hỗ trợ Hoạt động đáng tin cậy trên web.
- Một trang web mà bạn muốn xem trong Hoạt động đáng tin cậy trên web.
Bạn có thể dùng một Hoạt động đáng tin cậy trên web cho Ứng dụng Android để chạy một thẻ trình duyệt ở chế độ toàn màn hình mà không có giao diện người dùng trình duyệt. Chức năng này chỉ dành cho những trang web mà bạn sở hữu. Bạn chứng minh quyền sở hữu bằng cách thiết lập Digital Asset Links.
Khi bạn khởi chạy một Hoạt động đáng tin cậy trên web, trình duyệt sẽ xác minh Digital Asset Links. Nếu xác minh không thành công, trình duyệt sẽ quay lại hiển thị trang web của bạn dưới dạng Thẻ tuỳ chỉnh.
Cài đặt và định cấu hình Bubblewrap
Bubblewrap là một tập hợp các thư viện và công cụ dòng lệnh (CLI) cho Node.js, giúp nhà phát triển tạo, xây dựng và chạy Ứng dụng web tiến bộ trong các ứng dụng Android bằng cách sử dụng Hoạt động đáng tin cậy trên web.
Cài đặt CLI bằng cách chạy lệnh sau:
npm i -g @bubblewrap/cli
Thiết lập môi trường
Khi chạy Bubblewrap lần đầu tiên, ứng dụng này sẽ tự động tải xuống và cài đặt các phần phụ thuộc bên ngoài cần thiết. Bạn nên cho phép tải xuống tự động vì việc này giúp đảm bảo các phần phụ thuộc được định cấu hình chính xác. Hãy xem tài liệu về Bubblewrap để sử dụng Bộ công cụ phát triển Java (JDK) hoặc bản cài đặt công cụ dòng lệnh Android hiện có.
Khởi chạy và tạo dự án
Khởi chạy một dự án Android bao bọc một PWA:
bubblewrap init --manifest=https://my-twa.com/manifest.json
Bubblewrap đọc Tệp kê khai web, yêu cầu nhà phát triển xác nhận các giá trị sẽ được dùng trong dự án Android và tạo dự án bằng các giá trị đó.
Sau khi dự án được tạo, hãy tạo một APK bằng cách chạy:
bubblewrap build
Chạy
Bước tạo sẽ xuất ra một tệp có tên là app-release-signed.apk. Bạn có thể cài đặt tệp này trên một thiết bị phát triển để kiểm thử hoặc tải lên Cửa hàng Play để phát hành.
Bubblewrap cung cấp một lệnh để cài đặt và kiểm thử ứng dụng trên thiết bị cục bộ. Khi thiết bị phát triển được kết nối với máy tính, hãy chạy:
bubblewrap install
Ngoài ra, bạn có thể sử dụng công cụ adb.
adb install app-release-signed.apk
Giờ đây, ứng dụng sẽ xuất hiện trên trình chạy thiết bị.
Khi mở ứng dụng, bạn sẽ nhận thấy rằng trang web của bạn được chạy dưới dạng Thẻ tuỳ chỉnh, chứ không phải Hoạt động đáng tin cậy trên web. Lý do là chúng tôi chưa thiết lập quy trình xác thực Đường liên kết đến tài sản kỹ thuật số.
Các lựa chọn thay thế Giao diện người dùng đồ hoạ (GUI) cho Bubblewrap
PWA Builder cung cấp một giao diện GUI sử dụng thư viện Bubblewrap để hỗ trợ việc tạo các dự án Hoạt động đáng tin cậy trên web. Tìm hướng dẫn về cách dùng PWA Builder để tạo một ứng dụng Android mở PWA của bạn.
Khoá ký
Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số) có tính đến khoá mà một APK đã được ký và nguyên nhân thường gặp khiến quy trình xác minh không thành công là do sử dụng chữ ký không chính xác. (Xin lưu ý rằng nếu không xác minh được, bạn sẽ khởi chạy trang web dưới dạng Thẻ tuỳ chỉnh có giao diện người dùng trình duyệt ở đầu trang.) Khi Bubblewrap tạo ứng dụng, một APK sẽ được tạo bằng một khoá thiết lập trong bước init. Tuy nhiên, khi bạn xuất bản ứng dụng trên Google Play, một khoá khác có thể được tạo cho bạn, tuỳ thuộc vào cách bạn chọn xử lý khoá ký. Tìm hiểu thêm về khoá ký và mối quan hệ giữa khoá ký với Bubblewrap và Google Play.
Thiết lập tệp liên kết tài sản
Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số) về cơ bản bao gồm một tệp trên trang web của bạn trỏ đến ứng dụng và một số siêu dữ liệu trong ứng dụng trỏ đến trang web của bạn.
Sau khi tạo tệp assetlinks.json, hãy tải tệp này lên trang web của bạn tại .well-known/assetlinks.json so với thư mục gốc) để trình duyệt có thể xác minh ứng dụng của bạn đúng cách. Hãy xem bài viết nghiên cứu chuyên sâu về Digital Asset Links để biết thêm thông tin về mối quan hệ giữa tính năng này với khoá ký của bạn.
Kiểm tra trình duyệt
Hoạt động đáng tin cậy trên web sẽ cố gắng tuân thủ lựa chọn mặc định của người dùng về trình duyệt. Nếu trình duyệt mặc định của người dùng hỗ trợ Hoạt động đáng tin cậy trên web, thì trình duyệt đó sẽ được khởi chạy. Nếu không, hệ thống sẽ chọn bất kỳ trình duyệt nào đã cài đặt có hỗ trợ Hoạt động đáng tin cậy trên web. Cuối cùng, hành vi mặc định là quay lại chế độ Thẻ tuỳ chỉnh.
Điều này có nghĩa là nếu đang gỡ lỗi liên quan đến Hoạt động đáng tin cậy trên web, bạn nên đảm bảo rằng mình đang sử dụng trình duyệt mà bạn nghĩ là mình đang dùng. Bạn có thể sử dụng lệnh sau để kiểm tra xem trình duyệt nào đang được dùng:
> adb logcat -v brief | grep -e TWAProviderPicker
D/TWAProviderPicker(17168): Found TWA provider, finishing search: com.google.android.apps.chrome
Các bước tiếp theo
Hy vọng rằng nếu đã làm theo hướng dẫn này, bạn sẽ có một Trusted Web Activity đang hoạt động và đủ kiến thức để gỡ lỗi nếu quy trình xác minh không thành công. Nếu không, hãy xem thêm các khái niệm về Android dành cho nhà phát triển web.
Để thực hiện các bước tiếp theo, hãy tạo biểu tượng cho ứng dụng. Sau khi hoàn tất, bạn có thể cân nhắc triển khai ứng dụng lên Cửa hàng Play.