Add-in Express™
for Internet Explorer® and Microsoft® .netAdd-in Express Home > Add-in Express for Internet Explorer > Online Guide > IE add-on deployment
Deploying Internet Explorer add-on
 To make your IE6, IE7 and IE8 solution deployment as fast and easy as it could possibly be, all Add-in Express-based Internet Explorer solutions include setup projects with all necessary prerequisites and advanced actions that you can use to customize the installation process. You create conventional .MSI installers using the Add-in Express Setup Project Wizard that generates localized setup projects (see also Creating a setup project manually. In addition, Add-in Express supports a simple technology of Web-based deployment and update of IE extensions.
Setup Project wizard
You start the setup project wizard via the context menu of your add-on project. The wizard allows specifying all sorts of description strings as well as the location and localization of the setup project.
Clicking on Finish adds the following setup project to the solution.
Let's walk through the files.
AddinExpress.IE.dll is the Add-in Express assembly.
The loader files (adxloader.dll, adxloader64.dll and adxloader.dll.manifest) are taken from the Loader folder of your add-on project.
adxregistrator.exe is a custom action executable that registers and unregisters the add-on.
Interop.SHDocVw.dll and Microsoft.mshtml.dll are interop assemblies.
Note that ieframe.dll and AddinExpress.IE.tlb are excluded.
Setup projects
The project wizard creates a setup project automatically.
Creating a setup project manually
We don't recommend that you create setup project manually because you can always create them with the Add-in Express Project Wizard when starting a new project. Nevertheless, if you need to create a setup project manually, use the following step-by-step instructions.
Add a new setup project
Right-click the solution item in the Solution Explorer window and choose Add | New Project.
In the Add New Project dialog, select the Setup Project item and click OK. This adds a new setup project to your solution.
File System editor
Right-click the newly added setup project item and choose View | File System.
Primary output
Right-click the Application Folder item and choose Add | Project Output
In the Add Project Output Group dialog, select the Primary output and Localized resources items of your add-on project and click OK.
This adds the following entries to the Application Folder of your setup project.
Select AddinExpress.IE.tlb and, in the Properties window, set the Exclude property to True. Also, exclude the ieframe.dll file in the same way.
Note. Always exclude all TLB and OLB files from the setup project except for TLBs that you create yourself.
Project-dependent resources
Now you add all resources (e.g. assemblies, DLLs or any resources) required for your project.
Add-in Express Loader and its manifest
Add the adxloader.dll, adxloader64.dll and adxloader.dll.manifest files from the Loader subfolder of the add-in project directory to the Application Folder of the setup project.
MSHTML interop assembly
Add Microsoft.mshtml.dll from the Interop Assemblies folder of the Add-in Express install folder to the Application Folder in the setup project.
Custom actions
Add the adxregistrator.exe file from the Redistributables folder of the Add-in Express install folder to Application Folder of the setup project.
Open the Custom actions editor and add a new action to the Install, Rollback, Uninstall sections. Choose adxregistrator.exe as an item for the custom actions.
Add the following values to the Arguments properties of the following custom actions:
• Install
/install="MyIEAddon1.dll" /privileges=admin
• Rollback
/uninstall="MyIEAddon1.dll" /privileges=admin
• Uninstall
/uninstall="MyIEAddon1.dll" /privileges=admin
Please replace "MyIEAddon1.dll" with the file name of your add-on.
Dependencies
Right click on the Detected Dependencies section of the setup project and choose Refresh Dependencies. Also, exclude all dependencies that are not required for your setup.
PostBuildEvent
Set this property of the setup project as follows:
{Add-in Express folder}\Bin\adxpatch.exe" "$(BuiltOuputPath)" /UAC=On
Prerequisites
Right click on the setup project and open the Properties dialog.
Click on the Prerequisites button and, in the Prerequisites dialog, check all the prerequisites you need.
You can choose the ‘Download prerequisites from the same location as my application’ option to distribute all prerequisites with the add-in installation package.
IE Bar only
IE Bar is the only IE extension type installable by a standard user. For your IE bar to be installed by a standard user, you need to change the setup project as follows:
PostBuildEvent
{Add-in Express folder}\Bin\adxpatch.exe" "$(BuiltOuputPath)" /UAC=Off
DefaultLocation
Right-click the setup project item in the Solution Explorer window, choose View | File System in the context menu, click Application Folder and set the DefaultLocation property as follows:
[AppDataFolder][Manufacturer]\[ProductName]
Custom actions
• Install
/install="MyIEBar1.dll" /privileges=user
• Rollback
/uninstall="MyIEBar1.dll" /privileges=user
• Uninstall
/uninstall="MyIEBar1.dll" /privileges=user
Please replace the "MyIEBar1.dll" strings above with the file name of your IE bar.
Deploy
Rebuild the setup project. Copy all setup files to the target PC and run the msi file to install the add-in. However, to install Prerequisites, you will need to run setup.exe.
Back to Add-in Express for Internet Explorer homepage |