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

Truy cập nhanh

1. Tổng quan​

Truy cập nhanh (Quick Access hay Quick Action) cho phép Mini App định nghĩa các lối truy cập nhanh tới các chức năng hoặc màn hình cụ thể trong app (ví dụ: Đặt xe, Đặt đồ ăn, Theo dõi đơn hàng…)

  • Quick Access được cấu hình trong bundle của Mini App, không cấu hình trực tiếp trên DevCenter.
  • Mỗi bản build khi submit sẽ mang theo danh sách Quick Access tương ứng.
  • DevCenter chỉ có nhiệm vụ hiển thị theo phiên bản và tạo liên kết xem trước (QR) để developer kiểm tra.

2. Cách cấu hình Quick Access​

2.1. Vị trí cấu hình​

Developer cần khai báo Quick Access trong file app-config.json của bundle Mini App

⚠️ Lưu ý DevCenter không cho phép tạo hoặc chỉnh sửa Quick Access. Mọi thay đổi phải được thực hiện trong bundle và submit bằng một build mới.

2.2. Cấu trúc cấu hình mẫu​

{
  "quickActions": [
    {
      "path": "/book-car",
      "image": "/assets/image.png",
      "name": {
        "vi": "Đặt xe",
        "en": "Book car"
      }
    },
    {
      "path": "/food?id=123",
      "image": "/assets/food.png",
      "name": {
        "vi": "Đặt đồ ăn",
        "en": "Food now"
      }
    }
  ]
}

3. Quy định chi tiết cho từng trường​

3.1. path​

  • Là đường dẫn nội bộ tới một page hoặc route trong Mini App.
  • Có thể bao gồm query string.

Ví dụ:

  • /book-car
  • /food?id=123

📌 Path này sẽ được dùng khi:

  • Người dùng click Quick Access trong Super App
  • Developer tạo link / QR để test Quick Access

3.2. name (Bắt buộc)​

  • Hỗ trợ đa ngôn ngữ.
  • Tiếng Việt (vi) là bắt buộc.
  • Các ngôn ngữ khác (ví dụ en) là tuỳ chọn.
  • Giới hạn: tối đa 30 ký tự cho mỗi ngôn ngữ.

Ví dụ:

"name": {
  "vi": "Đặt xe",
  "en": "Book car"
}

📌 Trên DevCenter, hệ thống sẽ hiển thị:

  • Tên tiếng Việt
  • Tên tiếng Anh (nếu có)

3.3. image​

  • Đường dẫn tới icon hiển thị cho Quick Access. Được resolve từ root folder (thư mục chạy lệnh build và deploy).

Yêu cầu:

  • Kích thước: 96x96
  • Tỉ lệ: 1:1
  • Định dạng: PNG

Ví dụ:

"image": "/public/assets/food.png"
"image": "/src/assets/food.png"

📌 Icon này sẽ được hiển thị trong danh sách Quick Access trên DevCenter và trong Super App.

4. Hiển thị Quick Access trên DevCenter​

Sau khi developer submit build:

  • Mỗi bản build sẽ chứa danh sách Quick Access tương ứng.
  • Trong trang Chi tiết phiên bản, DevCenter sẽ hiển thị bảng Thông tin Truy cập nhanh, bao gồm:
    • Icon của Quick Access
    • Tên (Tiếng Việt)
    • Tên (Tiếng Anh – nếu có)
    • Đường dẫn (path)

📌 Các Quick Access này gắn chặt với phiên bản build, không dùng chung giữa các phiên bản.

5. Tạo liên kết xem trước (Preview Link / QR)​

5.1. Mục đích​

Cho phép developer:

  • Test nhanh Quick Access
  • Kiểm tra routing, param, logic xử lý
  • Verify UI/UX trước khi phát hành chính thức

5.2. Cách sử dụng​

Trong bảng Thông tin Truy cập nhanh của từng phiên bản:

  1. Chọn một Quick Access
  2. Nhấn nút “Tạo liên kết xem trước”

Hệ thống sẽ sinh:

  • Một link preview
  • Một QR code

📌 Khi mở link hoặc quét QR:

  • Mini App sẽ được mở trực tiếp tại path tương ứng của Quick Access
  • Context và dữ liệu đi kèm giống như khi người dùng truy cập từ Super App

Truy cập nhanh

6. Lưu ý quan trọng​

  • Quick Access chỉ có hiệu lực trên bản build chứa cấu hình đó.
  • Mỗi lần thay đổi Quick Access:
    • Developer cần build lại
    • Submit phiên bản mới
  • DevCenter không validate logic bên trong path, developer cần tự đảm bảo route tồn tại và hoạt động đúng.