フィードバックを送信
Liferay npm Bundler (Deprecated)
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

バンドラーがnpmパッケージを公開する方法

重要

Liferay npm バンドラーは Liferay 2024.Q4/Portal GA129 で廃止され、将来削除される予定です。

指定された 構造を使用して OSGi バンドルをデプロイすると、そのモジュールは正規の URL を通じて使用できるようになります。 解決されたモジュールをわかりやすく説明するために、以下のサンプル構造は、liferay-npm-bundler 1.xが生成する標準構造です。 2.xバージョンが生成する名前空間付きパッケージはありません。 以下で説明するように、liferay-npm-bundler 2.0は、この重複除外メカニズムをオーバーライドして、独立した依存関係とインポートを実装します。

  • my-bundle/
    • META-INF/
      • resources/
        • package.json - 名前: my-bundle-package - バージョン: 1.0.0 - メイン: lib/index - 依存関係: - isarray: 2.0.0 - isobject: 2.1.0 - …
        • lib/ - index.js - …
        • …
        • node_modules/ - isobject@2.1.0/ - package.json - 名前: isobject - バージョン: 2.1.0 - メイン: lib/index - 依存関係: - isarray: 1.0.0 - … - … - isarray@1.0.0/ - package.json - 名前: isarray - バージョン: 1.0.0 - … - … - isarray@2.0.0/ - package.json - 名前: isarray - バージョン: 2.0.0 - … - …

上記のサンプルOSGiバンドルをデプロイすると、以下のURLが使用可能になります（モジュールごとに1つ）。

注

OSGiバンドルID（598）は異なる場合があります。

パッケージの重複除外

2つ以上のOSGiモジュールが同じパッケージとバージョンの複数のコピーをエクスポートする可能性があるため、Liferayポータルは、 解決モジュールと呼ばれる新しい概念を使用して、このような競合を重複排除する必要があります。

解決されたモジュールとは、同じパッケージとバージョンの複数のコピーが存在する場合に、Liferay Portal のフロントエンドにエクスポートされる参照パッケージです。 パッケージの同じコピーをエクスポートするいくつかのバンドルの1つからランダムに参照されます。

上記の例を使用すると、異なるOSGiバンドル内の同じモジュールを参照する正規URLのグループごとに、解決されたモジュールの別の正規URLがあります。 構造例には、以下に示す解決済みのモジュールURLがあります。

注

OSGi バンドル ID (例では 598) が削除され、モジュールは 解決されたモジュールに置き換えられます。

次に、バンドラー（バージョン2.0.0以降）がパッケージの依存関係を分離する方法を学びます。 この変更が行われた理由の詳細については、「 liferay-npm-bundler 1.x と 2.x の間で何が変わったか 」を参照してください。

分離されたパッケージの依存関係

liferay-npm-bundler 2.xで生成された典型的なOSGiバンドル構造を以下に示します。

  • my-bundle/
    • META-INF/
      • resources/
        • package.json - 名前: my-bundle-package - バージョン: 1.0.0 - メイン: lib/index - 依存関係: - my-bundle-package$isarray: 2.0.0 - my-bundle-package$isobject: 2.1.0 - …
        • lib/ - index.js - …
        • …
        • node_modules/ - my-bundle-package$isobject@2.1.0/ - package.json - 名前: my-bundle-package$isobject - バージョン: 2.1.0 - メイン: lib/index - 依存関係: - my-bundle-package$isarray: 1.0.0 - … - … - my-bundle-package$isarray@1.0.0/ - package.json - 名前: my-bundle-package$isarray - バージョン: 1.0.0 - … - … - my-bundle-package$isarray@2.0.0/ - package.json - 名前: my-bundle-package$isarray - バージョン: 2.0.0 - … - …

各パッケージの依存関係は、バンドルの名前（例の構造ではmy-bundle-package $）で名前空間になっていることに注意してください。 これにより、各プロジェクトは独自の依存関係をロードし、同じパッケージをエクスポートするプロジェクトとの潜在的な競合を回避できます。 たとえば、以下の2つのウィジェットプロジェクトについて考えてみます。

  • my-widget

    • package.json
      • 依存関係：
        • a-library 1.0.0
        • a-helper 1.0.0
    • node_modules
      • a-library
        • バージョン：1.0.0
        • 依存関係: - a-helper ^1.0.0
      • a-helper
        • バージョン：1.0.0

  • another-widget

    • package.json
      • 依存関係：
        • a-library 1.0.0
        • a-helper 1.2.0
    • node_modules
      • a-library
        • バージョン：1.0.0
        • 依存関係: - a-helper ^1.0.0
      • a-helper
        • バージョン：1.2.0

この例では、 a-library はバージョン1.0.0以降の a-helper 依存しています（依存関係のキャレット^式に注意してください）。 バンドラはバンドルの名前をモジュールに先行することによって分離された依存関係を実装します。そのため、my-widgetは1.0.0でa-helperを取得します。 another-widgetは1.2.0でa-helperを取得します。

依存関係の分離は、バンドル間の衝突を回避するだけでなく、開発時に各ウィジェットが node_modules フォルダー内にあったものを取得するため、ピアの依存関係を確定的に動作させます。

名前空間モジュールがバンドルの依存関係を分離して衝突を回避する方法を理解したので、次に重複除外について学習できます。

インポートによる重複除外

分離された依存関係は便利ですが、モジュール間で同じパッケージを共有する方が有益な場合があります。 これを行うために、liferay-npm-bundlerは、独自のパッケージを使用する代わりに、外部OSGiバンドルからパッケージをインポートできます。 これで、共有された依存関係を1つのプロジェクトに配置して、残りのプロジェクトから参照できます。

例えば、3つのウィジェット、my-toolbar、my-menu、およびmy-contentの場合、サイトのホームページを作成します。 これらのウィジェットは、偽物に依存しますが、素晴らしいUIコンポーネント(WUI)フレームワークです。 この非常に制限されたフレームワークには、3つのパッケージしか含まれていません。

  1. component-core
  2. button
  3. textfield

バンドラーはデフォルトでウィジェットの名前を使用して各依存パッケージに名前空間を付けるので、ページ上のWUIパッケージの名前空間付きコピーが3つになります。 これはあなたが望むものではありません。 それらは同じパッケージを共有するため、WUIパッケージを含む4番目のバンドルを作成し、3つのウィジェットにWUIパッケージをインポートできます。 これにより、以下の構造になります。

  • my-toolbar/
    • .npmbundlerrc
      • 構成：
        • imports: - wui-provider: - component-core: 1.0.0 - button: 1.0.0 - textfield: ^1.0.0
  • my-menu/
    • .npmbundlerrc
      • 構成：
        • imports: - wui-provider: - component-core: 1.0.0 - button: 1.0.0 - textfield: ^1.0.0
  • my-content/
    • .npmbundlerrc
      • 構成：
        • imports: - wui-provider: - component-core: 1.0.0 - button: 1.0.0 - textfield: ^1.0.0
  • wui-provider/
    • .package.json
      • name: wui-provider
      • 依存関係：
        • component-core: 1.0.0
        • button: 1.0.0
        • textfield: 1.0.0

バンドラーは、特定のパッケージの名前空間を切り替えて、外部バンドルを指すようにします。 my-toolbar ウィジェットに次のコードがあるとします。

var Button = require('button');

デフォルトでは、別のバンドルからインポートされない場合、bundler 2.xはこれを次のように変換します。

var Button = require('my-toolbar$button');

ただし、 ボタン は wui-providerからインポートされるため、代わりに以下の値に変更されます。

var Button = require('wui-provider$button');

また、ローダーが正しいバージョンを見つけることができるように、バージョン ^ 1.0.0 wui-provider$button への依存関係が my-toolbarの package.json ファイルに含まれています。 必要なのはそれだけです。 実行時に wui-provider$button が必要になると、コードは my-toolbarから実行された場合でも、 wui-providerのコンテキストにジャンプし、そこからサブ依存関係をロードします。 これが機能するのは、ご想像のとおり、 wui-providerのモジュールにも名前空間があり、そこからモジュールをロードすると、 wui-provider $ 接頭辞付きモジュールがずっと必要になるためです。

パッケージをインポートするときの戦略

インポートによる重複除外は強力なツールですが、エラーが発生しないようにバージョン管理戦略を設計する必要があります。

最初に、インポートされた依存関係を .npmbundlerrc ファイルでのみ宣言するか、 package.json でも宣言するかを決定する必要があります。 インポートされた依存関係を .npmbundlerrc リストするだけで十分です。 node_modules フォルダーにない場合でも、ローダーは実行時にそれを見つけます。 インポートされた依存関係を .npmbundlerrc リストするだけで十分です。 node_modules フォルダーに存在しない場合でも、ローダーは実行時にそれを見つけます。 標準オペレーティングシステムでのダイナミックリンクサポートの経験がある場合は、DLLまたは共有オブジェクトと考えてください。

テストに依存関係を使用する場合、またはコンパイルに必要なタイプが含まれている場合（Typescriptなど）、依存関係を node_modules もインストールする必要がある場合があります。 その場合は、 package.jsonの 依存関係 または devDependencies セクションに配置できます。 それらを後者の下にリストすると、liferay-npm-bundlerによって出力バンドルから自動的に除外されます。 それ以外の場合は、 .npmbundlerrc ファイルでそれらを除外して、出力に重複して表示されないようにする必要があります。

依存関係を両方とも package.json および .npmbundlerrcにリストする場合は、バージョンの同期を保つ方法を決定します。 両方のファイルで同じバージョンの制約を使用することをお勧めしますが、必要な場合は使用しないこともできます。 たとえば、実行時にテストを実行するために、依存関係の1つを別のバンドルからインポートするとします。 バージョン制約 1.5.1 を使用しているとします。 コードをバージョン >=1.5.1 および <2.0.0 ( 1.5.1 の意味) でテストした場合、実行時に互換性のあるバージョンを取得することが望ましいでしょう。 したがって、 .npmbundlerrc でも ^1.5.1 の依存関係を宣言することになります。

ただし、より寛容になりたい場合もあり、 1.5.1 に対して開発している場合でも、実行時に低いバージョン (たとえば 1.4.0) を取得する必要がある場合があります。 その場合、 package.json で 1.5.1 を宣言し、 .npmbundlerrcで ^1.0.0 を宣言できます。

最終的には、依存関係をどのように扱うかは、あなた次第です。

  1. package.json (開発中)
  2. .npmbundlerrc (実行中)

実行時に依存関係が満たされるように、バージョン管理戦略を選択してそれに従うことをお勧めします。

Capability:
Development and Tooling
Resource Type:
Official Documentation
Feature:
Developer Tools
Deployment Approach:
Liferay PaaS
Liferay SaaS
Liferay Self-Hosted