22

文档

中文文档 补充于02月10日

vue脚手架的3.x版本已经在开发中,现在还处于alpha版本。
我们来看看有哪些变化。

使用

npm install -g @vue/cli

命名方式已经改为npm推荐的新的包名规则,使用作用域。详情可查看此文章

命令变化

vue -h
我们看到

  1. create [options] <app-name> 创建一个由vue-cli-service支持的新项目
  2. invoke <plugin> 在已创建的项目中添加插件
  3. serve [options] [entry] 在开发者模式下以零配置运行一个js或vue文件
  4. build [options] [entry] 在生产模式下以零配置构建一个js或vue文件
  5. init <template> <app-name> 旧api 需要@vue/cli-init // 就是原来的vue-cli init <template> <app-name>

中文是我加的
说到零配置,可以看看这个Parcel,生态还不完善,零配置的缺点就是不够自由。

那么vue-cli-service是什么?这个几个新的命令有是什么?
我们先试着创建一个项目。

初始化模板

vue create my-project
这个时候会进入选项

? Please pick a preset:
> default (babel, eslint)
> Manually select features //手动选择功能

我们选择default走向

default路线

Pick the package manager to use when installing dependencies: //用哪个下载依赖
> Use Yarn
  Use NPM

// 现在的顺序是Yarn在第一位的
因为没有装Yarn,所以使用NPM

然后出现提示,进入安装过程

Vue CLI v3.0.0-alpha.5
✨  Creating project in E:\git\note\my-project. // 创建项目
�  Initializing git repository... // 初始化git库
⚙  Installing CLI plugins. This might take a while... // 安装脚手架插件

提示里多了些符号,气氛变得活泼起来。

其实这个过程中还会判断你对npm/yarn源的连接速度,询问你是否切换至淘宝镜像

 Your connection to the the default npm registry seems to be slow.
 Use https://registry.npm.taobao.org for faster installation? 

完成之后我们可以看到除node_modules之外的目录结构变成了

│  package-lock.json
│  package.json
├─public
│      favicon.ico
│      index.html
└─src
    │  App.vue
    │  main.js
    ├─assets
    │      logo.png
    └─components
            HelloWorld.vue

build哪里去了?config哪里去了?配置都消失了?

我们观察一下npm脚本命令

  "serve": "vue-cli-service serve",
  "build": "vue-cli-service build",
  "lint": "vue-cli-service lint"

现在是依靠vue-cli-service来运行的。那么那些配置应该就在vue-cli-service当中(所谓零配置),所以vue-cli-service应该是起的一个服务。

自定义路线

我们选择Manually select features之后

? Check the features needed for your project: (Press <space> to select, <a> to toggle all, <i> to invert selection)
>( ) TypeScript
 ( ) Progressive Web App (PWA) Support
 ( ) Router
 ( ) Vuex
 ( ) CSS Pre-processors
 ( ) Linter / Formatter
 ( ) Unit Testing
 ( ) E2E Testing

看到可以自由组合现在所需的功能了。
创建的过程中会询问配置文件保存位置是config.js还是package.json,但是其中也是一些简单的配置。

vue-cli-service功能

vue-cli-service应该还提供了一些没说明的用法
这部分会持续更新

生成 web components 规范的组件代码

配置npm 脚本"build:components": "vue-cli-service build --target wc-async **/*.vue"

可以直接把 Vue 的组件代码生成 web components 规范的组件代码,不过要记得 web components 的规范里组件名中是必须有横线的,所以使用 app 这样的组件名会导致构建失败
来自勾三股四微博

变化

  1. 可以看到以前繁琐的配置文件不见了,变成了一种约定大于配置的状态(查看issues,其实还是能配置的,需要创建vue.config.js文件),根据命令行描述和文档说明是可以在此基础上配置其他各种插件的,但是我没有深入研究。
  2. 文档中有提到It automatically infers the entry file in the current directory,所以我尝试着添加过个html文件看是否能达到直接变成多页面应用,没有成功,可能还有其他方法。
  3. 添加了对npm源的连接速度的判断

后话

vue-cli还在开发当中,文档还没完成,创建完项目根据配置不同还是存在一些问题的,大家可以去讨论并提出你的想法,参与pr,去拿contribution吧。


更新于02月07日beta版要发版了,下周应该会有官方文档出来


toBeTheLight
16.6k 声望26.6k 粉丝

学习数学知识(0/n)