ejsc-mna-cli

v1.0.7

Published

11 days ago

Advanced Command-Line Tooling for 365 Mini App orchestration. Enables zero-config project bootstrapping, intelligent dev servers, and live HMR web-socket relays.

0High
0Medium
0Low

tranvansi6302

ejsc-mna-cli 🚀

The Professional Orchestration Tool & Command-Line Interface for 365 Mini App Ecosystem.

ejsc-mna-cli (cung cấp câu lệnh ejsc) là công cụ Command-Line chuyên nghiệp phục vụ phát triển, quản lý dev server mô phỏng (Simulator), kiểm tra lỗi và đóng gói triển khai ứng dụng 365 Mini App chạy trên nền tảng 365 Super App.

Công cụ mang lại giải pháp toàn diện bao gồm:

🚀 Intelligent Dev Server: Tự động cấp phát cổng thông minh (Port Auto-Discovery), live HMR qua WebSocket relay.
📱 Built-in Mobile Simulator: Môi trường Web Simulator mô phỏng giao diện thiết bị di động thật.
⚡ Zero-Config Build Pipeline: Đóng gói Production tối ưu dung lượng JS/CSS và kiểm tra an toàn kiểu dữ liệu.
☁️ Cloud Deployment: Đăng nhập, kiểm tra thông tin tài khoản nhà phát triển và phát hành ứng dụng lên máy chủ Cloud.

📑 Mục Lục

1. Yêu Cầu Hệ Thống & Cài Đặt

Yêu cầu:

Node.js: Phiên bản >= 20.0.0
Package Manager: pnpm (khuyên dùng) hoặc npm / yarn.

Cài đặt toàn cục (Global Installation):

# Cài đặt qua pnpm
pnpm add -g [email protected]

# Hoặc cài đặt qua npm
npm install -g [email protected]

# Kiểm tra phiên bản CLI đã cài đặt
ejsc --version

2. Danh Sách Lệnh CLI (`ejsc`)

2.1 `ejsc dev` - Server Phát Triển & Debug Real-time

Khởi chạy môi trường phát triển local tích hợp sẵn Simulator Browser và WebSocket Log Relay.

ejsc dev [options]

Các tùy chọn (Options):

-p, --port <number>: Chỉ định cổng cho Dev Server (Mặc định: 8080).
--network: Mở rộng server ra IP mạng nội bộ (Wi-Fi) để quét mã QR và test trực tiếp trên điện thoại thật.

💡 Cơ chế quản lý cổng thông minh (Port Auto-Discovery): CLI tự động phát hiện nếu cổng mặc định bị chiếm dụng và chuyển sang cổng khả dụng tiếp theo (port + 1, port + 2), giúp quá trình phát triển không bị ngắt quãng.

2.2 `ejsc build` - Đóng Gói Production

Đóng gói dự án tối ưu dung lượng và hiệu năng sẵn sàng cho môi trường Production.

ejsc build [options]

Các tùy chọn:

-c, --config <path>: Chỉ định file cấu hình Vite tùy chỉnh (Mặc định: vite.config.ts).

Quy trình đóng gói tự động:

Type Check: Kiểm tra kiểu dữ liệu với TypeScript compiler.
Asset Optimization: Nén và tối ưu hóa file tĩnh.
Bundle Minification: Minify mã nguồn JS/CSS đảm bảo dung lượng tối ưu cho Super App.

2.3 `ejsc staging` - Thử Nghiệm Staging & Preview

Đóng gói và khởi chạy ứng dụng ở chế độ xem trước Staging với Simulator và server mô phỏng.

ejsc staging [options]

Các tùy chọn:

-p, --port <port>: Cổng phục vụ ứng dụng Staging (Mặc định: 8181).
--simulator-port <port>: Cổng cho Simulator Host Server (Mặc định: 3131).
--network: Mở rộng ra IP mạng nội bộ Wi-Fi.

2.4 `ejsc login` / `logout` / `whoami` - Quản Lý Tài Khoản

# Đăng nhập tài khoản nhà phát triển 365 Developer
ejsc login

# Kiểm tra thông tin tài khoản đang đăng nhập
ejsc whoami

# Đăng xuất tài khoản
ejsc logout

2.5 `ejsc apps` / `deploy` - Quản Lý Cloud & Triển Khai

# Xem danh sách các Mini App thuộc quyền quản lý của bạn
ejsc apps

# Đóng gói và phát hành ứng dụng lên 365 Cloud Server
ejsc deploy [options]

Các tùy chọn khi deploy:

--minor: Tự động tăng phiên bản Minor (ví dụ: 1.0.0 -> 1.1.0).
--major: Tự động tăng phiên bản Major (ví dụ: 1.0.0 -> 2.0.0).
--changelog <message>: Ghi chú thay đổi cho phiên bản phát hành này.
--skip-build: Bỏ qua bước đóng gói ứng dụng trước khi tải lên.

2.6 `ejsc zip` - Đóng Gói ZIP & Xuất Chuỗi Base64

Tự động build dự án, tạo thư mục build/<version>/ (nếu chưa có), đóng gói toàn bộ thư mục dist thành file .zip và sinh file .txt chứa chuỗi mã hóa Base64 của file ZIP đó.

ejsc zip [options]
# hoặc
ejsc cli zip [options]

Các tùy chọn khi zip:

-c, --config <path>: Chỉ định file cấu hình Vite tùy chỉnh.
--skip-build: Bỏ qua bước build lại nếu thư mục dist đã sẵn sàng.
-v, --version-name <version>: Tùy chỉnh tên phiên bản (mặc định lấy từ package.json).
-o, --output <dir>: Tùy chỉnh thư mục đầu ra (mặc định: build).
-n, --name <name>: Tùy chỉnh tên file gốc cho .zip và .txt.

Cấu trúc thư mục đầu ra sinh ra:

build/
└── 1.0.0/
    ├── main.vfs.dev_v1.0.0.zip
    └── main.vfs.dev_v1.0.0.txt   # Chứa chuỗi Base64 của file zip

3. Tùy Chọn Cấu Hình Chi Tiết

Mỗi dự án Mini App được tạo cần có file cấu hình ejsc-mna.config.json hoặc file package.json định nghĩa thông tin cơ bản:

{
  "name": "my-mini-app",
  "version": "1.0.0",
  "app_id": "com.company.miniapp"
}

4. Thư Viện Lõi Trong Hệ Sinh Thái

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

ejsc-mna-cli 🚀

📑 Mục Lục

1. Yêu Cầu Hệ Thống & Cài Đặt

Yêu cầu:

Cài đặt toàn cục (Global Installation):

2. Danh Sách Lệnh CLI (ejsc)

2.1 ejsc dev - Server Phát Triển & Debug Real-time

2.2 ejsc build - Đóng Gói Production

2.3 ejsc staging - Thử Nghiệm Staging & Preview

2.4 ejsc login / logout / whoami - Quản Lý Tài Khoản

2.5 ejsc apps / deploy - Quản Lý Cloud & Triển Khai

2.6 ejsc zip - Đóng Gói ZIP & Xuất Chuỗi Base64