apicloud-cli 工具使用说明

开源地址

https://github.com/apicloudcom/apicloud-cli

简介

  • 操作系统: Mac/Windows/Linux
  • nodejs环境: node 4+
  • 开源协议: GPL-3.0

APICloud 提供的一款适用于终端/命令行的 APICloud 平台开发工具,基于 apicloud-tools-core 核心开发库 开发,包含新建页面模板,新建应用模板,WiFi同步等核心功能等核心库已有功能.

开源地址: https://github.com/apicloudcom/apicloud-cli

安装

稳定版安装:

  1. npm install -g apicloud-cli

体验版安装(或许有彩蛋):

  1. npm install -g apicloud-cli@dev

开启 es6 支持

  1. apicloud polyfill --project ./

从 0.2.0 版本开始, apicloud-cli 支持对 APICloud 项目进行 polyfill 操作,以直接在项目中使用 es6 等最新语法,优雅地进行模块化的混合App开发.详见: apicloud-polyfill

使用自定义指令

从 0.2.0 版本开始, apicloud-cli 新建 run 指令,用于执行用户自定义的指令.项目本身必须进行 polyfill 操作后,才可使用此特性.内部实现基于 npm 包配置文件的 scripts 属性,详见: Using a package.json

apicloud-cli 指令集

  2.   ***************** APICloud 通用命令行开发工具 ***********************
  4.   命令格式
  6.   执行全局方法:
  7.   apicloud 方法名 --参数名1 参数值2 --参数名2 参数值2
  9.   执行项目相关的方法:
  10.   apiclud run 方法名
  12.   注意:
  13.   1. 参数中的workspace,project和file,可以是相对路径或绝对路径
  14.   2. 支持的应用模板有: default,bottom,home,slide
  15.   3. 支持的页面模板有: page001,page002,page003,page004,page005,page006,page007,page008,page009,page010,page011,page012,page013,page014,page015,page016,page017,page018,page019,page020,page021,page022,page023,page024,page025,page026
  16.   4. port 为wifi服务启动时的端口号
  17.   5. 使用 apicloud run 执行项目相关的方法时,应先cd切换到项目根目录
  18.   6. 项目相关的方法,仅在项目有效 polyfill 化以后,才有效
  20.   // ============================================================
  21.   全局命令示例
  23.   显示版本号:
  24.   apicloud version 或 apicloud -v 或 apicloud --version
  26.   显示帮助信息:
  27.   apicloud help
  29.   启动 wifi 服务:
  30.   apicloud wifiStart --port 8686
  32.   停止 wifi 服务:
  33.   apicloud wifiStop --port 8686
  35.   wifi 增量更新:
  36.   apicloud wifiSync --project ./ --updateAll false --port 8686
  38.   wifi 全量更新:
  39.   apicloud wifiSync --project ./ --updateAll true --port 8686
  41.   wifi 预览:
  42.   apicloud wifiPreview --file ./index.html --port 8686
  44.   获取 wifi 信息:
  45.   apicloud wifiInfo --port 8686
  47.   获取 wifi 调试日志:
  48.   apicloud wifiLog --port 8686
  50.   创建应用模板:
  51.   apicloud init --name HelloAPICloud --template home --workspace ./
  53.   创建页面模板:
  54.   apicloud initPage --name first_page --template page001 --project ./
  56.   开启 es6 支持:
  57.   apicloud polyfill --project ./
  59.   // ============================================================
  61.   项目相关方法示例
  63.   wifi 增量真机同步:
  64.   apicloud run sync
  66.   预编译 es6/es7 js文件:
  67.   apicloud run bundle
  69.   预编译 es6/es7 js文件,然后进行wifi 增量真机同步:
  70.   apicloud run bundle_s
  72.   以debug模式,预编译 es6/es7 js文件,此时会产生对应的 *.map.js 文件,便于在浏览器中调试:
  73.   apicloud run bundle_d
  75.   以debug模式,预编译 es6/es7 js文件,然后进行wifi 增量真机同步:
  76.   apicloud run bundle_d_s

注意

apicloud wifiStart 或 apicloud wifiLog 会持续输出操作日志或调试日志,此时无法继续进行输入,请在另一个终端/命令行窗口中继续进行操作;在真实的场景中,终端使用者,是可以通过特定指令使此指令后台执行,或重定向标准输出流.