Đóng gói và nộp bundle

Mini app được nộp dưới dạng một tệp ZIP chứa kết quả build, được duyệt rồi mới phát tới người dùng. Tệp sai quy tắc sẽ bị từ chối, vì vậy hãy đối chiếu danh sách dưới đây trước khi nộp.

• index.html phải nằm ở gốc của ZIP. Hãy nén nội dung của thư mục dist/, không nén chính thư mục đó.
• Tối đa 5 MB khi nén và 15 MB khi giải nén. Tệp media lớn hãy đặt ở nơi khác.
• Chỉ nhận các đuôi tệp trong danh sách cho phép (liệt kê ở phần tiếng Anh bên dưới).
• Không có tệp ẩn (tên bắt đầu bằng dấu chấm), không có đường dẫn tuyệt đối hay chứa ...
• Mọi script phải nằm trong bundle. Thẻ <script src="https://..."> trỏ ra ngoài sẽ bị từ chối; hãy đóng gói thư viện vào bundle (Vite, esbuild... mặc định đã làm vậy).
• Tệp manifest.json ở gốc là tùy chọn.

Trước khi nộp, hãy thử trên điện thoại thật, cả iOS lẫn Android. Để đăng ký mini app mới và khai báo quyền, liên hệ đội i-Catholic.

Nếu có sai khác giữa danh sách tóm tắt này và phần tiếng Anh bên dưới, phần tiếng Anh (lấy từ SDK) là bản chuẩn.

Details (English)

A mini app is submitted as a ZIP of your build output, reviewed, then served to users by i-Catholic.

• index.html must be at the root of the ZIP. Zip the contents of dist/, not the folder.
• At most 5 MB zipped and 15 MB unzipped. Host large media elsewhere.
• Allowed file types: .html .css .js .mjs .json .png .jpg .jpeg .gif .svg .webp .woff .woff2 .ttf .ico .mp3 .wav.
• No hidden files (names starting with .), and no absolute or .. paths.
• All scripts must be in the bundle. An external <script src="https://…"> is rejected. Bundle your dependencies (Vite, esbuild, … do this by default).
• An optional manifest.json at the root (name, version, description, icon, permissions) is stored with the bundle.

Contact the i-Catholic team to register a new mini app and declare its permissions.