1. Sitecoreホスト

ランタイムプラグインを手動で追加する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

プラグインはNugetパッケージとして配布されます。プラグインをホストアプリケーションに追加して実行時にロードされるようにするには、プラグインを解凍し、そのアセットを正しい場所にコピーする必要があります。

以下の例は、MyPluginというプラグインをインストールする方法を示しています。

環境フォルダを作成する

まだお持ちでない場合は、sitecoreruntimeフォルダの下に環境フォルダを作成する必要があります。Sitecore Hostアプリケーションは、その環境をデフォルトでProductionに設定します。起動時に (--envコマンドで) 別の環境が提供されない限り、最初にproductionフォルダが検索されます。

SitecoreHostApp
└── sitecoreruntime/
    └── <env>/

例えば: hostapp/sitecoreruntime/production

プラグインの異なるコレクションを含む環境フォルダーはいくつでも作成できますが、Sitecore Hostアプリケーションで一度にロードできる環境は1つだけです。

プラグインフォルダを作成する

プラグイン用のフォルダを作成する必要があります。ここには、プラグインマニフェスト、アセット、および設定があります。これは、個々の環境フォルダ内にあるsitecoreフォルダ内にあります。

SitecoreHostApp
└── sitecoreruntime/
    └── <env>/
        └── sitecore/
            └── MyPlugin/
       ├── sitecore.plugin.manifest
                ├── content/
                └── config/  

sitecoreruntime/<env>/sitecoreフォルダは、hostssitecoreフォルダ内のファイルを上書きしません。これは、プラグインアセットの読み込みに使用される一意のフォルダです。

ランタイム環境フォルダーに、独自のsitecoreruntimeフォルダーを含めることはできません。

Nugetパッケージからプラグイン データをアンパックする

MyPlugin.1.0.0.nupkgというNugetプラグインパッケージがあると仮定します。

  1. プラグインの内容をダウンロードして解凍します。

    メモ

    Sitecore Hostプラグインには、nupkgパッケージのルートに特別なsitecoreディレクトリが含まれており、その中に追加のものが含まれています。それ以外はすべて標準のNuget構造です。

  2. Nugetsitecoreフォルダーの内容を、前に作成したプラグイン フォルダー ( sitecoreruntime/production/sitecore/mypluginなど) にコピーします。

  3. プラグインパッケージにlibフォルダが含まれている場合は、正しいターゲットフレームワークからアセットをsitecoreruntime/<env>フォルダのルートにコピーします (例:sitecoreruntime/production/*.dll)。

  4. プラグインが必要とする可能性のあるアセンブリを、Nugetに依存する他のパッケージから同じ方法で追加します。

最終的な構造は、次のようになります。

SitecoreHostApp
└── sitecoreruntime/
    └── <env>/
        ├── *.dll
        └── sitecore/
            └── MyPlugin/
                ├── sitecore.plugin.manifest
                ├── content/
                └── config/
この記事を改善するための提案がある場合は、 お知らせください!