Nhảy tới nội dung

Tổng Quan Phát Triển

Tài liệu này hướng dẫn bạn toàn bộ quá trình phát triển. Làm theo các bước bên dưới để phát triển và xuất bản Mini App của riêng bạn.

CHUẨN BỊ​

1. Tạo tài khoản MoMo cho Doanh nghiệp​

Cần có tài khoản MoMo cho Doanh nghiệp để sử dụng các dịch vụ do nền tảng MoMo cung cấp. Bạn có thể tạo tài khoản trên trang web MoMo cho Doanh nghiệp. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Đăng ký Mini App.

Bạn có thể bỏ qua bước này nếu đã có tài khoản MoMo cho Doanh nghiệp.

2. Đăng nhập vào Mini App Center​

Sử dụng tài khoản đã đăng ký trên MoMo cho Doanh nghiệp để đăng nhập vào Mini App Center. Nếu bạn chưa có, bạn có thể đăng ký trực tiếp trên trang Mini App Center.

3. Đăng ký Mini App Plan​

Bạn cần đăng ký Mini App Plan để có thể thêm Mini App của bạn.

THIẾT LẬP​

1. Tạo Mini App​

Bạn phải đi đến Mini App List, nhấp vào nút Add Mini App và điền thông tin Mini App của bạn. Chọn Add New để gửi yêu cầu thêm một Mini App mới. Sau khi gửi, MoMo sẽ liên hệ với bạn trong vòng 02-05 ngày để tiến hành quy trình hợp tác. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Tạo Mini App.

2. Cài đặt Cấu hình NPM​

Cấu hình NPM được sử dụng để xác thực với Gói MoMo, có chứa Mini CLI và Mini API được sử dụng trong quá trình phát triển Mini App. Đi tới Mini App Dashboard > Overview, sao chép và chạy mã cấu hình NPM trong terminal của công cụ phát triển của bạn. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Cấu Hình NPM.

3. Cài đặt Mini App CLI (Đối với React Native)​

Cài đặt Mini App CLI để tạo mã nguồn Mini App, Debug và Build Mini App.

4. Tạo mã nguồn Mini App (Đối với React Native)​

Bạn phải phát triển Mini App bên trong thư mục mã nguồn do MoMo cung cấp. Để biết chi tiết về cách khởi tạo thư mục mã nguồn, hãy thực hiện theo hướng dẫn Tạo Mã Nguồn Mini App trong tài liệu Cài Đặt Mini CLI.

5. Cài đặt Mini API​

Mini API cung cấp các API để Mini App tương tác với MoMo App Platform.

Mini API được cài đặt tự động khi bạn hoàn thành việc tạo mã nguồn Mini App ở bước trước đó (đối với ứng dụng React Native) hoặc chạy lệnh "cài đặt mới Mini API" trong hướng dẫn Cài Đặt (đối với ứng dụng Web). Để biết thêm chi tiết, vui lòng tham khảo tài liệu Cài đặt Mini API.

BẮT ĐẦU PHÁT TRIỂN​

1. Tải xuống Cấu hình Mini App (Đối với React Native)​

Lấy tệp app.json và thay thế tệp hiện tại trong thư mục mã nguồn để Mini App có thể xác thực với Mini App Center và MoMo Platform. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Thiết lập cấu hình Mini App.

2. Khởi động máy chủ Debug Mini App (Đối với React Native)​

Khởi động Máy Chủ Debug, cho phép bạn chạy Mini App và các chức năng ở chế độ debug để kiểm tra ứng dụng trong khi phát triển. Bạn có thể tham khảo phần Khởi Động Máy Chủ Mini App trong tài liệu Cài đặt Mini CLI.

3. Tải xuống MoMo Platform​

Bạn phải tải xuống và cài đặt MoMo Platform để thử nghiệm Mini App trên thiết bị. Mini App sẽ được lưu trữ và chạy trên MoMo Platform.

4. Debug Mini App​

Việc debug Mini App giúp bạn phát hiện ra các lỗi và nguyên nhân để sửa lỗi trong quá trình phát triển và thử nghiệm. Để debug Mini App, bạn phải sử dụng Devtool. Để biết thêm chi tiết, vui lòng thực hiện theo hướng dẫn Mini App Debug.

TÍCH HỢP CÁC TÍNH NĂNG (TÙY CHỌN)​

User Authentication​

User Authentication cho phép Mini App tin cậy người dùng trong khi sử dụng Mini App. Sử dụng User authentication API và thực hiện theo hướng dẫn User Authentication để xác thực người dùng.

User Data Permission​

Bạn có thể yêu cầu người dùng cung cấp thông tin cá nhân như tên, số điện thoại, v.v. và sử dụng chúng cho một chức năng của Mini App. Để biết thêm chi tiết, bạn có thể thực hiện theo hướng dẫn User Data Sharing.

Device Permission​

Bạn có thể yêu cầu người dùng cung cấp quyền cho thiết bị như Ảnh, Vị trí, Máy ảnh và sử dụng chúng cho một chức năng của Mini App. Để biết thêm chi tiết, bạn có thể thực hiện theo hướng dẫn User Data Sharing.

MoMo In-App Payment SDK (One-time Payment)​

Nếu Mini App có tính năng thanh toán, bạn phải tích hợp SDK Thanh Toán trong ứng dụng để sử dụng tính năng Thanh toán trên MoMo. Để biết thêm chi tiết, bạn có thể thực hiện theo hướng dẫn SDK Thanh Toán.

UI Component​

Việc sử dụng các UI Component do MoMo cung cấp sẽ đẩy nhanh quá trình phát triển và đảm bảo tính nhất quán của UI. Để biết thêm chi tiết, bạn có thể thực hiện theo hướng dẫn MoMo Component Kits.

THỰC HIỆN THEO QUY CHUẨN THIẾT KẾ & DANH SÁCH KIỂM TRA THIẾT KẾ​

1. Thực hiện theo Quy Chuẩn Thiết Kế​

Thực hiện theo Quy Chuẩn Thiết Kế để đảm bảo thiết kế hiển thị của Mini App đạt tiêu chuẩn của MoMo. Chúng tôi sẽ xem xét thiết kế ứng dụng và so sánh nó với Danh Sách Kiểm Tra Thiết Kế. Nếu ứng dụng của bạn không đáp ứng các yêu cầu của chúng tôi, yêu cầu rollout của bạn sẽ bị từ chối.

2. Thực hiện theo Quy Định Sử Dụng Thương Hiệu​

Thực hiện theo Quy Định Sử Dụng Thương Hiệu để đảm bảo thiết kế của logo MoMo được hiển thị chính xác bên trong Mini App. Nếu ứng dụng của bạn không đáp ứng các yêu cầu của chúng tôi, yêu cầu rollout của bạn sẽ bị từ chối.

3. Thực hiện theo Danh Sách Tiêu Chí Đánh Giá Sản Phẩm​

Danh Sách Tiêu Chí Đánh Giá Sản Phẩm liệt kê tất cả các yêu cầu sản phẩm của một Mini App. Trước khi triển khai, bạn phải đảm bảo Mini App áp dụng tất cả các quy tắc. Nếu ứng dụng của bạn không đáp ứng các yêu cầu của chúng tôi, yêu cầu rollout của bạn sẽ bị từ chối.

BUILD MINI APP (ĐỐI VỚI REACT NATIVE)​

1. Liên kết Mini App với mã nguồn​

Việc kết nối mã nguồn cho phép hệ thống xây dựng của Mini App Center sao chép kho lưu trữ trong khi xây dựng Mini App. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Kết Nối Mã Nguồn.

2. Build Mini App​

Việc build Mini App tạo ra Beta Version của Mini App. Bạn có thể gửi Beta Version cho người khác để thử nghiệm hoặc MoMo Reviewer để xử lý rollout bản production. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Sử Dụng Mini App Center hoặc hướng dẫn Sử Dụng Mini App CLI.

TEST MINI APP (BETA VERSION)​

Quét mã Beta QR​

Đối với ứng dụng React Native:

Beta Version của Mini App có thể được mở bằng cách sử dụng Devtool và quét mã Beta QR được hiển thị trong kết quả Build Mini App. Để biết thêm chi tiết, hãy thực hiện theo phần Kiểm Thử Mini App Beta trong tài liệu Mini App Beta.

Đối với ứng dụng Web:

Beta Version của ứng dụng Web có thể được mở bằng cách sử dụng Devtool và quét mã Beta QR được hiển thị trên trang Mini App Links. Để biết thêm chi tiết, hãy thực hiện theo phần Quét Mã Beta QR trong tài liệu Mini App Web.

Tự động đồng bộ hóa mã Beta QR (Đối với React Native)​

Bạn có thể xác thực Devtool bằng Mini App Center để tự động đồng bộ hóa mã Beta QR. Điều này cho phép bạn thử nghiệm các bản build Mini App mới mà không cần quét mã Beta QR mỗi lần. Để biết thêm chi tiết, hãy thực hiện theo hướng dẫn Kết Nối Mini App Center Devtool.

Khi bạn muốn kiểm tra bất kỳ URL nào của ứng dụng web nhưng chưa muốn triển khai trên MoMo App Platform, bạn có thể nhập URL của ứng dụng web vào Devtool để mở thử nghiệm Mini App. Để biết thêm chi tiết, hãy thực hiện theo phần Cấu Hình Ứng Dụng Web trong tài liệu Mini App Web.

ROLLOUT CHO BẢN PRODUCTION​

1. Tạo Rollout Request​

Trước khi gửi Mini App của bạn đến MoMo Reviewer, bạn phải tuân thủ theo Quy Chuẩn Thiết Kế, Quy Định Sử Dụng Thương Hiệu, và Danh Sách Tiêu Chí Đánh Giá Sản Phẩm.

Sau đó, bạn có thể tạo phiên bản rollout đầu tiên bằng cách tuân theo các nguyên tắc sau: hướng dẫn về Mini App Info và hướng dẫn về Phiên Bản Mini App (đối với ứng dụng React Native) hoặc hướng dẫn về Liên Kết Ứng Dụng WebView (đối với ứng dụng web) trong tài liệu Rollout Mini App.

2. Thực hiện theo Rollout Request​

MoMo Reviewers sẽ xử lý Rollout Request của bạn sau 02-05 ngày làm việc. Bạn có thể kiểm tra Trạng Thái Rollout Request trong Rollout Request List trên Mini App Center.

Nếu yêu cầu của bạn hiển thị là Rejected, vui lòng kiểm tra phản hồi từ MoMo, khắc phục các lỗi và tạo Rollout Request mới.

PHÁT HÀNH ỨNG DỤNG​

Hiện tại, Mini App của bạn đã được phát hành trên MoMo App. Bạn có thể theo dõi hoạt động của Mini App trên Mini App Center.

CẬP NHẬT MINI APP​

Cập nhật Mini App Info:

Bạn có thể cập nhật Tên, Biểu Tượng Dịch Vụ, Mô Tả Ngắn Gọn, Email CSKH, hoặc Số Điện Thoại CSKH bằng cách thực hiện theo hướng dẫn Thay đổi Mini App Info trong tài liệu Rollout Mini App.

Cập nhật Mini App Versions:

Bạn có thể cập nhật phiên bản Android và iOS, các tính năng mới, hoặc bản sửa lỗi của Mini App bằng cách thực hiện theo hướng dẫn Rollout Phiên Bản Mới trong tài liệu Rollout Mini App.

ON THIS PAGE