How to: Customize a SharePoint Solution Package by Using MSBuild Targets

By using MSBuild targets at a command prompt, you can customize how Visual Studio creates SharePoint package files (.wsp). For example, you can customize the MSBuild properties to change the packaging intermediate directory and the MSBuild item groups that specify the enumerated files.

Customizing and Running MSBuild Targets

If you customize the BeforeLayout and AfterLayout targets, you can perform tasks before package layout, such as adding, removing, or modifying files that will be packaged.

To customize the BeforeLayout target

1. Open an editor, such as Notepad, and then add the following code.

   <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     <Target Name="BeforeLayout">
       <Message Importance="high" Text="In the BeforeLayout Target"></Message>
     </Target>
   </Project>
   

   This example displays a message before the packaging of this target.

2. Name the file CustomLayout.SharePoint.targets, and then save it in the folder for the SharePoint project.

3. Open the project, open its shortcut menu, and then choose Unload Project.

4. In Solution Explorer, open the shortcut menu for the project, and then choose EditProjectName**.vbproj** or EditProjectName**.csproj**.

5. After the Import line near the end of the project file, add the following line.

   <Import Project="CustomLayout.SharePoint.targets" />
   

6. Save and close the project file.

7. In Solution Explorer, open the shortcut menu for the project, and then choose Reload Project.

When you publish the project, the message will appear in the output before packaging begins.

To customize the AfterLayout target

1. On the menu bar, choose File, Open, File.

2. In the Open File dialog box, navigate to the project folder, choose the CustomLayout.target file, and then choose the Open button.

3. Just before the </Project> tag, add the following code:

     <Target Name="AfterLayout">
       <Message Importance="high" Text="In the AfterLayout Target"></Message>
     </Target>
   

   This example displays a message after this target is packaged.

4. Save and close the targets file.

5. Restart Visual Studio, and then open the project.

When you publish the project, the BeforeLayout message appears before packaging starts, and the AfterLayout message appears after packaging finishes.

See Also

Other Resources

Packaging and Deploying SharePoint Solutions