To deploy the wrapper libraries to a user’s machine you need to deploy the following files:

  1. The XLL add-in (.xll) and its compiled help file (.chm).
  2. The wrapper assembly (.dll).
  3. The wrapper assembly’s type library (.tlb).
  4. XLL+ Wrapper runtime files: XllPlus.ComWrapper.Runtime.dll and XllPlus.ComWrapper.Runtime.tlb.

XLL Add-in

The compiled help file (.chm) should always be delivered to the same directory as the XLL file.

It is often convenient to deploy the XLL to the same directory as the wrapper assembly. Then you can use simple code to find it when it needs to be loaded, e.g.:

CopyC#
string theXllFileName = Path.Combine(
    Path.GetDirectoryName(typeof(ApiTest).Assembly.Location),
    "ApiTest.xll");

Wrapper assemblies

If you are calling the wrapper assembly from a COM client, you should usually distribute the type library file (.tlb) alongside the assembly (.dll) file.

If you are calling the wrapper assembly from a COM client, you must register the assembly as a COM module using regasm. Depending on your security policies, you may also need to sign the wrapper assembly, or add it to the GAC.

Runtime libraries

You must make the runtime library XllPlus.ComWrapper.Runtime.dll available.

If you are calling the wrapper assembly from a COM client, you should usually distribute the runtime type library file XllPlus.ComWrapper.Runtime.tlb alongside the assembly file.

If you are calling the wrapper assembly from a COM client, you must register the runtime assembly as a COM module using regasm.

You may find it convenient to add the runtime assembly to the GAC. If not, you should ensure a copy of the assembly is accessible to the client program (usually by placing it in the same directory as the client application).

Excel

A program that uses the ExcelWrapperEngine engine must run on a computer with Excel 2003 or above installed.

You will also need to enable the user’s version of Excel to use the .NET version 2 run-time libraries. See Loading the correct .NET runtime version for more information.

Finally, the Microsoft Office Primary Interop Assemblies, version 11, must be installed on the user’s machine.

See Also

Other Resources