## 介绍 在旧版本中,Cabloy商店提供的`套件/模块`需要打开浏览器,然后`手动`下载,并解压到项目目录。如今,可以直接通过命令行进行`套件/模块`的`安装`、`升级`、`发布`操作 ## 开放认证Token 由于`Cli command`会直接访问Cabloy商店的远程API,进行`安装升级`或者`上传发布`操作。因此,需要提供`开放认证Token`,以便对用户身份进行认证 `开放认证Token`是一对`Client ID`和`Client Secret`的组合,可通过如下方式获取: 1. 访问CabloyJS后台管理系统: 2. 注册用户(如果之前已注册用户,不必重复注册)。系统会自动为新注册用户分配一组`Tokens`,分别用于`安装升级`或者`上传发布`操作 3. 进入页面:`我的`\->`设置`\->`开放认证`,即可看到`Tokens`的具体信息 * 或者,直接点击 >>>>>>>> [这里](https://portal.cabloy.com/#!/a/basefront/atom/list?module=a-authopen&atomClassName=authOpen&options=%7B%22stage%22%3A%22formal%22%2C%22mine%22%3A1%7D) <<<<<<<< 快速进入该页面 | Token名称 | 说明 | |----|----| | Cli For Store Sync | 用于首次安装、后续升级 | | Cli For Store Publish | 用于上传发布 | ## 如何使用 ### \- 安装升级 按如下方式操作: ``` bash # 安装或升级具体的套件/模块,可指定多个参数 $ npm run cli :store:sync test-suite1 test-module1 # 安装常见的测试套件/模块 $ npm run cli :store:sync test-party test-flow test-note # 升级所有套件/模块 $ npm run cli :store:sync ``` * 对于具体的`套件/模块`,第一次执行是`安装`,再次执行就是`升级` * 第一次执行`sync`指令时,会提示输入`Client ID`和`Client Secret` ### \- 免费安装核心模块的源码 由于CabloyJS内置的核心模块均位于目录`node_modules`中,如果想查看某个核心模块的源码,可以通过以下指令安装至项目目录:`{project}/src/suite-vendor`或`{project}/src/module-vendor` ``` bash # 安装基础模块:a-base-sync $ npm run cli :store:sync a-base-sync # 安装CMS模块:a-cms $ npm run cli :store:sync a-cms # 安装NodeJS工作流引擎模块:a-flow $ npm run cli :store:sync a-flow ``` * 若要查看更多核心模块,请转至:[Cabloy商店](https://store.cabloy.com) * 核心模块是免费的,但仍需要到Cabloy商店生成免费购买记录,从而可以在命令行进行下载和安装 ### \- 上传发布 按如下方式操作: ``` bash # 发布具体的套件/模块,可指定多个参数 $ npm run cli :store:publish test-suite2 test-module2 # 发布所有套件/模块 $ npm run cli :store:publish ``` * 发布前,需要先访问CabloyJS后台管理系统,新建`套件/模块`记录 * 发布时,会自动比对内容是否有变更,自动变更版本号 * 第一次执行`publish`指令时,会提示输入`Client ID`和`Client Secret`