介绍

Lego-CLI 是一款专门为启业云应用平台开发、调试和部署定制程序，并且快速接入启业云平台的的工具软件，旨在解决启业云应用搭建过程中，个性化需求在配置和设计器原生组件无法满足的情况下，通过定制程序的方式去实现而产生的一系列问题。Lego-CLI 提供完整的、体验良好的开发链路，包含创建项目、本地开发、调试预览、一键发布等功能。Lego-CLI 目前提供两种定制程序开发模式：微组件和微应用，前者提供页面上小区域页面渲染和逻辑的定制方案，可以集成到【个性化定制】中，提供菜单、view、form三个场景的定制，也可以集成到 view、detail 设计器中提供字段的定制；后者提供单个页面或多个页面组成一个完整应用的定制方案。

安装

如果您之前已经配置过私有 npm ，则以下 1~2 步可跳过。否则请从第 1 步开始。

打开 .npmrc

# Mac/Linux系统下执行命令
vi ~/.npmrc

# Windows系统下打开
C:\Users\【你的Windows用户名】\.npmrc

添加 npm 私服的相关配置（在 .npmrc 文件的头部添加）。

always-auth=true
@bricks:registry=https://open-npm.qpaas.com/
@ay:registry=https://open-npm.qpaas.com/
@aytc:registry=https://open-npm.qpaas.com/
@qycloud:registry=https://open-npm.qpaas.com/
@qpaas:registry=https://open-npm.qpaas.com/
@51safety:registry=https://open-npm.qpaas.com/
@formbox:registry=https://open-npm.qpaas.com/
@commonbox:registry=https://open-npm.qpaas.com/
registry=https://registry.npmmirror.com/
host=https://npmmirror.com
disturl=https://npmmirror.com/dist
sass_binary_site=https://cdn.npmmirror.com/binaries/node-sass
phantomjs_cdnurl=https://cdn.npmmirror.com/binaries/phantomjs
sharp_dist_base_url=https://cdn.npmmirror.com/binaries/sharp-libvips/v8.7.4/
canvas_binary_host_mirror=https://cdn.npmmirror.com/binaries/canvas/

unsafe-perm=true

登录私有 npm 仓库

npm login --registry https://open-npm.qpaas.com
# username: 启业云平台账号
# password: 启业云平台密码
# email: 个人邮箱

全局安装 Lego-CLI

请确保本地安装有 node 环境，并且版本在 12.x 以上。安装可参考 https://nodejs.org/en/download/。

npm install -g @qpaas/lego-cli

可以用这个命令来检查是否正确安装:

lego --version

如果安装正确，会在命令行输出当前 Lego-CLI 的版本号

使用

在控制台运行 lego 打印出所有命令：

其中 lego ui是我们主要使用的命令。运行该命令，会在浏览器打开一个图形化界面，提供了所有其他命令能实现的功能。并且其他命令后续不再迭代维护，推荐使用 lego ui进行开发。

lego ui的文档在下一章节：图形化界面

升级

运行命令 lego upgrade 按提示操作即可:

输入 Y 然后回车，脚手架会自动升级，升级完成后重启脚手架即可体验最新版本。