Computer >> Hướng Dẫn Máy Tính >  >> Hệ Thống >> Android

Chuyển đổi Website thành Ứng dụng Android Native với Bubblewrap – Hướng dẫn từng bước

Chuyển đổi Website thành Ứng dụng Android Native với Bubblewrap – Hướng dẫn từng bước

Nếu bạn là web developer không biết về phát triển ứng dụng (như tôi!), thì bài viết này dành cho bạn. Tôi sẽ dạy bạn cách biến website thành ứng dụng native, không cần framework hay ngôn ngữ mới. Bạn sẽ học cách chuyển website thành PWA (Progressive Web App) để đăng tải lên Play Store.

Trước tiên, chúng ta sẽ biến website thành Progressive Web App (PWA). Sau đó dùng công cụ dòng lệnh miễn phí của Google tên là Bubblewrap để đóng gói PWA đó thành ứng dụng Android. Hãy bắt đầu.

Điều kiện tiên quyết

Nếu bạn làm theo hướng dẫn này, cần một số điều kiện:

  • Kiến thức cơ bản về phát triển web

  • Trang web phải công khai, và bạn cần truy cập mã nguồn của nó.

  • Chúng ta dùng npm để cài đặt công cụ, nên hãy chắc chắn đã cài Node.js.

Lưu ý: Hướng dẫn này dựa trên dự án Vite, nhưng các bước cuối cùng với Bubblewrap giống hệt nhau cho mọi web framework.

Mục lục

  1. PWA là gì?

  2. Bubblewrap là gì?

    • TWA (Trusted Web Activity) là gì?

    • Cách TWA xác minh sự tin cậy

  3. Bước 1 – Cấu hình PWA trong Vite

    • Tạo Icon ứng dụng

    • Cài plugin Vite PWA.

    • Cấu hình Plugin

  4. Bước 2 – Tạo ứng dụng Android

    • Tạo thư mục Build

    • Cài Bubblewrap CLI

    • Khởi tạo dự án

    • Khắc phục sự cố lệnh init.

  5. Bước 3 – Trả lời câu hỏi của Bubblewrap

  6. Bước 4 – Build ứng dụng

  7. Bước 5 – Thiết lập xác thực TWA

    • Thư mục .well-known là gì?

    • delegate_permission/common.handle_all_urls là gì?

  8. Bước 6 (Tùy chọn) – Tùy chỉnh trải nghiệm trong App

  9. Tổng kết

PWA là gì?

PWA là viết tắt của Progressive Web Application, mục tiêu là làm website trông và cảm giác như ứng dụng native. Nếu bạn từng truy cập website trên trình duyệt và thấy biểu tượng cài đặt cho phép tải về điện thoại/laptop, bạn đã dùng PWA.

Nhưng không chỉ về giao diện. PWA còn có tính năng như ứng dụng: hoạt động offline, gửi push notification, và hơn nữa.

Có hai thành phần chính của PWA.

  • File manifest mô tả ứng dụng: tên, icon, start URL, v.v.

  • Service worker là file JavaScript nền hoạt động như proxy. Caching và push notification được xử lý bởi service worker, chạy trên luồng riêng biệt khỏi main thread.

Nếu thiếu hai thành phần này, trình duyệt sẽ không cho người dùng tải ứng dụng về local.

File manifest và service worker giống như danh sách kiểm tra cho trình duyệt. Khi bạn truy cập website, trình duyệt tìm cả hai. Nếu có và cấu hình đúng, trình duyệt biết đó là PWA thật sự và hiển thị biểu tượng "cài đặt", cho phép người dùng tải ứng dụng về local. Nếu thiếu, trình duyệt chỉ thấy website thường, và tùy chọn cài đặt sẽ không hiện.

Bubblewrap là gì?

Bubblewrap là công cụ dòng lệnh do Google tạo ra, lấy PWA của bạn và biến thành ứng dụng Android dùng Trusted Web Activity (TWA).

Bubblewrap đơn giản hóa việc tạo TWA, biến file manifest của PWA thành gói ứng dụng Android (APK hoặc AAB).

TWA (Trusted Web Activity) là gì?

Trusted Web Activity (TWA) là tính năng Android hiện đại cho phép hiển thị website trực tiếp toàn màn hình bên trong ứng dụng Android. Về cơ bản, nó chạy website trên trình duyệt, nhưng không hiển thị thanh địa chỉ trình duyệt trên App. Điều này giúp cảm giác như ứng dụng native.

Để mở khóa tính năng toàn màn hình này, ứng dụng của bạn cần được "Tin cậy" (Trusted).

Đây là nơi "bắt tay bí mật" xuất hiện. Android cần chắc chắn người xây dựng ứng dụng và người sở hữu website là cùng một. Nếu thiếu bằng chứng sở hữu, TWA sẽ chạy ở chế độ fallback và hiển thị thanh địa chỉ trình duyệt ở trên, làm mất cảm giác native.

Cách TWA xác minh sự tin cậy

Sự tin cậy này được xác minh bằng hệ thống Digital Asset Links. Bạn đặt một file đặc biệt trên website (chúng ta sẽ làm ở phần triển khai) chứa vân tay số độc nhất của ứng dụng. Khi người dùng mở ứng dụng, Android OS kiểm tra file này. Nếu vân tay khớp, nó cấp trạng thái "trusted" cho ứng dụng, xóa thanh địa chỉ, và bật các tính năng khác như deep linking.

Bạn có thể kiểm tra mối quan hệ này bằng công cụ chính thức của Google: Digital Asset Links Verifier.

Bây giờ bạn đã hiểu dự án và công cụ, hãy bắt đầu xây dựng.

Bước 1 – Cấu hình PWA trong Vite

Bước đầu là thêm hai thành phần chính cho PWA: file manifest và service worker. Đây là điều cho phép trình duyệt nhận diện nó là "có thể cài đặt".

Hướng dẫn này dựa trên dự án Vite, giúp quá trình này dễ dàng với plugin đặc biệt. Nếu bạn dùng công cụ khác, khái niệm giống nhau, nhưng bạn cần tra tài liệu cụ thể cho môi trường của mình.

Tạo Icon ứng dụng

Trước khi chạm code, chúng ta cần icon cho ứng dụng. Android yêu cầu kích thước cụ thể cho icon launcher (thấy trên màn hình chính) và splash screen (thấy khi app khởi động).

Bạn cần hai kích thước chính: 192x192 pixel và 512x512 pixel. Bạn có thể dùng Favicon Generator để tạo logo các kích thước cần thiết. Tải logo chính lên, nó sẽ tạo tất cả kích thước cần thiết.

Sau đó tải file tạo ra và đặt file 192x192 và 512x512 vào thư mục public của dự án.

Chuyển đổi Website thành Ứng dụng Android Native với Bubblewrap – Hướng dẫn từng bước

Cài plugin Vite PWA.

PWA cần file manifest và service worker. Chúng ta có thể tạo thủ công, nhưng plugin này tự động hóa toàn bộ quá trình. Nó sẽ tự động tạo manifest.json và service-worker.js mỗi khi bạn build dự án.

npm install vite-plugin-pwa -D 

Cấu hình Plugin

Ở bước này, chúng ta dùng plugin và cấu hình manifest ứng dụng. Chỉnh sửa file vite.config.ts. Cấu hình này nói cho plugin biết tên app, icon nào dùng, v.v.

Trong vite.config.ts:

export default defineConfig({ plugins: [ VitePWA({ registerType: "autoUpdate", manifest: { name: "tên ứng dụng của bạn", short_name: "tên ngắn ứng dụng", description: "viết mô tả bất kỳ", theme_color: "#0d1117", background_color: "#ffffff", display: "standalone", start_url: "/", icons: [ { src: "/web-app-manifest-192x192.png", sizes: "192x192", type: "image/png", }, { src: "/web-app-manifest-512x512.png", sizes: "512x512", type: "image/png", }, ], }, }), ] 

Bây giờ, khi chạy npm run build, plugin sẽ tự động tạo file manifest và service worker. Xong phần này, deploy thay đổi. Bây giờ website của bạn đã là PWA.

Bước 2 – Tạo ứng dụng Android

Website đã là PWA, giờ dùng Bubblewrap để đóng gói thành ứng dụng Android.

Tạo thư mục Build

Tạo thư mục chuyên biệt cho file dự án Android. Ở gốc dự án, tạo thư mục mới. Tôi đặt tên android.

project/ ├── client/ ├── server/ └── android/ 

Di chuyển vào thư mục mới tạo.

Cài Bubblewrap CLI

npm install -g @bubblewrap/cli 

Khởi tạo dự án

Tiếp theo, chạy lệnh init. Bubblewrap sẽ kết nối website của bạn, đọc file manifest.webmanifest do Vite tạo, và dùng thông tin đó để tạo dự án Android cơ bản.

bubblewrap init --manifest=https://your-website-domain/manifest.webmanifest 

Chạy lệnh, thay your-website-domain bằng URL thực tế:

Khắc phục sự cố lệnh init

Khi chạy init, Bubblewrap cần hai gói phần mềm quan trọng: Java Development Kit (JDK) và Android SDK. Nó sẽ đề xuất cài đặt giúp bạn.

Thiết lập JDK:

? Do you want Bubblewrap to install the JDK (recommended)? (Enter "No" to use your own JDK 17 installation) (Y/n) 

Trong trường hợp của tôi, khi để Bubblewrap cài JDK, quá trình tải file nhưng thất bại ở bước "giải nén". Nếu bạn gặp vấn đề tương tự, đừng lo! Khắc phục bằng cài thủ công.

  • Chọn No cho lời nhắc.

  • Tải phiên bản khuyến nghị (thường là JDK 17) từ nguồn như Adoptium.

  • Cài đặt và thiết lập biến môi trường hệ thống bao gồm đường dẫn bin của JDK. Nếu không chắc cách thiết lập biến môi trường, xem trang: Set Environment Variables.

  • Khi Bubblewrap hỏi đường dẫn, cung cấp trực tiếp, ví dụ C:\java\jdk-17.0.16.8-hotspot.

Thiết lập Android SDK:

Sau khi JDK ổn định, bước tiếp theo cấu hình Android SDK.

? Do you want Bubblewrap to install the Android SDK (recommended)? (Enter "No" to use your own Android SDK installation) (Y/n) 

Vì tôi chưa có Android SDK, tôi để Bubblewrap lo bằng cách chọn Yes. Không gặp vấn đề gì ở đây.

Nếu gặp sự kiện cài Android SDK, cứ cài thủ công và đưa đường dẫn như JDK.

Bước 3 – Trả lời câu hỏi của Bubblewrap

Sau khi SDK xong, Bubblewrap sẽ hỏi một loạt câu hỏi để cấu hình app. Thông tin này dùng để tạo file twa-manifest.json, bản thiết kế cho App.

Domain: Enter (tự điền từ manifest) Application name: Tên đầy đủ ứng dụng Application ID: (ví dụ: chat.yourapp.twa) Display mode: standalone Orientation: portrait Status bar color: Enter (chấp nhận mặc định) Splash screen color: Enter (chấp nhận mặc định) Icon URL: Enter (chấp nhận mặc định) Include support for Play Billing?: Gõ Y nếu app dùng mua trong ứng dụng Google Play. Ngược lại N Request geolocation permission?: Gõ Y nếu app cần quyền vị trí. Ngược lại N 

Trong các câu hỏi, phần quan trọng là key store và key.

First and Last names: Họ tên đầy đủ Organizational Unit: Developer hoặc bất kỳ Organization: Tên tổ chức Country (2-letter code): Mã quốc gia 2 chữ cái Password for key store: Nhập mật khẩu mới Password for key: Nhập lại cùng mật khẩu 

Lưu ý: Mật khẩu cho key store và key phải giống nhau, nếu không sẽ báo lỗi. Tham khảo issue này: Bubblewrap Issue.

Bước 4 – Build ứng dụng

bubblewrap build --universalApk 

Lệnh này bắt đầu build ứng dụng. Cờ universalApk sẽ tạo cả .apk và .aab. Nếu đăng tải lên Play Store, upload file .aab. Để test, cần file APK, nên cờ universalApk tạo cả hai. Nếu không có cờ này, chỉ tạo .aab.

Bước 5 – Thiết lập xác thực TWA

Sau khi build xong, bạn nhận được APK. Chuyển sang điện thoại test. Khi mở app, bạn sẽ thấy thanh địa chỉ trình duyệt. Đó là vì chưa thiết lập "niềm tin" giữa app và website. Hãy sửa ngay.

Trong dự án frontend, vào thư mục public, tạo thư mục mới tên .well-known, và bên trong tạo file assetlinks.json.

frontend/ ├── public/ ├── .well-known/ └── assetlinks.json 

Thư mục .well-known là gì?

Thư mục well-known dùng để lưu file định nghĩa cấu hình cho các giao thức, vì nó dùng cho nguồn bên ngoài tìm xác thực cho website của bạn. Trong trường hợp chúng ta, app kiểm tra thư mục well-known từ website và xác minh.

Dán sau vào assetlinks.json:

[ { "relation": ["delegate_permission/common.handle_all_urls"], "target": { "namespace": "android_app", "package_name": "chat.yourapp.twa", "sha256_cert_fingerprints": [ "your_sha256_fingerprint" ] } } ] 

delegate_permission/common.handle_all_urls là gì?

Đây là cờ đặc biệt mở tất cả link từ app thay vì domain. Nói đơn giản, nó hoạt động như deeplink. Sau khi cài app, nếu bạn click link website từ WhatsApp hay đâu đó, nó sẽ mở app thay vì trình duyệt, hoạt động như deeplink.

Trường package_name nên là packageId, lấy từ thư mục build Android trong twa-manifest.json.

Giờ lấy vân tay (fingerprint). Chạy lệnh sau:

keytool -list -v -keystore android.keystore -alias android 

Tên alias phải là giá trị bạn tạo lúc trước. Sau khi chạy lệnh, nó hỏi mật khẩu key store. Nhập vào, bạn sẽ nhận SHA256 fingerprint. Copy và dán vào file assetslinks.json ở mảng sha256_cert_fingerprints. Giờ push thay đổi lên production. Bạn có thể xác minh ở Digital Asset Links.

Xong! Bây giờ cài app và test.

Bước 6 (Tùy chọn) – Tùy chỉnh trải nghiệm trong App

Thêm vào đó, sẽ có trường hợp muốn hiển thị nội dung khác cho người dùng trên website so với mobile app. Có làm được không? Có!

Trong thư mục build Android, trong twa-manifest.json, sẽ có trường startUrl. Nếu chưa có, thêm vào với giá trị "startUrl": "/?twa=true". startUrl là điểm vào. Tôi dùng tham số truy vấn twa=true.

Chạy build lại với bubblewrap build --universalApk.

Giờ, nếu mở app, nó sẽ mở với URL vào là yourwebsitedomain.com/?twa=true.

Trong frontend:

const twaParam = queryParams.get("twa"); const [isTwa, setIsTwa] = useState<boolean>(() => { return localStorage.getItem("isTwa") === "true"; }); useEffect(() => { if (twaParam === "true") { localStorage.setItem("isTwa", "true"); // set giá trị vào local storage setIsTwa(true); } }, [twaParam]); 
 {isTwa? ( <Link to="/contact" className="underline hover:text-primary"> Contact </Link> ) : ( <Link to="/download" className="underline hover:text-primary"> Download App </Link> )} 

Trong code trên, chúng ta kiểm tra tham số twa=true trong URL. Nếu có, lưu thông tin vào local storage, sau đó render điều kiện nội dung cho người dùng.

Đó là tất cả. Chúng ta đã tạo được một App.

Nếu muốn đổi tên, màu, hay splash screen, bạn thay đổi trong twa-manifest.json và build lại.

Tổng kết

Bubblewrap chỉ dành cho Android. Nếu muốn app đa nền tảng, có các nền tảng khác như Capacitor, tôi sẽ viết bài khác.

Bạn có thể xem app tôi làm bằng Bubblewrap tại đây: Stranger Talk.

Nếu có sai sót hoặc thắc mắc, liên hệ tôi qua LinkedIn hoặc Instagram.

Cảm ơn bạn đã đọc!

Học lập trình miễn phí. Chương trình mở của freeCodeCamp đã giúp hơn 40.000 người có việc làm developer. Bắt đầu ngay