SharePoint ソリューション パッケージを作成する
配置パッケージを作成したりカスタマイズしたりするには、パッケージ デザイナーを使用します。 たとえば、SharePoint のプロジェクト項目およびフィーチャーの追加、IIS サーバーのリセット、フィーチャーのアクティブ化スコープの設定、フィーチャーの依存関係の特定などを行うことができます。 このデザイナーでは、マニフェスト (個々のパッケージを記述した XML ファイル) を生成することもできます。
パッケージ作成ツール
パッケージ デザイナーを使用して、パッケージをカスタマイズしたりマニフェストを生成したりできます。 SharePoint のプロジェクト項目の追加、Web サーバーのリセットの構成、および配置用サーバーの種類の設定を行うことができます。 詳細については、「方法: パッケージ デザイナーを使用してパッケージの機能と項目を追加および削除する」を参照してください。
また、パッケージング エクスプローラーを使用して、パッケージ ファイル (.wsp) 内の機能と項目を変更できます。 詳細については、「方法: パッケージング エクスプローラーを使用してパッケージの機能と項目を追加および削除する」を参照してください。
Visual Studio および MSBuild を使用して、SharePoint ソリューションを配置するためのパッケージ (.wsp) ファイルを作成できます。 SharePoint の配置に必要なマニフェスト ファイルはこのプロセスで生成されます。 詳細については、「方法: MSBuild タスクを使用して SharePoint ソリューション パッケージを作成する」を参照してください。
パッケージ デザイナーのオプション
次の表は、パッケージ デザイナーを使用してカスタマイズできる、SharePoint パッケージのプロパティの一覧です。
| パッケージ デザイナーのプロパティ | 既定の設定に関する説明 |
|---|---|
| 名前 | 必須。 パッケージの既定の名前は ProjectName に設定されます。 |
| [Web サーバーのリセット] | 省略可能。 SharePoint サーバーに .wsp ファイルがインストールされた後に Web サーバーを再起動する場合に選択します。 |
| 配置サーバーの種類 | 省略可能。 パッケージをホストするサーバーの種類を表します。 設定されていない場合、既定では WebFrontEnd エンドになります。 ApplicationServer: サービスをホストするサーバーを表します。 WebFrontEnd: Web サイトをホストするサーバーを表します。 |
| [ソリューション内の項目] | パッケージに追加できるすべての SharePoint プロジェクト項目およびフィーチャーを表します。 |
| [パッケージ内の項目] | 省略可能。 パッケージ内の配置対象の SharePoint プロジェクト項目およびフィーチャーを表します。 |
パッケージ化プロセスを構成する
Visual Studio で SharePoint ソリューションを開発したら、プロジェクトのパッケージ化方法をカスタマイズできます。
次の表に、.wsp ファイルの作成方法をカスタマイズするために使用できる 2 つの MSBuild ターゲットを示します。
| 移行先 | 説明 |
|---|---|
| BeforeLayout | ファイルが中間ディレクトリにコピーされる直前にタスクを実行するターゲット。 パッケージ ファイル (.wsp) を作成する前に、ファイルに変更を加えることができます。 |
| AfterLayout | ファイルが中間ディレクトリにコピーされた直後にタスクを実行するターゲット。 |
詳細については、「方法: MSBuild ターゲットを使用して SharePoint ソリューション パッケージをカスタマイズする」を参照してください。
パッケージ化のアーキテクチャ
Visual Studio で SharePoint パッケージ (.wsp) を作成すると、次の手順が実行されます。
パッケージの物理構造と意味構造が正しいことを確認するために、フィーチャーおよびパッケージが検証されます。
パッケージ内のフィーチャー、プロジェクト項目、およびパッケージ ファイルが列挙されます。 パッケージおよびフィーチャーのマニフェスト ファイルが変換されて、配置およびアクティブ化に必要な情報がすべて追加されます。 トークンは完全修飾値に置き換えられます。
カスタマイズ可能な BeforeLayout MSBuild ターゲットが実行されます。 この手順を作成して、.wsp ファイルの作成前に、パッケージに独自の変更を適用できます。
列挙されたファイルが中間ディレクトリにコピーされます。
カスタマイズ可能な AfterLayout MSBuild ターゲットが実行されます。 この手順を作成して、.wsp ファイルの作成前に、パッケージに独自の変更を適用できます。
中間ディレクトリのファイルが .wsp ファイルに追加されます。
パッケージ フォルダーの構造
SharePoint プロジェクトをパッケージ化すると、SolutionFolder\bin\<BuildConfiguration> フォルダーに .wsp ファイルが自動的に作成されます。 たとえば、ソリューションが C:\Visual Studio 2013\Projects\ListDefinition1 にあり、ビルド構成が [リリース] に設定されている場合、.wsp ファイルは C:\Visual Studio 2013\Projects\ListDefinition1\bin\Release に置かれます。