Komodo User Guide

Komodo and the Perl Dev Kit

Komodo provides support for ActiveState's Perl Dev Kit, so that you can build executable programs, ActiveX controls and Windows services in Perl.

Note: PDK support is only available on Komodo for Windows.

After creating the desired Perl script in Komodo, select Tools|Build Standalone Perl Application to configure the Perl application. As you configure options on the tabs (described below), the corresponding command-line string is displayed at the bottom of the dialog.

For complete instructions on building executables, controls and services in Perl, see the User Guide that accompanies the Perl Dev Kit.

Configuring the General Tab

The build options for the Perl Dev Kit correspond with the command line switches described in the Perl Dev Kit documentation. For detailed instructions on configuring Perl executables, services and controls, see the Perl Dev Kit User Guide.

  • Enter the name of the script to build using the PDK enter the path and file name of the source Perl script.
  • Build the script using select the type of output you wish to generate. PerlApp will build an executable program, PerlCtrl will build an ActiveX control, and PerlSvc will build a Windows service.
  • Enter the name of the target executable or control enter the path and name of the output file.
  • Dependencies
    • None select this option to include all necessary files in the output file, so that it can be run on systems that do not have Perl56.dll or ActivePerl. This option is equivalent to the -freestanding command-line argument for PerlApp, PerlSvc and PerlCtrl.
    • Perl Dll required on target select this option to reduce the size of the generated executable by excluding Perl56.dll from the output file. Target systems must have the Perl56.dll installed. This setting corresponds to the -xclude command-line argument for PerlApp, PerlSvc and PerlCtrl.
    • ActivePerl required on target select this option to create an output file that will be run on systems where ActivePerl and any modules included via use and require statements are installed. This option is equivalent to not specifying the -freestanding command-line argument for PerlApp, PerlSvc and PerlCtrl.
  • Verbose build information this option will generate verbose output messages while the output file is being built. This option corresponds to the -verbose command-line argument for PerlApp, PerlSvc and PerlCtrl.
  • Hide console (for GUI applications) similar to running wperl.exe, this option is useful for building applications that run in the background. This setting corresponds to the PerlApp -gui command-line argument, and does not apply to Perl services or controls.
  • Build DCOM Registration Binary a registration binary is an .exe file which makes registry entries for the COM interface on a client machine which will be requesting DCOM services from a DCOM server.
  • Report failed 'uses' at runtime this switch is used to report modules that fail to load during the build.
  • Delete temp files after each run free-standing Perl applications, services and controls sometimes contain embedded DLLs that are extracted and cached in the host system's temporary directory. Check this box to delete these files after each run. This setting corresponds to the -clean command-line argument.
  • Debugging to debug the Perl executable, control or service as it is being built, select the desired debugger from the drop down list.
Top

Configuring the Modules Tab

The Modules tab is used to add external modules to the output file. This corresponds to the -add command line argument used by PerlApp, PerlCtrl and PerlSvc.

Adding a Module

To add a module to the output program, enter the name of the module in the Module name field and click Add.

Removing a Module

To remove a module that has been previously added, click the module name in the Modules field and click Delete.

Top

Configuring the Files Tab

The Files tab is used to add additional files to the output file that will be extracted when the program is run, typically data files used by the embedded program. This corresponds to the -bind command-line argument used by PerlApp, PerlCtrl and PerlSvc.

Adding Files

To add a file to the output program, click Add. In the dialog, enter the source location of the file on your system, and the location where the file should be extracted when the output file is run.

Editing Files

To edit a file that has been added to the output program, click Edit. In the dialog, as required, alter the source location of the file on your system, and the location where the file should be extracted when the output file is run.

Deleting Files

To remove a file that was previously configured to be added to the output program, click the file, then click Delete.

Top

Configuring the Version Tab

The Version tab is used to embed version information in the output program. It corresponds to the -info command-line argument used by PerlApp, PerlCtrl and PerlSvc.

To alter any of the version options, select the desired option in the Version fields column and enter the desired value in the field below.

Top