vue3.0组件库（Vue3 企业级优雅实战 – 组件库框架 – 11 组件库的打包构建和发布）

回顾第一篇文章中谈到的组件库的几个方面          ，只剩下最后的          、也是最重要的组件库的打包构建  
 
  
 
  
 
  
 
  
 
 、本地发布










、远程发布了
  
  
  
  
  
。

1 组件库构建

组件库的入口是 packages/yyg-demo-ui  
 
  
 
  
 
  
 
  
 
 ，构建组件库有两个步骤：

添加 TypeScript 的配置文件： tsconfig.json 添加 vite.config.ts 配置文件










，配置打包方式 
  
  
  
  
 。

1.1 tsconfig.json

在 packages/yyg-demo-ui 中添加 tsconfig.json 文件：

{ "compilerOptions": { "target": "ESNext", "useDefineForClassFields": true, "module": "ESNext", "moduleResolution": "Node", "strict": true, "jsx": "preserve", "sourceMap": true, "resolveJsonModule": true, "isolatedModules": true, "esModuleInterop": true, "lib": ["ESNext", "DOM"], "skipLibCheck": true, "declaration": true, "baseUrl": "." }, "include": ["../**/*.ts", "../**/*.d.ts", "../**/*.tsx", "../**/*.vue"], "exclude": ["../**/node_modules/"] }

1.2 vite.config.ts

打包构建时需要提取类型定义
  
  
  
  
  ，可以使用 vite 插件 vite-plugin-dts 


 


 


 


 


 。首先在 packages/yyg-demo-ui 中添加该插件为开发依赖：

pnpm install vite-plugin-dts -D

然后创建 vite.config.ts 文件：

import { defineConfig } from vite import vue from @vitejs/plugin-vue import * as path from path import VueJsx from @vitejs/plugin-vue-jsx import viteDts from vite-plugin-dts export default defineConfig({ plugins: [ vue(), VueJsx(), viteDts({ insertTypesEntry: true, staticImport: true, skipDiagnostics: true }) ], build: { lib: { entry: path.resolve(__dirname, ./index.ts), name: yyg-demo-ui, fileName: format => `yyg-demo-ui.${format}.js` }, outDir: path.resolve(__dirname, ../../lib), rollupOptions: { external: [vue], output: { globals: { vue: Vue } } } } })

1.3 package.json

在 packages/yyg-demo-ui/package.json 中添加打包 scripts  
  
  
  
  
 ，上面的配置指定了打包输出目录为项目根目录下的 lib
 


 


 


 


 


，每次打包前希望先删除该目录
 
 
 
 
 ，可以使用 rimraf
 
 
 
 
 
。在该模块中先安装 rimraf：

pnpm install rimraf -D

在 package.json 中添加 script：

"scripts": { "build": "rimraf ../../lib && vue-tsc --noEmit && vite build" },

执行 pnpm run build 开始打包  
   
   
   
   
 。

打包成功后   
   
   
   
   
 ，项目根目录下生成 lib 目录
 

 

 

 

 

，包括 ES 规范和 UMD 规范和类型定义文件 

 

 

 

 

 。

2 组件库的本地发布

2.1 根目录 package.json scripts

到目前为止

 

 

 

 

 ，整个组件库有很多个包           ，每个包都有一些 scripts：

cli: - gen: 创建新组件 docs： - dev：本地开发组件库文档 - build：打包构建组件库文档 - serve：预览组件库文档打包 example： - dev:dev
  
  
  
  
  、dev:uat  
  
  
  
  
 、dev:prod：本地开发 example - build:dev
 


 


 


 


 


、build:uat
 
 
 
 
 、build:prod：打包构建 example - preview：预览 example 打包构建后的结果 packages/yyg-demo-ui: - build：打包构建组件库

上面这些 scripts 都需要进入到对应的目录执行
 
 

 
 

 
 

 
 

 
 

，这样比较麻烦









，所以可以将这些命令汇总到根目录的 package.json 中                ，这样无论是哪个模块的 scripts 
 
 
 
 
 
 
 
 
 
，都从根目录执行即可

 

 

 

 

 
。

"scripts": { "dev:dev": "pnpm run -C example dev:dev", "dev:uat": "pnpm run -C example dev:uat", "dev:prod": "pnpm run -C example dev:prod", "build:dev": "pnpm run -C example build:dev", "build:uat": "pnpm run -C example build:uat", "build:prod": "pnpm run -C example build:prod", "preview:example": "pnpm run -C example preview", "build:lib": "pnpm run -C packages/yyg-admin-ui build", "docs:dev": "pnpm run -C docs dev", "docs:build": "pnpm run -C docs build", "docs:preview": "pnpm run -C docs serve", "gen:component": "pnpm run -C cli gen", "lint": "eslint \"{cli,packages,docs,example}/**/*.{js,ts,vue,jsx,tsx}\" --fix" },

通过 -C 指定 scripts 的位置          。

2.2 安装本地私服 verdaccio

几个月前程序员优雅哥分享过使用 Docker 搭建 Nexus3 私服















，Nexus3 相对重量级          ，如果在本地测试  
 
  
 
  
 
  
 
  
 
 ，使用 verdaccio 即可










，verdaccio 算得上本地的一款轻量级私服了 
 

 
 

 
 

 
 

 
 

 。

安装 verdaccio

verdaccio 通常是全局安装（-g）
  
  
  
  
  ，在咱们组件库中为了大家 clone 代码操作方便  
  
  
  
  
 ，便将其安装到根目录的开发依赖中：

pnpm install verdaccio -D -w 启动 verdaccio

在根目录 package.json 的 scripts 中添加启动 verdaccio 的命令

"start:verdaccio": "pnpm verdaccio",

这一步可省略
 


 


 


 


 


，只因为我用 WebStorm
 
 
 
 
 ，添加到 scripts中不用每次输入命令   
   
   
   
   
 ，能偷懒的必须偷懒










。

执行 start:verdaccio 后
 

 

 

 

 

，控制台会提示访问地址 http://localhost:4873/                。在浏览器中访问该路径 
 
 
 
 
 
 
 
 
 
 。

创建用户   
   
   
   
   
 、登录

在浏览器中按照界面提示创建用户
 

 

 

 

 

、登录















。在命令行中执行下列命令创建用户：

npm adduser --registry http://localhost:4873/

依次输入用户名

 

 

 

 

 、密码           、邮箱

 

 

 

 

 ，回车便成功创建账号并自动登录上          。

使用刚才输入的用户名和密码           ，在浏览器中登录
 
 

 
 

 
 

 
 

 
 

，登录前刷新浏览器 
 
  
 
  
 
  
 
  
 
  。

2.3 本地发布

在发布前









，需要修改项目根目录 package.json 的几个地方：

添加如下配置                ，指定 private 为 false
 
 

 
 

 
 

 
 

 
 

、设置 main









、module                、types 
 
 
 
 
 
 
 
 
 
、files等属性： { ... "private": false, "type": "module", "main": "./lib/yyg-demo-ui.umd.js", "module": "./lib/yyg-demo-ui.es.js", "types": "./lib/yyg-demo-ui/index.d.ts", "files": [ "./lib", "package.json", "README.md" ], "exports": { ".": { "require": "./lib/yyg-demo-ui.umd.js", "import": "./lib/yyg-demo-ui.es.js" } }, ... } 自己修改 author； 在 scripts 中添加发布组件库的命令： "pub:local": "pnpm publish --registry http://localhost:4873/", 在项目根目录下添加一份 README.md 文件









。

在发布前 
 
 
 
 
 
 
 
 
 
，如果代码纳入 git 管理















，需要提交代码          ，再执行 pnpm run pub:local
  
  
  
  
  
。显示如下信息则发布成功：

刷新浏览器  
 
  
 
  
 
  
 
  
 
 ，可以看到刚才发布的组件库 
  
  
  
  
 。

3 测试使用组件库

3.1 创建新项目

使用 vite 或 yyg-cli 创建新的 vue 项目：

pnpm create vite

进入新创建的 vue 项目










，pnpm install 安装依赖
  
  
  
  
  ，依赖安装成功后先执行 pnpm run dev 测试项目是否正常运行 


 


 


 


 


 。

3.2 安装依赖

由于咱们的组件库依赖于 element-plus  
  
  
  
  
 ，故首先安装element-plus：

pnpm install element-plus

由于安装咱自己的组件库需要指定 registry
 


 


 


 


 


，registry 变了
 
 
 
 
 ，pnpm 需要重新执行 install：

pnpm install --registry http://localhost:4873/

最后指定 registry 安装咱们的组件库：

pnpm install yyg-demo-ui --registry http://localhost:4873/

3.3 引入组件库

在 main.ts 中引入 element-plus 和 yyg-demo-ui：

... import ElementPlus from element-plus import element-plus/dist/index.css import YygDemoUi from yyg-demo-ui createApp(App) .use(ElementPlus) .use(YygDemoUi) .mount(#app)

在 App.vue 中使用组件库中的 foo 组件：

<yyg-foo msg="测试组件库"></yyg-foo>

启动项目   
   
   
   
   
 ，测试运行效果
 
 
 
 
 
。从浏览器和浏览器 console 中可以看出一切正常  
   
   
   
   
 。这样组件库便成功发布了 

 

 

 

 

 。

4 其他说明

发布到 npmjs 与本地发布的操作一样
 

 

 

 

 

，registry 需要指定为 https://registry.npmjs.org/ 无论是发布到本地还是 npmjs

 

 

 

 

 ，如果提示无权限           ，都可以使用 npm login 先登录： npm login --registry http://xxxxxx 再次发布前需要修改版本号

 

 

 

 

 
。可以使用如下 npm 命令修改版本号： // 最后一位（patch）版本号加1 npm version patch // 中间一位（minor）版本号加1 npm version minor // 第一位（major）版本号加1 npm version major

组件库的打包构建和发布
 
 

 
 

 
 

 
 

 
 

，咱就聊到这里          。

感谢阅读本文









，如果本文给了你一点点帮助或者启发                ，还请三连支持一下 
 
 
 
 
 
 
 
 
 
，了解更多内容工薇号“程序员优雅哥
  
  
  
  
  
” 
 

 
 

 
 

 
 

 
 

 。