V 平台二次开发工具

全局安装

    npm install v3dev-cli -g 

局部安装

    npm install v3dev-cli --save

注意:在安装本依赖包时请勿使用cnpm替代npm,cnpm安装依赖不完全,将导致工具运行异常,对于其他依赖包,您可以正常使用cnpm.

命令列表

v3 -h 帮助命令
v3 init 项目初始化,执行此命令时将在项目路径搜索package.json配置文件,如果有配置文件则可以将当前项目转换为v3项目,若没有则可以根据提示信息创建一个v3项目模板.
v3 init -n 在当前目录生成一个v3模板项目,并初始化npm依赖.
v3 install 打包并安装v3平台插件到本地.
v3 deploy 打包v3平台插件并部署到Vstore.
v3 update更新插件到V3服务器.
v3 sync 同步V3服务器中的Node.js插件到本地.
v3 switch 切换js解析插件,可选的插件有phantomJS与puppeteer.js,其中phantomJS安装时会下载约17M的解析器,puppeteer.js要求本机装有基于chromium核心的浏览器,且内核版本不低于49. 7674.

• 局部安装时对应的命令为:

v3 init    >>>    npm run v3init
v3 init -n    >>>    npm run v3init-n
v3 install    >>>    npm run v3install
v3 deploy    >>>    npm run v3deploy
v3 update    >>>    npm run v3update
v3 sync    >>>    npm run v3sync
v3 switch    >>>    npm run v3switch

• 模板项目提供一个局部webpack命令,执行npm run build即可

关于package.json配置项说明

"v3Platform": {
        "type": "插件类型：{[widget]控件,[rule]规则,[func]函数}",
        "matchVersion": "匹配的版本号",
        "minMatchVersion": "最小匹配版本号",
        "account": "Vstore账号",
        "pwd": "Vstore密码",
        "out": "jar生成目录",
        "sources": "vui源目录[可以为目录数组]",
        "libType": "部署库：{dev,test}",
        "server": "本地环境地址",
        "componentDefines": {
            "vuiTreeExtra": {
                "dataProp": "数据源属性名",
                "dataType": "数据类型",
                "treeStructProp": "树形结构属性"
            }
        }
    }

• 此部分在项目初始化时可以通过交互命令行进行快速配置,也可以手动修改,以下为一个配置示例:

"v3Platform": {
        "type": "widget",
        "matchVersion": "1",
        "minMatchVersion": "1",
        "account": "v3账号",
        "pwd": "密码",
        "out": "jar",
        "sources": "dist",
        "libType": "dev",
        "server": "http://10.1.26.72:8888",
        "componentDefines": {
            "vuiTreeExtra": {
                "dataProp": "data",
                "dataType": "String",
                "treeStructProp": "null"
            }
        }
    }

关于puppeteer插件的chrome浏览器路径配置

由于puppeteer插件安装时会从谷歌下载chrome浏览器,会导致下载失败,所以本工具要求本机装有基于chromium核心的浏览器,且内核版本不低于49. 7674,只需在package.json中的chromiumpath指定本机chrome浏览器的实际路径即可.

"chromiumpath": "F:\\chrome-win32\\chrome.exe"

快速获取浏览器路径:右键浏览器图标查看属性

FQA

• Q: 安装时提示 Missing write access to xxx :

• Q: 执行v3命令时提示Cannot find module .....

解决方法:在项目当前路径执行npm install即可.如果还有问题,请检查项目的package.json文件的dependencies和devDependencies节点的依赖包是否正确

• Q: v3 init执行npm初始化时提示权限不足,或执行npm install 时提示"operation not permitted ......"

• 已知bug:

修改于:2018-1-31