SharePoint ソリューションパッケージの作成

2011-08-09

配置パッケージを作成したりカスタマイズしたりするには、パッケージデザイナーを使用します。たとえば、SharePoint のプロジェクト項目およびフィーチャーの追加、IIS サーバーのリセット、フィーチャーのアクティブ化スコープの設定、フィーチャーの依存関係の特定などを行うことができます。このデザイナーでは、マニフェスト (個々のパッケージを記述した XML ファイル) を生成することもできます。

パッケージ化ツール

パッケージデザイナーを使用すると、パッケージをカスタマイズしたりマニフェストを生成したりすることができます。 SharePoint のプロジェクト項目の追加、Web サーバーのリセットの構成、および配置用サーバーの種類の設定を行うことができます。詳細については、「方法: パッケージデザイナーを使用してパッケージのフィーチャーおよび項目を追加および削除する」を参照してください。

また、パッケージングエクスプローラーを使用して、パッケージファイル (.wsp) 内のフィーチャーおよび項目を変更することもできます。詳細については、「方法: パッケージングエクスプローラーを使用してパッケージのフィーチャーおよび項目を追加および削除する」を参照してください。

SharePoint ソリューションを配置するためのパッケージ (.wsp) ファイルは、Visual Studio および MSBuild を使用して作成できます。 SharePoint の配置に必要なマニフェストファイルはこのプロセスで生成されます。詳細については、「方法: Visual Studio で SharePoint ソリューションパッケージを作成する」および「方法: MSBuild タスクを使用して SharePoint ソリューションパッケージを作成する」を参照してください。

パッケージデザイナーのオプション

次の表は、パッケージデザイナーを使用してカスタマイズできる、SharePoint パッケージのプロパティの一覧です。

パッケージデザイナーのプロパティ	既定の設定に関する説明
[名前]	必ず指定します。パッケージの既定の名前は <プロジェクト名> に設定されます。
[Web サーバーのリセット]	省略可能。 SharePoint サーバーに .wsp ファイルがインストールされた後に Web サーバーを再起動する場合に選択します。
配置サーバーの種類	必ず指定します。既定では、スコープは ApplicationServer に設定されます。オプション説明 ApplicationServerサービスをホストするサーバーを表します。 WebFrontEndWeb サイトをホストするサーバーを表します。
[ソリューション内の項目]	パッケージに追加できるすべての SharePoint プロジェクト項目およびフィーチャーを表します。
[パッケージ内の項目]	省略可能。パッケージ内の配置対象の SharePoint プロジェクト項目およびフィーチャーを表します。

パッケージ化処理の構成

Visual Studio 2010 で SharePoint ソリューションを開発した後に、プロジェクトをパッケージ化する方法をカスタマイズすることができます。

次の表に、.wsp ファイルの作成方法をカスタマイズするために使用できる 2 つの MSBuild ターゲットを示します。

ターゲット	説明
BeforeLayout	ファイルが中間ディレクトリにコピーされる直前にタスクを実行するターゲット。パッケージファイル (.wsp) を作成する前に、ファイルに変更を加えることができます。
AfterLayout	ファイルが中間ディレクトリにコピーされた直後にタスクを実行するターゲット。

詳細については、「方法: MSBuild ターゲットを使用して SharePoint ソリューションパッケージをカスタマイズする」を参照してください。

パッケージ化のアーキテクチャ

Visual Studio で SharePoint パッケージ (.wsp) を作成すると、次のステップが実行されます。

パッケージの物理構造と意味構造が正しいことを確認するために、フィーチャーおよびパッケージが検証されます。
パッケージ内のフィーチャー、プロジェクト項目、およびパッケージファイルが列挙されます。パッケージおよびフィーチャーのマニフェストファイルが変換されて、配置およびアクティブ化に必要な情報がすべて追加されます。トークンは完全修飾値に置き換えられます。
カスタマイズ可能な BeforeLayout MSBuild ターゲットが実行されます。このステップを設けることによって、.wsp ファイルの作成前に、パッケージに独自の変更を適用することができます。
列挙されたファイルが中間ディレクトリにコピーされます。
カスタマイズ可能な AfterLayout MSBuild ターゲットが実行されます。このステップを設けることによって、.wsp ファイルの作成前に、パッケージに独自の変更を適用することができます。
中間ディレクトリのファイルが .wsp ファイルに追加されます。

パッケージフォルダーの構造

SharePoint プロジェクトをパッケージ化すると、SolutionFolder\bin\<ビルド構成> フォルダーに .wsp ファイルが自動的に作成されます。たとえば、ソリューションの格納場所が <ドライブ>:\Visual Studio 2010\Projects\ListDefinition1 で、ビルド構成が [リリース] に設定されている場合、.wsp ファイルは <ドライブ>:\Visual Studio 2010\Projects\ListDefinition1\bin\Release に格納されます。