Fantasy CLI

一张图团队命令行工具。将具备构建项目、生成feature功能块等功能。

前提

使用 Fantasy CLI 之前须满足以下条件：

• 公司 VPN 已连接；
• 拥有 GitLab 账号；
• [email protected]+ 开发环境;
• yarn 已全局安装；
• [email protected]+ 已安装。

当前版本

当前版本为 v2.6.19 正式版。

更新说明

优化：

• 修复以项目形式初始化 Feature 后运行失败问题。

安装

命令面板输入如下命令进行安装。

全局安装

安装完成后可在任何目录使用 Fantasy CLI。

• Windows：

  • npm i -g fantasy-cli

• Mac：

  • sudo npm i -g fantasy-cli

卸载

命令面板输入如下命令进行卸载。

全局卸载

• Windows：

  • npm uninstall -g fantasy-cli

• Mac：

  • sudo npm uninstall -g fantasy-cli

命令

Mac 用户须以管理员权限执行命令，即fantasy前加sudo！

fantasy（fantasy -h）

查看 Fantasy CLI 的用法、命令 及 说明。

fantasy -v

查看 Fantasy CLI 当前版本。

fantasy create

当前位置创建项目工作区文件夹 fantasy。

fantasy list

项目初始化模板列表。

fantasy init <name>

以 name 作为项目目录名称初始化项目。

配置项：

• -a <address>：使用指定git仓库克隆地址初始化项目，address：项目 clone 地址；

  • 示例：

    • fantasy init <name> -a <address>

    • # v0.3版本尝鲜
      fantasy init test -a http://192.168.198.162/gisveiwer/share/fantasy-start-empty.git#develop-v0.3

• -t <template>：使用指定模板初始化项目，template：模板名称。

  • 示例：

    • fantasy init <name> -t <template>

  • 当前已有模板：

    • fantasy list

fantasy feature <featureModuleName>

以 featureModuleName 作为 Feature 模块名称初始化 Feature，默认以模块形式初始化 Feature。

配置项：

• -p <featureProjectName>：以项目形式初始化 Feature，featureProjectName：Feature 项目名称；

  • 示例：

    • fantasy feature <featureModuleName> -p <featureProjectName>

• -m：以模块形式初始化 Feature。

  • 示例：

    • fantasy feature <featureModuleName> -m

fantasy theme

为 Fantasy 项目或产品提供主题定制功能的初始化服务。

历史版本

以下为 Fantasy CLI 所有历史版本：

• v0.1.0：beta 版，针对 npm 安装 gitlab 私有仓库包进行测试；
• v0.2.1：beat 版，增加创建工作区功能，修复旧版本 bug；
• v0.2.2：beta 版，优化初始化项目，将通过询问机制生成更合规的项目；指定工作区名称为fantasy；
• v0.2.3：beta 版，优化初始化项目，增加通过模板名称或模板地址初始化项目，增加本地通用库处理；
• v1.2.3：正式版，优化初始化项目，增加通过模板名称或模板地址初始化项目，增加本地通用库处理；
• v1.2.4：正式版，优化初始化项目，修复分支名称存在'.'导致package.json更新异常的特殊情况；
• v1.2.5：正式版，优化初始化项目，本地通用库依赖绑定git权限；
• v1.2.6：正式版，项目依赖体积缩小，提高安装速度；
• v2.3.7：正式版，MacOS 兼容；GitLab 接入；初始化项目权限优化；
• v2.4.7：正式版，新增命令list，项目初始化模板列表;
• v2.5.8：正式版，新增命令feature，初始化 Feature;
• v2.5.9：正式版，初始化 Feature，优化；
• v2.5.10：正式版，初始化 Feature，优化；
• v2.5.11：正式版，初始化 Feature 优化，添加询问机制，自动更新 Feature 中的引入关系；
• v2.5.12：正式版，代码优化，初始化 Feature 自动安装依赖;
• v2.5.13：正式版，初始化 Feature 优化;
• v2.5.14：正式版，初始化 Feature 优化；
• v2.5.15：正式版，修复本地通用库安装失败问题；
• v2.5.16：正式版，优化初始化项目，可关联远程仓库，并自动签出 develop 分支，同时对主要分支进行分支保护;
• v2.5.17：正式版，优化初始化 Feature，以项目形式初始化 Feature 可关联远程仓库，并自动签出 develop 分支，同时对主要分支进行分支保护；
• v2.6.18：正式版，新增命令theme，项目初始化主题功能；
• v2.6.19：正式版，修复以项目形式初始化 Feature 后运行失败问题。