0.0.17 • Published 3 years ago
typhon-clitools v0.0.17
this is a tool for 敏捷BI build external component 详细文档
整体流程
使用步骤
0 下载工具(require)
// 全局安装cli工具
npm install -g ty-clitools
// 安装ty-clitoos后,就可以在任何目录使用ty命令
ty
Usage: ty-clitool [command] [options]
Options:
-V, --version output the version number
-h, --help output usage information
Commands:
init [options] <app-name> Generate a template for project
generate Generate componets json
sync [options] Updata componnet Info to platform
serve [entry] server a .js file in production mode with zero config
build [entry] build a .js file in production mode with zero config
1 初始化项目(require)
// 生成项目文件夹自动下载依赖
ty init project-test2
? name:(project-test2)
? description: (This is a component)
downloading template
installing dependens
2 本地开发(rquire)
// 开启本地服务进行本地调试开发
ty serve
具体的可以参见组件开发及调试
3 选择私有npm源(option)
// 私有npm源能使用的前提是你当前
// registry的具体url随着不同环境而不同
npm config set registry http://domain:7001/
// 初次使用:登录私有npm源
npm login
username: admin
password: admin
e-mail: admin@cnpmjs.org
// 将包名的改为带有特殊scope的名字如:@cnpm
"name": "@cnpm/project-test2",
4 打包组件
上传组件之前,需要将组件打包,在组件包根目录执行命令:
gvp build
打包成功后会在根目录下生成dist文件夹。此步骤为必须,必须要build之后才能upload,在项目中应用时会从dist中拉取打包好的代码
5 上传项目(require)
下面有两种上传项目到平台的方式,两种都支持。
(1) 快速上传项目
// 待项目开发完毕后上传最新版本报到npm以及可视化平台
// 注意初次使用需要登录npm
npm run upload
(2)分步骤上传项目
// 上传组件到npm
npm publish
// 生成当前组件信息
ty generate
// 将当前组件信息同步到默认平台(这里需要注意的可以通过设置 host 选项来选择平台,这里host与对应的敏捷BI域名相同)
ty sync --host=http://${host}/api
6 在npm查看包(option)
这里分两种情况:
- (1)没有设置私有npm源的直接上 npm根据包名搜索
- (2)第三步中设置了npm源的,上私有源(根据不同环境地址不一样,按照第三部情况这里为http://http://domain:7002)根据包名搜索
7 组件使用
详细参见组件使用
0.0.17
3 years ago