vue3企业级组件库封装[四]:使用Vite打包组件库

将介绍如何使用 vite 打包我们的组件库,同时告诉大家如何使用插件让打包后的文件自动生成声明文件
(*.d.ts)

四、使用Vite打包组件库

1、打包配置

vite 专门提供了库模式的打包方式,配置其实非常简单,首先全局安装 vite 以及@vitejs/plugin-vue

pnpm add vite @vitejs/plugin-vue -D -w

在 components 文件下新建 vite.config.ts 配置文件

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
export default defineConfig({
build: {
//打包后文件目录
outDir: "wk",
//压缩
minify: false,
rollupOptions: {
//忽略打包vue文件
external: ["vue"],
//input: ["index.ts"],
output: {
globals: {
vue: "Vue",
},
dir: "dist",
},
},
lib: {
entry: "./index.ts",
name: "wukong-ui",
fileName: "wukong-ui",
formats: ["es", "umd", "cjs"],
},
},
plugins: [vue()],
});

然后在 components/package.json 添加打包命令 scripts

"scripts": {
"build": "vite build"
},

执行 pnpm run build => 打包后的 dist 文件

但是这种打包方式最终会将整个组件库打包到一个文件中 , 所以我们需要修改一下配置让打包后的结构和我们开发的结构一致

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
export default defineConfig({
build: {
//打包文件目录
outDir: "wk",
//压缩
//minify: false,
rollupOptions: {
//忽略打包vue文件
external: ["vue"],
input: ["index.ts"],
output: [
{
//打包格式
format: "es",
//打包后文件名
entryFileNames: "[name].mjs",
//让打包目录和我们目录对应
preserveModules: true,
exports: "named",
//配置打包根目录
dir: "../dist/wk",
},
{
//打包格式
format: "cjs",
//打包后文件名
entryFileNames: "[name].js",
//让打包目录和我们目录对应
preserveModules: true,
exports: "named",
//配置打包根目录
dir: "../dist/wk",
},
],
},
lib: {
entry: "./index.ts",
},
},
plugins: [vue()],
});

这里就只有一个样式没有按需出来了 =》后期处理

2、声明文件

这里其实打包的组件库只能给 js 项目使用,在 ts 项目下运行会出现一些错误，而且使用的时候还会失去代码提示功能，这样的话我们就失去了用 ts 开发组件库的意义了。所以我们需要在打包的库里加入声明文件(.d.ts)。

安装 vite-plugin-dts

pnpm add vite-plugin-dts@1.4.1 -D -w

在 vite.config.ts 引入,注意这里同时添加了组件命名插件`DefineOption

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import dts from "vite-plugin-dts";
import DefineOptions from "unplugin-vue-define-options/vite";
export default defineConfig({
plugins: [
vue(),
dts({
entryRoot: "./src",
outputDir: ["../dist/es/src", "../dist/lib/src"],
//指定使用的tsconfig.json为我们整个项目根目录下,如果不配置,你也可以在components下新
建tsconfig.json
tsConfigFilePath: "../../tsconfig.json",
}),
DefineOptions(),
],
});

再次打包就会发现打包后文件中出现了我们需要的声明文件

其实现在大部分前端构建脚手架都支持 esmodule 了,而 esmodule 本身就支持按需加载,所以说组件库
打包后的 es 格式它本身自带 treeShaking,而不需要额外配置按需引入。

下一节见https://blog.youkuaiyun.com/fageaaa/article/details/154338083