HomeHub MiniApp cho VS Code

Extension chính thức để phát triển MiniApp trên HomeHub SuperApp: tạo dự án, chạy thử trong Simulator, đóng gói, ký và xuất bản mà không rời VS Code. Dùng chung phần lõi và phiên đăng nhập với @homehub/miniapp-cli.

Tính năng

Tài khoản

Đăng nhập bằng email/mật khẩu, token lưu ở ~/.homehub/config.json (dùng chung với CLI).
Chọn môi trường DEV / UAT / PROD; hiện trên status bar.
Lưu Partner Code / Secret trong kho bí mật của VS Code để ký manifest.

Dự án

Tạo dự án mới từ template (React + Vite) ngay trong VS Code.
Tự nhận diện dự án có miniapp.json trong workspace; hỗ trợ nhiều dự án.
Gợi ý và kiểm tra miniapp.json khi gõ (JSON schema).
Panel Chẩn đoán: thiếu dependency, chưa build, gói lệch môi trường, SDK cũ, chưa đăng nhập... kèm nút sửa.

Chạy thử

Khởi động dev server (vite) trong panel Terminal.
Simulator: khung điện thoại (iPhone / Android) hiển thị MiniApp ngay trong VS Code; SDK tự chạy Mock Mode.
Mở trong trình duyệt.

Xuất bản

Build, Đóng gói và ký, Kiểm tra gói, Tải lên, hoặc Deploy một nút (đóng gói → kiểm tra → tải lên).
Xác nhận riêng khi thao tác với PROD.

Cài đặt từ mã nguồn

cd extension
npm install          # kéo @homehub/miniapp-cli từ thư mục cha
npm run build        # bundle ra out/extension.js và sao chép templates/
npm run package      # tạo homehub-miniapp-<version>.vsix
code --install-extension homehub-miniapp-0.1.0.vsix

Để phát triển: mở thư mục extension/ trong VS Code, nhấn F5 (cấu hình "Chạy extension HomeHub").

Cài đặt (settings)

Khoá	Mặc định	Ý nghĩa
`homehub.portalUrl`	rỗng	Ghi đè URL portal (đăng nhập)
`homehub.apiUrl`	rỗng	Ghi đè URL API (upload)
`homehub.devServerPort`	5173	Cổng dev server
`homehub.simulator.device`	iphone-14	Thiết bị mặc định trong Simulator
`homehub.rememberPartnerSecret`	true	Lưu Partner Secret sau lần nhập đầu

Chưa có (phụ thuộc backend / app native)

Đăng nhập bằng mã QR.
Mở MiniApp đang phát triển trên app HomeHub thật qua QR (Device mode).
Lịch sử phiên bản, rollback, QR / deep link sau khi deploy.