Create a package to deploy an Office Add-In developed in Visual Studio

ImportantThe following article uses options that are available starting with the Professional edition and project type.

This tutorial will guide you step by step in creating a package for your VSTO Office Add-In using our Office Product Addin wizard.

1. Start the Office Product Addin wizard

The first step is to launch the Office Product Addin wizard. After launching Advanced Installer, you will be presented with a dialog where you can choose the type of the project you want to create:

Office Add-In

Click on Add-Ins option from Project Type section, choose Office Add-In and press the Create Project button.

2. Enter details about your product

This first dialog of the wizard contains two fields that must be filled. The first one is the product name and the other the Organization name:

Office Add-In Details

After filling these fields, click on the Next button to continue.

3. Select a distribution type

In this dialog select a distribution type for your installation package:

Office Add-In

Choose one type of package type from the available options:

  • MSI setup file. A single MSI setup which contains all installation files.
  • EXE setup file. A single EXE setup which contains all installation files.
  • CD/DVD. The installation package is split into multiple volumes.
  • Active Directory(GPO) deployment. A silent MSI with all installation files next to it.
  • MSIX/APPC package. A modern Windows 10 package together with your standard MSI/EXE.
  • Web installer. The installation files will be placed on a server and your users will receive a small EXE file. During install, only the required files are downloaded.

After selecting one of the above options, click on the Next button to continue.

4. Set project and package paths

In this dialog you can set the paths of your project and the output folder:

Office Add-In Paths

  • In "Save the project in" field you can pick the folder that will contain the .AIP project that will be generated by this wizard.
  • In the "Project output folder" field you can pick the folder where the installation package will be placed.

After picking the above two paths, click on the Next button to continue.

5. Select the type of Add-In you want to deploy

In this dialog you can choose the Office Add-In type:

Office Add-In Type

The available options are:

  • Deploy a VSTO Office Add-In - this type of Add-ins are developed using Visual Studio Tools for Office
  • Deploy a Native Office Add-In - use this option for native Office Add-ins : Excel Addins - *.xla and *.xlam files, Word Addins - *.dot files, PowerPoint Addins - *.ppa files, Access Addins - *.mds files, Access MDE Databases - *.mde files

Let's assume you want to deploy a VSTO Add-In. Select this option and click on the Next button to continue.

6. Select the location of the Add-in resource files

You have the option to either import the files from a Visual Studio Project or to Add the files from a location on disk

To import a Visual Studio solution pick the .sln file from disk from "Import the files from a Visual Studio Project" field and click on the Next button to continue:

Office Add-In resources

7. Choose what project or solution configuration you want to import

Select the project configuration you want to import, for example Debug or Release.

You also have the option to build the selected configuration before proceeding.

Office Add-In Configuration

Them click on the Next button to continue.

8. Select the resource files that will be added to the project

In this dialog a list of the detected resource files will be displayed. Choose the one that you want to include in your package and click on the Next button to continue:

Office Add-In Files

9. Choose the targeted office version and product

The available options are:

  • Select the version of the Visual Studio Tools for office to create the AddIn
  • Select the targeted Microsoft Office version
  • Select the targeted Microsoft Office Product

Office Add-In Targeted version

Select your desired configuration them click on the Next button to continue.

10. Specify the Add-in Office integration settings

In this dialog you can configure the following items:

  • Description
  • Friendly name
  • Load behavior
  • Manifest
  • CSIDL

You cand also specify if you want to install the Addin for the current user only or for all users.

NoteChoosing to install the AddIn only for the current user will set the "Per user only" installation type in Install Parameters page for the resulted .AIP project. Similary, choosing to install the AddIn for all users will set "Per machine only" installation type in Install Parameters page.

Office Add-In Integration

After configuring the above items, click on the Next button to continue.

11. Grant code trust to the add-in assemblies

In this dialog you can select which assembly files you want to grant trust:

Office Add-In Grant Trust

Then click on the Next button to continue.

12. Configure add-in launch conditions

In this dialog you can specify some launch conditions for your package:

  • Minimum .NET version
  • Whether Microsoft Visual Studio 2005 Tools for the Microsoft Office system second edition should be installed
  • Whether Word 2003 Primary Interop Assembly should be installed

Office Add-In Launch Conditions

Then click on the Next button to continue.

13. Configure add-in prerequisites

In this dialog you can add the following prerequisites to your package:

  • .NET Framework
  • VSTO Runtime
  • Office Primary Interop Assemblies

Office Add-In Prerequisites

Then click on the Next button to continue.

14. Specify the languages in which to localize your package

In this dialog you can choose the languages that you wish to build your package in:

Office Add-In Languages

Then click on the Next button to continue.

15. Specify a License Agreement file

In this dialog you can add a license agreement dialog to your package by picking a .rtf license file:

Office Add-In License Agreement

Then click on the Next button to continue.

16. Build the project

In the last dialog of the wizard you have the option to build the project immediately:

Office Add-In Finish

Then click on the Finish button to end the wizard to open the resulted .AIP project.