我想发布一个 vue 的组件库

1,448 阅读4分钟

于是,我开始了各种学习和整理。

创建一个单纯的 Webpack 项目

在 《揭开TypeScript的面纱》 juejin.cn/post/690313… 中,写了各种示例代码,终于可以学以致用放到 Webpack 项目中实践一番啦。所以我们要创建的单纯的 Webpack 项目需要能够提供 ts 的环境。从 0 到 1 的具体配置开始吧:

### 初始化
npm init --yes
tsc --init

### 安装loader plugin 以及必要的工具
这些都是我们开发环境要用的依赖,所以我们这里安装的时候使用的是 npm install module_name -D  即 npm install module_name --save-dev 写入devDependencies,devDependencies只是我们开发使用。  
还有一点就是为了避免不兼容出现的问题,我们这里指定了
npm i webpack@4 webpack-cli@3 webpack-dev-server -D
npm i html-webpack-plugin clean-webpack-plugin webpack-merge ts-loader typescript -D

### 编写Webpack的4个配置文件
webpack.base.config.js 是开发环境和生产打包环境公共的一些配置;
webpack.dev.config.js 是开发环境的配置,devtool 配置为 eval-cheap-module-source-map,不显示错误信息的列号,定位到源码,并且能够保证build\rebuild的速度。
webpack.pro.config.js 是生产环境配置

### 编写启动和打包命令
在 package.json 文件中,分别编写启动和打包命令。启动脚本采用的是 webpack-dev-server, 打包脚本采用的是 webpack。

### 程序启动
npm start

### 打包
npm run build

至此,我们完成了 Webpack 4+TypeScript 的项目构建。这部分github:github.com/YY88Xu/ts-i…

封装 Vue 组件

环境搭建

我们在上一章的项目基础上继续搭建:

### 增加Vue
npm i vue@2     // 指定vue版本
npm i vue-loader vue-template-compiler css-loader -D   // 开发环境需要

为了使用 Vue 完整版,则需要在打包工具里配置一个别名:

// webpack.base.config.js
module.exports = {
	...
    resolve: {
        alias: {
            vue: 'vue/dist/vue.esm.js'
        }
    },
}

配置 .vue 和 .css 使用的 loader,这里还有修改一下ts-loader 的配置,因为我们在 .vue 文件中也会编写 ts 的代码。

// webpack.base.config.js
    module: {
        rules: [
            {
                test: /\.vue$/,
                loader: 'vue-loader'
            },
            {
                test: /\.tsx?$/i,
                use: [
                    {
                        loader: 'ts-loader',
                        options: {
                            appendTsSuffixTo: [/\.vue$/]
                        }
                    }
                ],
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    'vue-style-loader',
                    'style-loader',
                    'css-loader'
                ]
            }
        ]
    },

加载 VueLoaderPlugin

// webpack.base.config.js
const VueLoaderPlugin = require('vue-loader/lib/plugin');
...
    plugins: [
        new VueLoaderPlugin()
    ]

配置 vue 的声明文件 vue-shims.d.ts

// vue-shims.d.ts
declare module '*.vue'{
    import Vue from 'vue'
    export default Vue
}

为了在 Vue 中使用 TypeScript,这里我们比以往的配置多了两步:

  1. 新增了 ts-loader, 用于编译 .ts 文件;
  2. 新增了 vue的声明文件,用来让 TypeScript 识别 Vue。

组件封装

封装分页组件,功能比较简单,如下:

修改 webpack 的配置文件

开发环境用于显示和测试我们编写组件,而生产环境则是要将我们的组件打包成 js 文件,所以 webpack.pro.config.js 和 webpack.dev.config.js 要配置不同的入口文件和打包后文件。

新增 main.ts 文件作为生产环境的入口文件

// main.ts  导入我们的组件并将它导出出去。
import SamplePage from './components/SamplePage.vue';
export default SamplePage;

//webpack.pro.config.js
module.exports = {
    entry: './src/main.ts',
    output: {
        filename: 'samplePage.js',   //打包后文件
        libraryTarget: 'umd',    //设置library的暴露方式为“umd”,该方案支持commonjs、commonjs2、amd,可以在浏览器、node中通用。
        library: 'SamplePage'
    },
 }

开发入口还是 index.ts。

编写组件的声明文件

为了能够支持 TypeScript语法识别,需要新增组件SamplePage的声明文件 samplePage.d.ts 新建 types 文件夹,里面新建 samplePage.d.ts 文件,根据组件对外暴露的属性和方法,编写对应的声明文件:

import Vue from 'vue';
declare class SamplePage extends Vue{
    zoomList: number[];
    height: string;
    changePage(params: number): void;
}

export as namespace SamplePage

export = SamplePage
修改 package.json 的配置文件

修改 package.json 文件的入口文件为组件打包后的文件,即 samplePage.js 文件。同时,指定声明文件的位置。

   ...
  "main": "./dist/samplePage.js",
  "types": "./types/samplePage.d.ts"

到这一步,我们已经把一个 Vue 组件封装好了,坐等发布,github: github.com/YY88Xu/samp…

发布组件

先登录npm, 没有账号的可以在官网注册一下:www.npmjs.com/

// 在项目的terminal
npm login   //登录用户名、密码、邮箱
npm publish   //发布

可能会遇到 npm ERR! 403 403 Forbidden - PUT registry.npm.taobao.org/sample-page - [no_perms] Private mode enable, only admin can publish this module
这是因为镜像源切到了淘宝源,需要将淘宝源切回到npm.

//查看当前的登录源:
npm config get registry

淘宝源,需要切回到npmjs源,输入以下命令:

npm config set registry=http://registry.npmjs.org

也可能报 npm ERR! You do not have permission to publish "package-demo". Are you logged in as the correct user? : package-demo

提示没有权限,其实就是你的module名在npm上已经被占用啦,这时候你就去需要去npm搜索你的模块名称,如果搜索不到,就可以用,并且把package.json里的name修改过来,重新npm publish,看到如下信息就表示安装完成了。

使用自己发布的组件

在新的项目中,通过 npm install sample-page 命令将组件安装到项目中。可以在组件中使用 sample-page 组件。

<template>
    <div>
        <p>是我</p>
        <SamplePage :zoomList="msg"></SamplePage>
    </div>
</template>

<script lang="ts">
    import Query from 'vue-employee-query';
	export default {
		name: "App",
        components: {
            SamplePage
        },
        data(){
		    return {
		        msg: 2
            }
        }
	}
</script>

这里我们并没有安装要求给 zoomList 传递数组类型,那么在 DevTools 里面我们就可以看到如下的报错信息了: