Deploying the *.Utilities assemblies by using Windows Installer (Mary Lee)

  • Comments 2

Office solutions for .NET Framework 4 have dependencies on files that are distributed in the Visual Studio 2010 Tools for Office runtime, but there are also files outside of the runtime that are required for Office solutions to run on end-user computers.

These files are the following:

  • Microsoft.Office.Tools.Common.v4.0.Utilities.dll
  • Microsoft.Office.Tools.Excel.v4.0.Utilities.dll
  • Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll
  • Microsoft.Office.Tools.Word.v4.0.Utilities.dll

For some information about these Utilities assemblies, see Assemblies in the Visual Studio Tools for Office Runtime.  For even more information, see Design of VSTO 2010 runtime.

 

Once you add a Setup project to your Visual Studio solution and add the project output of the Office solution, the next step is usually to exclude all the detected dependencies.  However, you may find that your Office solution does not run on end-user computers. This is because the *.Utilities assemblies must be deployed to the end-user computer or the functionality provided by the interfaces defined in these assemblies must be re-implemented in your own assembly.

To workaround this problem, make sure to not exclude the Utilities assemblies after the file is detected as a dependency.

clip_image002[6]

All the other files are part of the Visual Studio 2010 Tools for Office runtime, so you do not need to deploy them with your Setup project.

Check out the deployment FAQ at http://social.msdn.microsoft.com/Forums/en-US/vsto/thread/1666d2b0-a4d0-41e8-ad86-5eab3542de1e.  If you have additional questions about deployment, search for or post questions in the forum at http://social.msdn.microsoft.com/Forums/en-US/vsto/threads.

 

Mary Lee, Programming Writer.

Leave a Comment
  • Please add 1 and 8 and type the answer here:
  • Post
  • I read many times ( including here ) that Microsoft.Office.Tools.Common.v4.0.Utilities.dll  is not part of the VSTO Runtime.  I'm confused by these statements because when I install it ( x64 ) I see the assembly listed in the C:\Program Files\Reference Assemblies\Microsoft\VSTO40\v4.0 Framework directory.

    The reason I ask is that I have an Office 2007 AddIn ( therefore x86 hosted )  that won't load unless I copy the file from the forementioned directory to the application bin directory.   While I can do this ( effectively CopyLocal=true )  I'm just confused since I see the x64 redist installing the file.  It installs many other files which I am able to properly resolve.

    Can you help me 'get it'?  Thanks!

  • I must have been looking at the wrong MSI in Orca. It's true, this DLL isn't in the VSTOR package.  It's in the VS and VS 2010 Office Developer Tools msi's.

    Why this is however is beyond me.  Deploy it myself I will.....

Page 1 of 1 (2 items)

Deploying the *.Utilities assemblies by using Windows Installer (Mary Lee)