首页 > web前端 > js教程 > 正文

使用 Rollup 创建具有 CommonJS 和 ESM 支持的 NPM 包

心靈之曲
发布: 2024-10-15 08:21:12
转载
1025人浏览过

使用 rollup 创建具有 commonjs 和 esm 支持的 npm 包

使用 rollup 创建具有 commonjs (cjs) 和 ecmascript 模块 (esm) 支持的 npm 包

在这篇文章中,我们将探索如何使用 rollup 创建支持 commonjs (cjs) 和 ecmascript 模块 (esm) 的 npm 包。

rollup 是一个 javascript 捆绑器,非常适合创建库和包,因为它生成高度优化的代码包,可以在不同环境中轻松使用。

项目结构:

my-npm-package/
├── src/
│   └── index.js
├── rollup.config.js
└── package.json
登录后复制

1. 配置项目

首先为您的 npm 包创建一个新目录。在目录中,运行命令:

npm init -y
登录后复制

这将生成一个基本的 package.json 文件。

然后安装必要的依赖项:

npm install rollup rollup-plugin-commonjs rollup-plugin-node-resolve
登录后复制

解释依赖关系:

  • rollup:模块打包工具。
  • rollup-plugin-commonjs: 用于处理 commonjs 模块的 rollup 插件。
  • rollup-plugin-node-resolve: 用于解决 node.js 模块依赖关系的 rollup 插件。

2.创建src文件夹

在项目目录中创建一个名为 src 的文件夹。

在 src 中,使用 npm 包中的代码创建一个 index.js 文件。

// src/index.js
function hello(name) {
  return `hello, ${name}!`;
}

export { hello };
登录后复制

3. 创建 rollup.config.js 文件

使用 rollup 配置创建 rollup.config.js 文件。

rollup 有 2 个输出配置选项: 第一个:所有代码都在一个输出文件中。 第二个:使用preservemodules来维护模块结构。

3.1 rollup.config.js 文件,不保留模块结构

rollup 默认情况下将所有模块合并到一个输出文件中。这意味着您的所有模块(包括您自己的模块及其依赖项)都将合并到一个 javascript 文件中。

GPTKit
GPTKit

一个AI文本生成检测工具

GPTKit 108
查看详情 GPTKit
//rollup.config.js

import commonjs from 'rollup-plugin-commonjs';
import resolve from 'rollup-plugin-node-resolve';

export default [
  {
    input: 'src/index.js', // arquivo principal de entrada
    output: {
      file: 'dist/index.cjs.js', // diretório de saída para commonjs
      format: 'cjs',
      sourcemap: true,
    },
    plugins: [
      resolve(),
      commonjs(),
    ],
  },
  {
    input: 'src/index.js', // arquivo principal de entrada
    output: {
      file: 'dist/index.esm.js', // diretório de saída para es modules
      format: 'esm',
      sourcemap: true,
    },
    plugins: [
      resolve(),  // resolve módulos de node_modules
      commonjs()  // converte pacotes commonjs para esmodules
    ],
  },
];
登录后复制

解释设置:

  • input: 定义 rollup 的输入文件。
  • output: 设置输出文件和输出格式。
  • format: 定义模块格式(esm 或 commonjs)。
  • plugins: 定义将在 rollup 中使用的插件。

3.2 rollup.config.js 文件保留模块结构

rollup 保留了原始代码的模块结构。项目中的每个模块都将打包在自己的文件中。

import resolve from '@rollup/plugin-node-resolve';
import commonjs from '@rollup/plugin-commonjs';

export default {
  input: 'src/index.js',  // arquivo principal de entrada
  output: [
    {
      dir: 'dist/cjs', // diretório de saída para commonjs
      format: 'cjs',
      entryfilenames: '[name].js', // mantém o nome do arquivo original
      exports: 'auto',
      preservemodules: true, // preserva a estrutura dos módulos
      preservemodulesroot: 'src', // diretório base que será mantido
    },
    {
      dir: 'dist/esm', // diretório de saída para es modules
      format: 'esm',
      entryfilenames: '[name].js',
      preservemodules: true,
      preservemodulesroot: 'src',
    }
  ],
  plugins: [
    resolve(),  // resolve módulos de node_modules
    commonjs()  // converte pacotes commonjs para esmodules
  ]
};
登录后复制

解释设置:

  • entryfilenames: 使用占位符定义输出文件名的模式:
    • [name]: 替换为模块名称。
    • [hash]:替换为文件的唯一哈希值。
    • [format]: 替换为模块格式(esm 或 cjs)。
  • preservemodules: 保留代码的原始模块结构。如果为 true,每个模块将打包在自己的文件中。
  • preservemodulesroot: 定义要保留的模块的根目录。

4.配置package.json

使用以下信息更新 package.json 文件:

{
  "name": "my-npm-package",
  "version": "1.0.0",
  "description": "",
  "main": "dist/index.cjs.js",
  "module": "dist/index.esm.js",
  "scripts": {
    "build": "rollup -c",
    "dev": "rollup -c --watch"
  },
  "repository": {
    "type": "git",
    "url": "git+https://github.com/your-username/my-npm-package.git"
  },
  "author": "",
  "license": "mit",
  "devdependencies": {
    "rollup": "^3.2.1",
    "rollup-plugin-commonjs": "^18.0.0",
    "rollup-plugin-node-resolve": "^6.3.0"
  }
}
登录后复制

解释属性:

  • 名称: npm 包名称。
  • 版本:套餐版本。
  • 描述:包装描述。
  • main: 定义 commonjs 项目的主文件。
  • 模块: 定义 esm 项目的主文件。
  • 脚本: 定义用于构建和开发的脚本。
  • repository: 定义包存储库。
  • 作者: 包作者姓名。
  • 许可证: 软件包许可证。

5. 编译并发布包

运行 npm install 命令来安装依赖项。

运行 npm run build 命令来编译您的包。这将在 dist/.

中生成编译后的文件

然后使用 npmpublish 命令将包发布到 npm。

6. 使用包

您现在可以在其他项目中使用您创建的 npm 包。

  • commonjs 项目中的示例:
const mypackage = require('my-npm-package');

console.log(mypackage.hello('world'));
登录后复制
  • esm 项目中的示例(当 package.json 具有 "type": "module" 时):
import { hello } from 'my-npm-package';

console.log(hello('World'));
登录后复制

结论

使用 rollup 创建具有 commonjs 和 esm 支持的 npm 包非常简单。通过遵循本文中概述的步骤,您可以构建一个灵活的、可重用的包,以满足不同项目的需求。

以上就是使用 Rollup 创建具有 CommonJS 和 ESM 支持的 NPM 包的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:dev.to网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号