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":
- 此部分在项目初始化时可以通过交互命令行进行快速配置,也可以手动修改,以下为一个配置示例:
"v3Platform":
关于puppeteer插件的chrome浏览器路径配置
由于puppeteer插件安装时会从谷歌下载chrome浏览器,会导致下载失败,所以本工具要求本机装有基于chromium核心的浏览器,且内核版本不低于49. 7674,只需在package.json中的chromiumpath指定本机chrome浏览器的实际路径即可.
"chromiumpath": "F:\\chrome-win32\\chrome.exe"
快速获取浏览器路径:右键浏览器图标查看属性
FQA
-
Q: 安装时提示 Missing write access to xxx :
解决方法:到当前安装目录下找到v3dev-cli文件夹删除,然后重新安装即可.全局安装时为nodeJS的安装目录下的node_modules,局部安装时在你项目的node_modules目录下. -
Q: 执行v3命令时提示Cannot find module .....
解决方法:在项目当前路径执行npm install即可.如果还有问题,请检查项目的package.json文件的dependencies和devDependencies节点的依赖包是否正确
-
Q: v3 init执行npm初始化时提示权限不足,或执行npm install 时提示"operation not permitted ......"
解决方法: 删除当前项目的node_modules文件夹,然后重新执行npm install命令即可 -
已知bug:
v3 sync命令暂无法使用
修改于:2018-1-31