封装一个自己的JS或TS库,并发布到npm上

使用vite封装js库

基础环境:

Nodejs: 20.13.0

Npm: 10.5.2

1、开始创建基础项目

(1)创建vite项目

bash 复制代码
npm create vite

(2)输入y回车

(3)输入项目名称

(4)选择 Others[其他框架]

(5)选择其他

(6) 选择软件库模板

(7)选择js库,这里可以选择js/ts,因为我这边项目没有用ts所以示例选择js

(8)创建成功根据提示就可以运行刚创建的项目了

创建的项目目录

运行

2、了解项目结构和配置

(1)vite.config.js配置, Vite 项目中用来配置构建选项和插件的配置文件

javascript 复制代码
import { defineConfig } from 'vite'

export default defineConfig({
  build: { //打包配置
    lib: {
      entry: './lib/main.js',// 插件的入口文件,可以自定义修改
      name: 'CanvasLayer',// 插件的全局变量名称(浏览器环境下)
      fileName: 'Leaflet.canvas',// 构建后的输出文件名,不包括扩展名
    },
  },
})

(2)package.json: 定义这个项目所需要的各种模块,以及项目的配置信息,包括名称、版本、许可证、依赖模块等元数据

javascript 复制代码
{
  "name": "leaflet.canvas",
  "private": false,
  "version": "0.0.1",
  "type": "module",
  "files": [
    "dist"
  ],
  "main": "./dist/Leaflet.canvas.umd.cjs", // CommonJS 格式入口文件
  "module": "./dist/Leaflet.canvas.js",// ES模块格式入口文件
  "exports": {
    "import": "./dist/Leaflet.canvas.js",
    "require": "./dist/Leaflet.canvas.umd.cjs"
  },
  "scripts": {
    "dev": "vite",
    "build": "vite build" // 构建命令
  },
  "devDependencies": {
    "vite": "^6.0.1"
  }
}

(3)编写自己的软件库内容,这里就简单举例

(4)自己测试一下写的插件是否正常运行

3、打包发布到npm上

1、打开npm官网,点击 注册(Sign Up)

注册-登录

2、项目设置npm源

设置发布源(npm镜像):在项目根目录创建一个 .npmrc 文件,内容如下

javascript 复制代码
registry=https://registry.npmjs.org/

注:有的小伙伴就喜欢指定到淘宝镜像,这种情况你会将项目发布到淘宝源上面,如果使用者没有配置npm镜像为淘宝源,那么他就会从npm官方镜像下载,就找不到你这个库,懂了吧? 所以,我们要指定为npm官方源

ps:淘宝npm镜像站(点击可以打开) 它的程序会自己爬取npm官方的内容,所以你发布到npm官方的开放式软件库它就会自己爬过来(定时的、不能达到实时更新),你也可以手动更新淘宝镜像里面你的软件库的版本为最新(采用哪种方式看你自己)

3、打包构建项目

bash 复制代码
npm run build

4、打包成功后,项目中会多出来一个dist文件

5、发布到npm

bash 复制代码
1 从配置文件获取 npm 源
npm config get registry

2 非官方npm源的话需要设置npm源
npm config set registry https://registry.npmjs.org/

# 登录npm 账户(回车就行了,会自动打开浏览器,填个邮箱验证码就行了)
npm login

# 提交代码到 npm
npm publish

注意:可能会存在发布失败的情况,根据失败日子去排查,失败了多发布几次就可以,或者可能给是插件名称重复导致的,修改插件名称后重新发布。

上面发布报错就是名字在npm上已经有了,那就修改一下名称重新发布

5、至此插件已经发布npm成功了

4、到使用的项目中安装使用刚发布插件

使用npm命令安装

bash 复制代码
npm i leaflet.canvas.test.csl

安装成功后

在组件中使用

本文只是简单记录一下封装一个js库的步骤,先入门再精通

本文参考了其他大佬的文章,可以学习参考:

https://juejin.cn/post/7385778376276049961

手把手教你实现一个npm包

如何使用vite框架封装一个js库,并发布npm包_vite 打包js-CSDN博客

相关推荐
2301_776681654 分钟前
【用「概率思维」重新理解生活】
开发语言·人工智能·自然语言处理
熊大如如30 分钟前
Java 反射
java·开发语言
Peter 谭1 小时前
React Hooks 实现原理深度解析:从基础到源码级理解
前端·javascript·react.js·前端框架·ecmascript
ll7788111 小时前
C++学习之路,从0到精通的征途:继承
开发语言·数据结构·c++·学习·算法
我不想当小卡拉米1 小时前
【Linux】操作系统入门:冯诺依曼体系结构
linux·开发语言·网络·c++
周胡杰1 小时前
鸿蒙接入flutter环境变量配置windows-命令行或者手动配置-到项目的创建-运行demo项目
javascript·windows·flutter·华为·harmonyos·鸿蒙·鸿蒙系统
teacher伟大光荣且正确1 小时前
Qt Creator 配置 Android 编译环境
android·开发语言·qt
炎芯随笔1 小时前
【C++】【设计模式】生产者-消费者模型
开发语言·c++·设计模式
乌鸦9442 小时前
《类和对象(下)》
开发语言·c++·类和对象+
炒空心菜菜2 小时前
SparkSQL 连接 MySQL 并添加新数据:实战指南
大数据·开发语言·数据库·后端·mysql·spark