@easyrn/erpush-cli 0.0.1-alpha

package/cli.js

@@ -0,0 +1,2 @@
+// 导出命令给 epush 使用
+module.exports = require('./src/commands');

package/index.js

@@ -0,0 +1,29 @@
+/**
+ * erpush-cli 为 erpush 提供了可用的命令行
+ * 运行 erpush 的命令, 实际调是由当前包的 cli 进行执行
+ * 
+ * 导出 cli 所用的函数, 若自行开发功能, 可使用这些函数, 如
+ * 
+ *    import erpush from 'erpush-cli';
+ * 
+ *    erpush.makeBundle()
+ * 
+ * 需注意: 该包的大部分函数仅可在 node cli 环境下执行
+ */
+const api = require('./src/api');
+const utils = require('./src/utils');
+const Shell = require('./src/shell');
+const {makeApk, makeIpa, makeBundle} = require('./src/pack');
+const {diff, diffPackage, diffBundle} = require('./src/patch');
+
+module.exports = {
+  api,
+  utils,
+  Shell,
+  makeApk,
+  makeIpa,
+  makeBundle,
+  diff,
+  diffPackage,
+  diffBundle,
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@easyrn/erpush-cli",
+  "version": "0.0.1-alpha",
+  "description": "easyrn push cli",
+  "main": "./index.js",
+  "author": "malacca",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "erpush"
+  ],
+  "dependencies": {
+    "yazl": "^2.5.1",
+    "yauzl": "^2.10.0",
+    "wcwidth": "^1.0.1",
+    "minimist": "^1.2.7",
+    "form-data": "^3.0.0",
+    "node-fetch": "^2.6.7",
+    "tough-cookie": "^4.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/easyrn/archives"
+  },
+  "homepage": "https://github.com/easyrn/archives/tree/master/erpush-cli"
+}

package/src/api.js

@@ -0,0 +1,294 @@
+const fs = require('fs');
+const {fileExist, getConfig, getAppId, requestAPI} = require('./utils');
+
+class CommandAPI {
+
+  /**
+   * 初始化时指明运行目录, 会在该目录下自动寻找 RN 项目的相关配置
+   * @param string cwd 
+   */
+  constructor(cwd){
+    this.cwd = cwd;
+  }
+
+  /**
+   * 所有 API 接口皆通过此方法发出请求，返回结果格式必须为: {code:int, message:string}
+   * code==0: 服务端处理成功, 有些接口还需要其他数据
+   * code!=0: 服务端处理异常, message 为异常信息
+   */
+  async request(uri, payload, asForm){
+    const res = await requestAPI(this.cwd, uri, payload, asForm);
+    return await res.json();
+  }
+
+  /**
+   * API : 登陆账号, 服务端应在 response header 中返回 set-cookie
+   *       后续其他请求都会附带该 cookie, 服务端可以此来鉴权
+   * POST: /login  {user:string, pwd:string}
+   * RES : {code:int, message:string}
+   */
+  async login(user, pwd){
+    const res = await this.request('/login', {user, pwd});
+    if (res.code === 0 && !('message' in res)){
+      res.message = 'Logged in as ' + user;
+    }
+    return res;
+  }
+
+  /**
+   * API : 查询当前登陆账号
+   * POST: /whoami  {}
+   * RES : {code:int, message:string}
+   */
+  async whoami(){
+    return this.request('/whoami', {}); 
+  }
+
+  /**
+   * API : 列出所有 App 信息, 参数 platform 可能为空, 此时应返回所有平台的 App
+   * POST: /app/list {platform:string|''}
+   * RES : {code:int, message:string, data:Array<DataItem>}
+   * DataItem: {
+   *   id:number|string,
+   *   name:string,
+   *   version:string,
+   *   android:string,      // apk url, 若不是 android app, 为空或null即可
+   *   android_md5:string,  // 若是 android app, 返回 apk 文件的 md5 值
+   *   ios:string,          // ipa url, 若不是 ios app, 为空或null即可
+   *   ios_md5:string,      // 若是 ios app, 返回 iap 文件的 md5 值
+   *   create_at:string,
+   * }
+   */
+  async listApp(platform){
+    platform = platform||null;
+    //const list = await this.request('/app/list', {platform})
+    const list = {
+      code:0,
+      message:'a',
+      data:[
+        {
+          id:'333',
+          name:'测试版',
+          version:'1.0',
+          android:'a',
+          android_md5:'ddddd',
+          ios:'cccc',
+          ios_md5:'dddd',
+          create_at:'2012-12-09 08:30',
+        },
+        {
+          id:'333',
+          name:'测试版',
+          version:'1.0',
+          android:'a',
+          android_md5:'ddddd',
+          ios:'cccc',
+          ios_md5:'dddd',
+          create_at:'2012-12-09 08:30',
+        },
+        {
+          id:'333',
+          name:'测试版',
+          version:'1.0',
+          android:'a',
+          android_md5:'ddddd',
+          ios:'cccc',
+          ios_md5:'dddd',
+          create_at:'2012-12-09 08:30',
+        },
+      ]
+    }
+    if (typeof list.code !== 'number' || list.code !== 0 || !Array.isArray(list.data) || !list.data.length) {
+      return list;
+    }
+    const {android, ios} = getConfig(this.cwd);
+    list.data = list.data.map(item => {
+      item.ios_current = Boolean(ios && ios == item.id);
+      item.android_current = Boolean(android && android == item.id);
+      return item;
+    });
+    return list;
+  }
+
+  /**
+   * API : 新增 App
+   * POST: /app/add {name, version}
+   * RES : {code:int, message:string}
+   */
+  async addApp(name, version){
+    return await this.request('/app/add', {name, version});
+  }
+
+  /**
+   * API : 上传安装包到指定的 app
+   * POST: /app/upload FormData:{id, platform:string, package:File}
+   * RES : {code:int, message:string}
+   */
+  async uploadApp(platform, packagePath, appId){
+    // 未指定 appId, 尝试自动获取当前项目绑定的 id
+    const {code, message} = getAppId(this.cwd, platform, appId);
+    if (code !== 0) {
+      return {code, message};
+    }
+    if (!fileExist(packagePath)) {
+      return {code:-2, message:'package not exist'}
+    }
+    return await this.request(
+      '/app/upload',
+      {id:message, platform, package:fs.createReadStream(packagePath)},
+      true
+    );
+  }
+
+  /**
+   * 列出指定 app 的所有热更版本 (
+   * POST: /patch/list {id, platform}
+   * RES : {code:int, message:string, data:Array<PatchItem>}
+   * PatchItem: {
+   *   id:string,
+   *   version:string,
+   *   desc:string,
+   *   active:boolean,      // 是否为已启用的热更版本
+   *   bundle:string,       // 全量 bundle 包的 url
+   *   bundle_md5:string,   // bundle 包文件的 md5 值
+   *   create_at:string,
+   * }
+   * 备注: 返回 data 中的 bundle 字段返回该热更版本的完整包下载地址
+   * patch_md5 为包文件的 md5 hash 值
+   */
+  async listPatch(platform, appId){
+    // 未指定 appId, 尝试自动获取当前项目绑定的 id
+    const {code, message} = getAppId(this.cwd, platform, appId);
+    if (code !== 0) {
+      return {code, message};
+    }
+    return {
+      code:0,
+      message:'a',
+      data:[
+        {
+          id:'333',
+          version:'1.0',
+          desc:'测试版',
+          bundle:'a',
+          bundle_md5:'ddddd',
+          create_at:'2012-12-09 08:30',
+          active:false
+        },
+        {
+          id:'333',
+          version:'1.0',
+          desc:'测试版',
+          bundle:'a',
+          bundle_md5:'ddddd',
+          create_at:'2012-12-09 08:30',
+          active:true
+        },
+        {
+          id:'333',
+          version:'1.0',
+          desc:'测试版',
+          bundle:'a',
+          bundle_md5:'ddddd',
+          create_at:'2012-12-09 08:30',
+          active:false
+        },
+        {
+          id:'333',
+          version:'1.0',
+          desc:'测试版',
+          bundle:'a',
+          bundle_md5:'ddddd',
+          create_at:'2012-12-09 08:30',
+          active:false
+        },
+      ]
+    }
+    return await this.request('/patch/list', {id:message, platform});
+  }
+
+  /**
+   * API : 上传热更包
+   * POST: /patch/upload FormData:{id, platform:string, package:File}
+   * RES : {code:int, message:string}
+   */
+   async uploadApp(platform, packagePath, appId){
+    // 未指定 appId, 尝试自动获取当前项目绑定的 id
+    const {code, message} = getAppId(this.cwd, platform, appId);
+    if (code !== 0) {
+      return {code, message};
+    }
+    if (!fileExist(packagePath)) {
+      return {code:-2, message:'package not exist'}
+    }
+    return await this.request(
+      '/app/upload',
+      {id:message, platform, package:fs.createReadStream(packagePath)},
+      true
+    );
+  }
+
+
+
+
+
+
+
+
+  // /**
+  //  * 上传新的更新补丁包
+  //  * POST: /patch/upload formData:{app:string, platform:string, version:string, bundle:File, patch:File, origin:string||null, diff:File||null}
+  //  * RES : {code:int, message:string}
+  //  * 备注: post 发送三个文件
+  //  *   1. bundle 为完整包
+  //  *   2. patch 为相对于安装包的补丁
+  //  *   3. diff 为相对于 origin bundle 的补丁
+  //  *   4. origin 是 diff 相对应的 bundel id
+  //  */
+  // async uploadPatch(appId, platform, version, bundle, patch, origin, diff){
+  //   if (!fileExist(bundle)) {
+  //     return {code:-2, message:'bundle file not exist'}
+  //   }
+  //   if (!fileExist(patch)) {
+  //     return {code:-2, message:'patch file not exist'}
+  //   }
+  //   if (diff && !origin) {
+  //     return {code:-2, message:'origin id not defined'}
+  //   } else if (origin) {
+  //     if (!diff) {
+  //       return {code:-2, message:'diff file not defined'}
+  //     } else if (!fileExist(diff)) {
+  //       return {code:-2, message:'diff file not exist'}
+  //     }
+  //   }
+  //   const payload = {
+  //     app:appId,
+  //     platform,
+  //     version,
+  //     bundle: fs.createReadStream(bundle),
+  //     patch: fs.createReadStream(patch)
+  //   };
+  //   if (origin) {
+  //     payload.origin = origin;
+  //     payload.diff = fs.createReadStream(diff);
+  //   }
+  //   return await sendRequest(cwd, '/patch/upload', payload, true);
+  // }
+
+
+  // /**
+  //  * 绑定 bundle, 即设定当前为指定的 热更版本
+  //  * POST: /patch/bind {app, platform, id}
+  //  * RES : {code:int, message:string}
+  //  */
+  // async bindPatch(platform, id, appId){
+  //   const {code, message} = getCurrentAppId(cwd, platform, appId);
+  //   if (code !== 0) {
+  //     return {code, message};
+  //   }
+  //   appId = message;
+  //   return await sendRequest(cwd, '/patch/bind', {app:appId, platform, id});
+  // }
+}
+
+module.exports = CommandAPI;

package/src/commands.js

@@ -0,0 +1,281 @@
+const path = require('path');
+const Shell = require('./shell');
+const CommandAPI = require('./api');
+const {supportPlatforms, color, makeSpinner, parseProcess, setConfig} = require('./utils');
+
+// 当前命令的 cwd api cmd{name args options} interact
+const cwd = process.cwd();
+const api = new CommandAPI(cwd);
+const cmd = parseProcess(process);
+const interact = new Shell(process);
+
+
+class Commands {
+
+
+
+
+  // 初始化, 配置 baseUrl
+  $init = 'base_url';
+  async init(){
+    let baseUrl = cmd.args.length ? cmd.args[0] : null;
+    baseUrl = baseUrl||await interact.ask("base url:");
+    return interact.showResult({code:0, message:'saved to: ' + path.basename(setConfig(cwd, {baseUrl}))})
+  }
+
+  
+
+
+
+
+
+
+
+}
+
+
+
+
+
+
+
+// Manage Account ===================================================================================
+
+// 初始化, 配置 baseUrl
+init.options = 'base_url';
+async function init() {
+  let baseUrl = cmd.args.length ? cmd.args[0] : null;
+  baseUrl = baseUrl||await interact.ask("base url:");
+  return interact.showResult({code:0, message:'saved to: ' + path.basename(setConfig(cwd, {baseUrl}))})
+}
+
+// 登陆
+login.options = '--user user --pwd pwd';
+async function login() {
+  let {user, pwd} = cmd.options;
+  user = user || await interact.ask("username:");
+  pwd = pwd || await interact.ask("password:");
+  return interact.showResult(await api.login(user, pwd))
+}
+
+// 查看当前登陆的账号
+async function whoami() {
+  return interact.showResult(await api.whoami())
+}
+
+// Manage App ===================================================================================
+
+// 列出所有 app
+app_list.options = '[--platform platform]';
+async function app_list() {
+  const list = await api.listApp(await interact.getPlatform(cmd.options.platform));
+  if (interact.showError(list)) {
+    return list;
+  }
+  const {data=[]} = list;
+  const table = data.map((item, index) => {
+    const row = {id:index, name:item.name, version:item.version, create_at:item.create_at};
+    row.ios = (item.ios && item.ios_md5 ? 'Y' : 'N');
+    if (item.ios_current) {
+      row.ios = color(row.ios + '*', 36, true)
+    }
+    row.android = (item.android && item.android_md5 ? 'Y' : 'N');
+    if (item.android_current) {
+      row.android = color(row.android + '*', 36, true)
+    }
+    return row;
+  });
+  interact.showTable(table);
+  return list;
+}
+
+// 新增 app
+app_add.options = '--name name --version version';
+async function app_add() {
+  let {name, version} = cmd.options;
+  name = name || await interact.ask("app name:");
+  version = version || await interact.ask("app version:");
+  return interact.showResult(await api.addApp(name, version))
+}
+
+// 将当前项目与服务端指定的 app 绑定
+app_bind.options = '--platform platform';
+async function app_bind() {
+  const list = await app_list();
+  const {data=[]} = list;
+  const platform = await interact.getPlatform(cmd.options.platform, true);
+  const id = await interact.getRealId("app id:", data);
+  return interact.showResult(supportPlatforms.includes(platform) 
+    ? {code:0, message:'saved to: ' + path.basename(setConfig(cwd, {[platform]:id}))}
+    : {code:-1, message:'platform not support'}
+  );  
+}
+
+// 上传 app 包
+app_upload.options = '--platform platform --package package_path';
+async function app_upload() {
+  let {platform, package:pack} = cmd.options;
+  platform = await interact.getPlatform(platform, true);
+  pack = pack || await interact.askPath("package path:", cwd);
+  const spinner = makeSpinner({
+    text:'uploading...',
+    stream: process.stdout
+  }).start();
+  const rs = await api.uploadApp(platform, path.join(cwd, pack));
+  spinner.stop();
+  return interact.showResult(rs)
+}
+
+// Manage Patch ===================================================================================
+
+// 列出所有 patch
+patch_list.options = '--platform platform';
+async function patch_list() {
+  const list = await api.listPatch(await interact.getPlatform(cmd.options.platform, true));
+  if (interact.showError(list)) {
+    return list;
+  }
+  const {data=[]} = list;
+  const table = data.map((item, index) => {
+    const row = {id:index, version:item.version, create_at:item.create_at};
+    row.active = (item.active ? color('Y', 36, true) : 'N');
+    row.desc = item.desc ? item.desc.substr(0, 20) + '...' : '';
+    return row;
+  });
+  interact.showTable(table);
+  return list;
+}
+
+// 新增 patch 包
+patch_upload.options = '--platform platform [--bundle bundle_path]';
+async function patch_upload() {
+  let {platform, version, bundle} = cmd.options;
+  platform = await interact.getPlatform(platform, true);
+  if (!bundle) {
+    interact.output("\n  You did not define bundle path\n")
+    const go = (await interact.ask('create new bundle? [Y|n|e]:')).toLowerCase();
+    if (go === 'e') {
+      process.exit();
+    }
+    if (go === 'n') {
+      bundle = await interact.askPath('set bundle path:');
+    }
+  }
+  return interact.showResult(await api.makeAndUploadPatch(cwd, platform, bundle, version, process.stdout, process.stderr))
+}
+
+// 绑定 patch
+patch_bind.options = '--platform platform';
+async function patch_bind() {
+  let {platform} = cmd.options;
+  platform = await getPlatform(platform, true);
+  const list = await patch_list_table(platform);
+  const {data=[]} = list;
+  const id = await getRealId(data, "patch id:");
+  return showApiRs(await api.bindPatch(cwd, platform, id))
+}
+
+// Build Tool ===================================================================================
+
+// 生成 android release apk 包
+apk.options = '[--target target --output save_path]';
+async function apk() {
+  return require('./pack').makeApk(cwd, packOptions(), process.stdout, process.stderr);
+}
+
+// 生成 ios release ipa 包
+ipa.options = '[--target target --output save_path]';
+async function ipa() {
+  return require('./pack').makeIpa(cwd, packOptions(true), process.stdout, process.stderr);
+}
+
+// 生成 bundle 包
+bundle.options = '--platform platform [--output save_dir --save-name save_name]';
+async function bundle() {
+  const options = cmd.options;
+  options.platform = await interact.getPlatform(options.platform, true);
+  return await require('./pack').makeBundle(cwd, options, process.stdout, process.stderr);
+}
+
+// 生成两个文件的 diff patch
+diff.options = 'origin_file new_file [--output save_name]';
+async function diff() {
+  return require('./patch').diff(cwd, await diffOptions('file'), process.stdout, process.stderr)
+}
+
+// 生成 bundle 相对于 apk 的补丁包
+diffapk.options = 'origin_apk new_bundle [--output save_name]';
+async function diffapk() {
+  return require('./patch').diffPackage(cwd, await diffOptions('apk'), process.stdout, process.stderr, false)
+}
+
+// 生成 bundle 相对于 ipa 的补丁包
+diffipa.options = 'origin_ipa new_bundle [--output save_name]';
+async function diffipa() {
+  return require('./patch').diffPackage(cwd, await diffOptions('ipa'), process.stdout, process.stderr, true)
+}
+
+// 生成 bundle 相对于 bundle 的补丁包
+diffbundle.options = 'origin_bundle new_bundle [--output save_name]';
+async function diffbundle() {
+  return require('./patch').diffBundle(cwd, await diffOptions('bundle'), process.stdout, process.stderr)
+}
+
+// 获取 apk/ipa 命令 options
+function packOptions(ipa) {
+  const {target='release', output, ...options} = cmd.options||{};
+  options.target = target;
+  if (!output) {
+    options.output = 'build/output/app-' + target + '.' + (ipa ? 'ipa' : 'apk');
+  }
+  return options;
+}
+
+// 获取 diff 命令 options
+async function diffOptions(type) {
+  let [origin, next] = cmd.args;
+  const output = cmd.options.output;
+  origin = origin || await interact.askPath(`origin ${type} path:`, cwd);
+  next = next || await interact.askPath(type === 'file' ? 'new file path:' : 'new bundle path:', cwd);
+  return {origin, next, output, cmd:true};
+}
+
+
+
+
+
+
+
+
+
+
+
+
+// exports ===================================================================================
+
+module.exports = interact.getCommandsExecuter([
+  'Manage Account',
+  init,
+  login,
+  whoami,
+
+  'Manage App',
+  [app_list],
+  app_add,
+  app_bind,
+  app_upload,
+
+  'Manage Patch',
+  [patch_list],
+  patch_upload,
+  patch_bind,
+
+  'Build Tool',
+  apk,
+  ipa,
+  bundle,
+  diff,
+  diffapk,
+  diffipa,
+  diffbundle,
+], {...cmd, showLogo:true});