|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Setup Projects for Application-Level Add-ins
When you create an application-level add-in project by using Visual Studio Tools for Office, a Setup project is automatically added to the solution. The Setup project for add-ins generates a Microsoft Windows Installer (.msi) file that configures the target computer and installs the add-in. For more information about Setup projects, see.
Setup Project Overview
By default, when you build the Setup project, Visual Studio creates a Windows Installer file that performs the following steps:
Verifies that the .NET Framework 2.0 is installed on the client computer.
By default, the Setup project does not check for other prerequisites, including the Visual Studio Tools for Office runtime and the primary interop assembly (PIA) for the Microsoft Office application. For more information about the prerequisites, see.
By default, the Setup program will not run if the .NET Framework 2.0 is not installed, even if a later or earlier version of the Framework is installed. The installer will not run because the AllowLaterVersions launch condition property for the .NET Framework in the Setup project is set to false. For more information about launch conditions in Setup projects, seeand .
Creates the required registry keys on the client computer. For more information about these registry keys, see.
Copies the files generated by the build process, including the add-in assembly and the application manifest, to a user-specified directory on the target computer.
The add-in assembly and any referenced assemblies must also be granted full trust in the security policy of each end user. The Setup project does not set the security policy by default. You can add a step to the Setup project to configure the security policy, or the appropriate security policy can be set by an administrator. For more information, see.
For articles that describe how to modify the Setup project to set the security policy and install prerequisites, see "Deploying Visual Studio 2005 Tools for Office Solutions Using Windows Installer (Part 1 of 2)" (http://go.microsoft.com/fwlink/?linkid=57779) and "Deploying Visual Studio 2005 Tools for Office Solutions Using Windows Installer: Walkthroughs (Part 2 of 2)" (http://go.microsoft.com/fwlink/?linkid=57780).