Bài học này sẽ giúp bạn nâng cấp Todo App thành một ứng dụng Progressive Web App (PWA) – có thể cài như app trên điện thoại, chạy offline, và trải nghiệm như native app.
Mục tiêu:
- Cài plugin
vite-plugin-pwa
- Thêm file
manifest.json
- Thêm icon, splash screen
- Hoạt động offline, có thể install như app
Phần 1: Cài đặt plugin PWA cho Vite
Chạy lệnh:
npm install vite-plugin-pwa --save-dev
Phần 2: Cấu hình Vite để hỗ trợ PWA
vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import { VitePWA } from 'vite-plugin-pwa'
export default defineConfig({
plugins: [
vue(),
VitePWA({
registerType: 'autoUpdate',
includeAssets: ['favicon.svg', 'robots.txt', 'apple-touch-icon.png'],
manifest: {
name: 'Vue Todo App',
short_name: 'TodoApp',
description: 'Ứng dụng quản lý công việc bằng Vue + Pinia',
theme_color: '#2b8a3e',
background_color: '#ffffff',
display: 'standalone',
start_url: '/',
icons: [
{
src: 'pwa-192x192.png',
sizes: '192x192',
type: 'image/png'
},
{
src: 'pwa-512x512.png',
sizes: '512x512',
type: 'image/png'
}
]
}
})
]
})
Phần 3: Thêm các file vào thư mục public/
Tạo thư mục public/
nếu chưa có và đặt vào:
Tên file | Vai trò |
---|---|
pwa-192x192.png | Icon khi add to home screen |
pwa-512x512.png | Splash screen, logo to |
favicon.svg | Biểu tượng tab trình duyệt |
apple-touch-icon.png | iOS icon |
robots.txt | Cho SEO và Google crawler |
npm run build
npx serve dist
Truy cập vào http://localhost:5000
bạn sẽ thấy popup như:
“Install TodoApp?”
và bạn có thể cài ứng dụng như mobile app, chạy offline (có Service Worker), và khởi động nhanh hơn.
Kỹ năng | Vai trò |
---|---|
vite-plugin-pwa | Tự động cấu hình service worker, manifest |
manifest.json | Khai báo icon, tên app, màu sắc, chế độ hoạt động |
public/ assets | Cung cấp icon, splash, favicon |
offline cache | Cho phép truy cập kể cả không có mạng |
- Tùy chỉnh icon, màu sắc cho phù hợp thương hiệu riêng
- Hiển thị banner “Bạn có muốn cài ứng dụng?” khi người dùng online
- Tạo
offline.html
hiển thị khi mạng mất hoàn toàn
Thảo luận