---
title: "ランタイムプラグインを手動で追加してください"
slug: "add-a-runtime-plugin-manually"
abstract: "プラグインのインストール方法、環境フォルダやプラグインフォルダの作成方法、Nugetパッケージからプラグインデータのアンパック方法などが含まれます。"
---
# ランタイムプラグインを手動で追加してください

プラグインはNugetパッケージとして配布されます。ホストアプリケーションにプラグインを追加して実行時に読み込むには、プラグインをアンパックし、その資産を正しい場所にコピーする必要があります。

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

-   [環境フォルダを作成する](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/add-a-runtime-plugin-manually.html#UUID-efcb35b3-401f-399a-8224-de8e5378f1d9_section-idm45495722118672 "Create an environment folder")
-   [プラグインフォルダを作成する](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/add-a-runtime-plugin-manually.html#UUID-efcb35b3-401f-399a-8224-de8e5378f1d9_section-idm45679423143392 "Create a plugin folder")
-   [Nugetパッケージからプラグインデータを解凍する](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/add-a-runtime-plugin-manually.html#UUID-efcb35b3-401f-399a-8224-de8e5378f1d9_section-idm45363803631184 "Unpack plugin data from a Nuget package")

## 環境フォルダを作成する

もしまだ持っていなければ、sitecoreruntimeフォルダの下に環境フォルダを作成する必要があります。Sitecoreホストアプリケーションは環境をデフォルトで本番環境に設定します。起動時に別の環境が提供されていない限り(--envコマンドで)、まず本番フォルダを探します:

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

例えば: hostapp/sitecoreruntime/production

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

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

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

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

sitecoreruntime/<env>/sitecoreフォルダはホストのsitecoreフォルダ内のファイルを上書きしません。これはプラグインアセットの読み込みに使われるユニークなフォルダです。

ランタイム環境のフォルダは、それ自体でsitecoreruntimeフォルダーを持てません。

## Nugetパッケージからプラグインデータを解凍する

MyPlugin.1.0.0.nupkgというNugetプラグインパッケージをお持ちの場合:

1.  プラグインの内容をダウンロードして解凍してください。
    
    > !注Sitecoreホストプラグインは、nupkgパッケージのルートに特別なsitecoreディレクトリを持ち、その中に追加のものが入っています。それ以外はすべて標準的なNuget構造です。
    
2.  Nugetsitecoreフォルダの内容を以前作成したプラグインフォルダにコピーします(例: sitecoreruntime/production/sitecore/myplugin)。
    
3.  プラグインパッケージにlibフォルダがある場合は、正しい[ターゲットフレームワーク](https://docs.microsoft.com/en-us/nuget/create-packages/supporting-multiple-target-frameworks#framework-version-folder-structure)からsitecoreruntime/<env>フォルダのルートにアセットをコピーします(例:sitecoreruntime/production/\*.dll)。
    
4.  プラグインが依存する他のパッケージから追加アセンブリを追加し、Nugetからも同様に追加できます。
    

最終的な構造は以下の通りであるべきです。

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