Chuyển tới nội dung chính

Xem Trước và Xuất Bản

PWA Simulator

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

  1. Vào Cài đặt → Ứng Dụng Di Động → Design.
  2. 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ị.
  3. 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ểnMô tả
Bộ chọn thiết bịChuyển đổi giữa kiểu bo góc iPhoneAndroid
Đóng (X) / EscapeĐóng hộp thoại toàn màn hình
IframeHiển thị /app/:tenant/feed — ứng dụng trực tiếp trong trình duyệt
thông tin

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

  1. Đảm bảo Enable the mobile app đã được bật (trạng thái: Draft).
  2. Nhấn Try It.
  3. Huy hiệu trạng thái chuyển sang Try Mode.
  4. Mở /app/:tenant/feed trong 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

Yêu cầu gói Enterprise

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

  1. Hoàn tất cấu hình: thương hiệu, tab điều hướng, thông báo đẩy.
  2. Tùy chọn nhấn Try It để xem trước.
  3. Nhấn Publish.
  4. Huy hiệu trạng thái chuyển sang Published.
  5. 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.

  1. Chỉnh sửa thương hiệu, điều hướng hoặc cài đặt thông báo.
  2. Nhấn Re-publish.
  3. 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.

  1. Nhấn Unpublish.
  2. Huy hiệu trạng thái trở về Draft.
  3. Endpoint manifest (/api/pwa/manifest/:tenant) trả về 404, ngăn chặn các lượt cài đặt mới.
  4. 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ệnPhản hồi
Ứng dụng đã tắt404
Ứng dụng đã bật, chưa xuất bản và không ở Try Mode404
Ứng dụng đã bật, đã xuất bản hoặc đang ở Try Mode200 JSON manifest
Tính năng moduleMobileApp không có trong gói404

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
Ask AI Assistant