Xem Trước và Xuất Bản
Trước khi phát hành, hãy xem trước ứng dụng trong PWA Simulator tích hợp sẵn và dùng Try Mode để xác minh trải nghiệm trên thiết bị thực của bạn. Khi sẵn sàng, xuất bản chỉ với một cú nhấp.
PWA Simulator
PWA Simulator là mô phỏng điện thoại trong trình duyệt, hiển thị một iframe trực tiếp của ứng dụng cộng đồng. Tính năng này khả dụng trên tab Design mà không cần xuất bản.
Mở Trình Mô Phỏng
- Vào Cài đặt → Ứng Dụng Di Động → Design.
- Mô phỏng điện thoại ở bên trái là bản xem trước nội tuyến luôn hiển thị.
- Nhấn Reload Preview để làm mới iframe với cấu hình bản nháp mới nhất.
Trình Mô Phỏng Toàn Màn Hình
Hộp thoại trình mô phỏng toàn màn hình khả dụng để xem chi tiết hơn:
| Điều khiển | Mô tả |
|---|---|
| Bộ chọn thiết bị | Chuyển đổi giữa kiểu bo góc iPhone và Android |
| Đóng (X) / Escape | Đóng hộp thoại toàn màn hình |
| Iframe | Hiển thị /app/:tenant/feed — ứng dụng trực tiếp trong trình duyệt |
Trình mô phỏng chỉ là mô phỏng hình ảnh. Nó không mô phỏng kích thước viewport thiết bị. Để kiểm thử chính xác trên thiết bị thực, hãy dùng Try Mode.
Try Mode
Try Mode cho phép tất cả quản trị viên truy cập ứng dụng tại các đường dẫn /app/:tenant/* trước khi xuất bản đến thành viên.
Vào Try Mode
- Đảm bảo Enable the mobile app đã được bật (trạng thái: Draft).
- Nhấn Try It.
- Huy hiệu trạng thái chuyển sang Try Mode.
- Mở
/app/:tenant/feedtrong trình duyệt (hoặc trên thiết bị di động) để trải nghiệm ứng dụng như một thành viên.
Thoát Try Mode
- Nhấn Stop Try để quay lại Draft mà không xuất bản.
- Nhấn Publish để phát hành ngay lập tức từ Try Mode (chỉ Enterprise).
Try Mode vẫn hoạt động cho đến khi bạn nhấn Stop Try hoặc Publish — không có thời hạn tự động.
Xuất Bản
Xuất bản ứng dụng di động đến thành viên yêu cầu gói Enterprise. Ở các gói thấp hơn, nút Publish hiển thị lời nhắc nâng cấp.
Xuất Bản Lần Đầu
- Hoàn tất cấu hình: thương hiệu, tab điều hướng, thông báo đẩy.
- Tùy chọn nhấn Try It để xem trước.
- Nhấn Publish.
- Huy hiệu trạng thái chuyển sang Published.
- Thành viên truy cập trang cộng đồng sẽ thấy lời nhắc cài đặt. Hướng dẫn họ đến hướng dẫn cài đặt cho thành viên.
Xuất Bản Lại Sau Khi Thay Đổi
Sau khi ứng dụng được xuất bản, bất kỳ thay đổi cấu hình nào bạn lưu sẽ tạo ra một phiên bản nháp mới. Ứng dụng đang phát hành sẽ không được cập nhật cho đến khi bạn xuất bản lại.
- Chỉnh sửa thương hiệu, điều hướng hoặc cài đặt thông báo.
- Nhấn Re-publish.
- Thay đổi phát hành ngay lập tức — không cần bước xem xét.
Hủy Xuất Bản
Hủy xuất bản sẽ xóa quyền truy cập của thành viên mà không tắt cấu hình.
- Nhấn Unpublish.
- Huy hiệu trạng thái trở về Draft.
- Endpoint manifest (
/api/pwa/manifest/:tenant) trả về 404, ngăn chặn các lượt cài đặt mới. - Thành viên đã cài đặt ứng dụng sẽ mất quyền truy cập cho đến khi bạn xuất bản lại.
Endpoint Manifest
Khi ứng dụng ở trạng thái Try Mode hoặc Published, trình duyệt lấy PWA manifest từ:
/api/pwa/manifest/:tenant
Manifest là công khai (không yêu cầu xác thực) và được lưu trong bộ nhớ đệm trong 5 phút (Cache-Control: public, max-age=300).
| Điều kiện | Phản hồi |
|---|---|
| Ứng dụng đã tắt | 404 |
| Ứng dụng đã bật, chưa xuất bản và không ở Try Mode | 404 |
| Ứng dụng đã bật, đã xuất bản hoặc đang ở Try Mode | 200 JSON manifest |
Tính năng moduleMobileApp không có trong gói | 404 |
Manifest bao gồm tên ứng dụng, biểu tượng, màu chủ đề, màu nền màn hình chào, URL bắt đầu (/app/:tenant/feed) và phạm vi (/app/:tenant/). Các trường này được lấy từ cài đặt cộng đồng và cấu hình thương hiệu — chúng không thể chỉnh sửa trực tiếp dưới dạng văn bản tự do trong manifest.
Danh Sách Kiểm Tra Trước Khi Xuất Bản
Trước khi xuất bản, hãy xác minh:
- Enable the mobile app đã BẬT
- Biểu tượng ứng dụng đã tải lên hoặc logo cộng đồng đã được xác nhận (xem Thương Hiệu)
- Màu nền màn hình chào phù hợp với thương hiệu
- Thanh điều hướng dưới hiển thị đúng 5 tab theo thứ tự đúng (xem Tab Điều Hướng)
- Tiêu đề và mô tả banner cài đặt đã được đặt
- Giá trị mặc định thông báo đẩy đã được xem xét (xem Thông Báo Đẩy)
- Đã kiểm thử Try It trên ít nhất một thiết bị di động thực
- Đã xác nhận gói Enterprise (cần thiết để nhấn Publish)
Bước Tiếp Theo
- Tổng Quan — Xem lại huy hiệu trạng thái và toàn bộ vòng đời
- Thương Hiệu — Cập nhật biểu tượng hoặc màn hình chào trước khi xuất bản lại
- Tab Điều Hướng — Điều chỉnh và sắp xếp lại tab trước khi xuất bản lại