Webpack コアコンセプトのエントリー構成 (エントリー)

すべてのプロセスの開始時に、1 つ以上のエントリを指定する必要があります。これは、ソース ディレクトリ内のどのファイルからパッケージ化を開始するかを Webpack に指示することを意味します。次の記事では、webpack の核となる概念であるエントリ構成 (entry) について詳しく説明しますので、お役に立てれば幸いです。

#プロジェクト内の各モジュールの依存関係がツリーと見なされる場合、エントリは依存関係ツリーのルートです

依存関係のあるこれらのモジュールは、パッケージ化時にチャンクにカプセル化されます。

チャンクとは何ですか?

chunk は文字通りコード ブロックを意味し、Webpack では抽象化されパッケージ化されたいくつかのモジュールとして理解できます。これは、多くのファイルが含まれるファイル バッグのようなものです。内部のファイルは各モジュールです。Webpack は、チャンクを形成するために外側にパッケージングの層を追加します。

特定の構成とは異なり、プロジェクトをパッケージ化するときに 1 つ以上のチャンクが生成される場合があります。

プロジェクトでは複数の入り口を定義でき、各入り口は結果リソースを生成します

たとえば、プロジェクト

src/index.js には 2 つの入り口があります。および src/lib.js ですが、通常の状況では、dist/index.js と dist/lib.js がパッケージ化されて生成されます。

一部の特殊なケースでは、1 つのエントリで複数のチャンクが生成され、最終的には複数のバンドルが生成される場合があります。

Entry (エントリ)

---

パラメータ: エントリ

• エントリは構成モジュール への入り口であり、次のように抽象化できます。 Webpack によるビルド実行の最初のステップは、エントリが依存するすべてのモジュールを検索して再帰的に解析することです。
エントリの構成が必要です。入力されていない場合、Webpack はエラーを報告します

module.exports = {
	entry:'./src/index.js', //表示入口文件，即从index.js进入我们的项目
};

①エントリの種類

TypeExample意味#string'./app/entry'エントリ モジュールのファイル パス。相対パスarray['./app/entry1', './app/entry2']エントリ モジュール。相対パスにすることができますobject{ a: './app/entry-a', b: ['./app/entry -b1', './app/entry-b2']}複数の入り口を構成します。各入り口はチャンクを生成します

如果是 array 类型，则搭配 output.library 配置项使用时，只有数组里的最后一个入口文件的模块会被导出

②Chunk 名称

Webpack 会为每个生成的 Chunk 取一个名称，Chunk 的名称和 Entry 的配置有关：

• 如果 entry 是一个 string 或 array ，就只会生成一个 Chunk，这时 Chunk 的名称是 main ；
• 如果 entry 是一个 object ，就可能会出现多个 Chunk，这时 Chunk 的名称是 object 键值对里键的名称

③Entry 配置动态

假如项目里有多个页面需要为每个页面的入口配置一个 Entry ，但这些页面的数量可能会不断增长，则这时 Entry 的配置会受到到其他因素的影响导致不能写成静态的值。其解决方法是把 Entry 设置成一个函数去动态返回上面所说的配置，代码如下：

// 同步函数
entry: () => {
  return {
    a:'./pages/a',
    b:'./pages/b',
  }
};
// 异步函数
entry: () => {
  return new Promise((resolve)=>{
    resolve({
       a:'./pages/a',
       b:'./pages/b',
    });
  });
};

参数：context

Webpack 在寻找相对路径的文件时会以 context 为根目录，context 默认为执行启动 Webpack 时所在的当前工作目录。 如果想改变 context 的默认配置，则可以在配置文件里这样设置它：

module.exports = {
	context: path.resolve(__dirname, 'app')
}

注意， context 必须是一个绝对路径的字符串。 除此之外，还可以通过在启动 Webpack 时带上参数 webpack --context 来设置 context

单个入口文件配置

---

用法：entry:string|Array<string></string>

1、简写语法

webpack.config.js

//由于是单个，所以可以简写成：
module.exports = {
  entry: './main.js'
};

上面的入口配置写法其实是下面的简写

module.exports = {
  entry: {
    main: './main.js'
  }
};

2、数组语法

module.exports = {
  entry: {
    main:['./main.js','./main2.js']
  }
};

传入一个数组的作用是将多个资源预先合并，在打包时Webpack会将数组中的最后一个元素作为实际的入口路径

在使用字符串或数组定义单入口时，并没有办法更改chunk name，只能为默认的“main”。

多个入口文件配置

---

用法：entry: {[entryChunkName: string]: string|Array}

对象语法

module.exports = {
  entry: {
    app: './src/app.js',
    vendors: './src/vendors.js'
  }
};

这会比较繁琐。然而这是应用程序中定义入口的最可扩展的方式。

“可扩展的 webpack 配置”：可重用并且可以与其他配置组合使用。这是一种流行的技术，用于将关注点从环境(environment)、构建目标(build target)、运行时(runtime)中分离。然后使用专门的工具（如 webpack-merge）将它们合并。

应用场景

---

1、单页应用

无论是框架、库，还是各个页面的模块，都由app.js单一的入口进行引用。这样做的好处是只会产生一个JS文件，依赖关系清晰。

module.exports = {
  entry: './src/app.js'
};

这种做法也有弊端，即所有模块都打包到一起，当应用的规模上升到一定程度之后会导致产生的资源体积过大，降低用户的页面渲染速度

在Webpack默认配置中，当一个bundle大于250kB时（压缩前）会认为这个bundle已经过大了，在打包时会发生警告，如图：

2、分离第三方库(vendor)

为解决上方的问题，可以提取第三方库(vender)

vendor的意思是“供应商”，在Webpack中vendor一般指的是工程所使用的库、框架等第三方模块集中打包而产生的bundle

module.exports = {
  entry: {
    app: './src/app.js',
    vendors: ['react','react-dom','react-router'],
  }
};

基于但也应用的例子，我们添加了一个新的chunk name为vendor的入口，并通过数组的形式把工程所依赖的第三方模块放了进去

我们并没有为vendor设置入口路径，Webpack要如何打包呢？

这时我们可以使用CommonsChunkPlugin（在Webpack 4之后CommonsChunkPlugin已被废弃，可以采用optimization.splitChunks）将app与vendor这两个chunk中的公共模块提取出来

通过这样的配置，app.js产生的bundle将只包含业务模块，其依赖的第三方模块将会被抽取出来生成一个新的bundle，这也就达到了我们提取vendor的目标

由于vendor仅仅包含第三方模块，这部分不会经常变动。因此可以有效地利用客户端缓存，在用户后续请求页面时会加快整体的渲染速度。

CommonsChunkPlugin主要是用来提取第三方库和公共模块，避免首屏加载的bundle文件或者按需加载的bundle文件体积过大，从而导致加载时间过长。

3、多页应用

对于多页应用的场景，为了尽可能减小资源的体积，我们希望每个页面都只加载各自必要的逻辑，而不是将所有页面打包到同一个bundle中。因此每个页面都需要有一个独立的bundle，这种情形我们使用多入口来实现。请看下面的例子：

module.exports = {
  entry: {
    pageOne: './src/pageOne/index.js',
    pageTwo: './src/pageTwo/index.js',
    pageThree: './src/pageThree/index.js'
  }
};

上面的配置告诉webpack 需要 3 个独立分离的依赖图，此时入口与页面是一一对应的，这样每个HTML只要引入各自的JS就可以加载其所需要的模块

更多编程相关知识，请访问：编程视频！！

以上がWebpack コアコンセプトのエントリー構成 (エントリー)の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。