Standalone Automation Interface
InstallShield 12
PROJECT
The Standalone Build is available to users of InstallShield Premier Edition.
The Standalone Build includes a standalone version of the automation interface—the InstallShield Standalone Automation Interface. This interface is similar to the ISWiAutomation12.dll file installed with InstallShield. However, the library name is different and the GUIDs are different.
Future service packs of the Standalone Build will have new prog IDs and new GUIDs. You will be able register multiple versions of the Standalone Build Automation side by side on the same build machine.
Registering SAAuto.dll
The Standalone Automation Interface is contained in the file SAAuto.dll. If you installed InstallShield Standalone Build.msi, then this file is already self-registered. If you used xcopy to install the Standalone Build, you need to register this file manually using Regsvr32.exe.
Using Existing Automation Scripts
Existing automation scripts that work with ISWiAutomation12.dll should work with SAAuto.dll with only minimal changes:
- You need to change the library name from IswiAuto12 to SAAuto12.
- If you are using C++, you also need to import the library to obtain the new GUIDs.
Additional Properties
The SAAuto12.ISWiProject object supports a few more properties than ISWiAutomation12.ISWiProject. These properties are useful if you use the ISWiRelease.Build method. These properties enable you to control the build in ways normally controlled by the InstallShield interface (through the Options dialog box).
NOTE
Setting one of these properties for one instance of SAAuto12.ISWiProject sets the same property for all other (and subsequent) instances of SAAuto12.ISWiProject until the .dll file is released.
Additional Properties for the SAAuto12.ISWiProject Object
|
Name
|
Type
|
Description
|
|
DotNetFrameworkPath
|
Read-write property
|
Specifies the path to the Microsoft .NET Framework. This parameter is optional.
|
|
MergeModuleSearchPath
|
Read-write property
|
Specifies one or more comma-delimited folders that contain the merge module (.msm) files referenced by your project. The default is the folder that contains the Standalone Build, which, by default, does not contain any merge modules.
If you plan to use the ISWiRelease.Build method, you should set this property.
|
|
MinimumTargetDotNetVersion
|
Read-write property
|
Specifies the minimum version of the .NET Framework that the installation will accept on the target system. This parameter is optional and defaults to the latest version of the .NET Framework supported by the InstallShield interface.
|
|
MinimumTargetMSIVersion
|
Read-write property
|
Specifies the minimum version of Windows Installer that the installation will accept on the target system. This parameter is optional and defaults to the latest version of Windows Installer supported by the InstallShield interface.
|
|
SelfRegistrationMethod
|
Read-write property
|
Allows you to control the self-registration setting for the standalone automation. It will set and get ESelfRegistrationMethod = esrISSelfReg, or esrSelfReg.
|
|
SkipUpgradeValidators
|
Read-write property
|
Allows you to turn off the upgrade validators that normally run at the end of the build.
|
See Also
Automation Interface
Automating Build Processes
