Developing and Distributing wxPerl Applications on Windows

Introduction

This article is about installing wxPerl under Strawberry Perl for application development and distribution as a Windows executable.

Why Perl GUIs, why Windows?

This is a critical ability for any freelance Perl developer, since it compliments a Perl journeyman's ability to do many things on servers, such as create remote services. Being able to transfer these skills to the desktop environment, particularly one that is full of users who are okay with paying for software (i.e., Windows). In short, Perl programmers who want to make a living on their own need to know how to create and distribute Windows GUI applications; this page covers a large piece of how to do that.

wxPerl GUI running on Windows as a double-clicable EXE file! Created using RAD-ish tool, wxGlade. See more images on Github.

Instructions are provided with the versions detailed below. If there are newer versions of any of the modules, you may try it out (of course); but understand they have not been tried out and shown to work like version combinations below.

Installation

Step 1 - Install Strawberry Perl

Install via following link,

https://github.com/StrawberryPerl/Perl-Dist-Strawberry/releases/download/SP_54001_64bit_UCRT/strawberry-perl-5.40.0.1-64bit.msi

Step 2 - Install Alien::wxWidgets (v 0.70)

Once Perl is installed, look in the Start menu for the Perl "cmd" window or open up PowerShell

• go to "Start menu" > Strawberry Perl > "Perl (command line)"
• click the Start menu item, it'll open up a Windows CMD window (traditional black DOS prompt)

Type the command at the "C:" prompt,

C:\> cpanm --verbose https://github.com/sciurius/wxPerl/releases/download/R3.004/Alien-wxWidgets-0.70.tar.gz

Step 3 - Install Wx (v 3.005)

C:\> cpanm --verbose https://github.com/sciurius/wxPerl/releases/download/R3.005/Wx-3.005.tar.gz

Verify Installation

Install Wx::Demo

Wx::Demo is nice demonstration application, highlight many (if not all) of the wxWidget features available via xPerl.

C:\> cpanm --verbose Wx::Demo

.. then once installed, run it with this command (which is available in the PATH already),

C:\> wxperl_demo.pl

wxGlade - a Perl Friendly(cross-platform) GUI Builder

Install wxGlade

wxGlade is a GUI builder for wxWidgets applications. It is written in Python, but critically supports outputing Perl code. It is actively developed, the developer is very responsive on Github to bugs and feature requests. It is the closest thing we have in Perl to a RAD (rapid application development) environment (e.g., Lazarus for FreePascal).

Step 1 - Install Python 3.12 for Windows

Install via following link,

https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe (linked here)

Notes:

1. Last tested on 25 Jan 2025, although later versions of Python 3 were tested (specifically, 3.12.8), wxPython would install but not run wxGlade properly
2. install as admin (checkbox should be already checked; also opt'd to add "python" to the PATH)

Step 2 - Install wxPython

1. open up the Windows CMD window
2. use pip,

C:\> pip install wxPython

Note: if this fails, you may need to reinstall pip; but it should be available in the CMD window. Based on experience, pip doesn't seem to be available via the Strawberry Perl terminal, so be sure to get a standard Windows CMD window to do this part.

Step 3- Download and unzip wxGlade

https://github.com/wxGlade/wxGlade/archive/refs/tags/v1.1.0.zip (may want to also try wxGlade-1.1.0_win_amd64.zip - the difference between the two is unclear, but both are tested and both work.)

wxGlade running on Windows, showing the design window of a GUI about to be run using wxPerl!

Via Windows CMD terminal, navigate to the unzip'd directory and run the command,

C:\> python wxglade.py

Getting wxGlade Help

wxGlade's developer is responsive on Github and there is a semi-active email list on SourceForge,

• Github repo - https://github.com/wxGlade/wxGlade
• email list - https://sourceforge.net/p/wxglade/mailman/wxglade-general/

Development Workflow Notes

This section outlines some different workflows that are found among members of the community who use wxPerl. Like any workflow, the based on level of experience and particular application.

Using wxGlade's "Single file" + "Keep use code" Options

wxGlade has some settings that tells it to not overwrite changes you made in the output Perl script, but beware - this option is not on by default. That means that means that your file will get overwritten if you tell wxGlade to generated new code again. The general workflow is as follows:

1. start a new project (or open an existing one)
2. click on the root "Application" object in the object viewer
3. find the output pane, set the output to be "Perl"
4. set version of wxWidgets to be "3.0"
5. 

   Recommended settings for using wxGlade for Perl development.
   check "Keep user code", this will make sure wxGlade doesn't over write code that is outside the bounds of very clearly marked blocks in the code

Using wxGlade's "Seperate file for each class" Option

... to do

Creating Windows EXEs

This section is more of a work in progress since a reliable method of distributing single file executables (or developing installation packages for Windows) is still an open question, there is hope that this will end up being a relatively smooth process. Needless to say, it is critical for Perl developer to be able to distribute Perl based GUI applications as single file (.exe) or via installation on Windows. The client should NOT need to be running through any of the instructions above to run a program that you would like to sell them for actual money.

Below are the initial instructions for generating an EXE file. There are also many ways that wxPerl developers go about doing, based on their use case and experience.

PAR::Package and WX::Perl::Packager

Step 1 - Install PAR::Package and Wx::Perl::Packager

C:\> cpanm --verbose PAR::Package Wx::Perl::Packager

Step 2 - Generate the EXE

Assuming you have a Perl script generated either via wxGlade (see above) or one you have created/updated by hand, the command is as follows:

C:\> wxpar YOURPROGRAM.pl -o YOURPROGRAM.exe

Important Notes About wxGlade Generated Code

1. earlier versions of wxGlade introduced an improper idiom at the bottom of the generated Perl script that caused a problem when running via a PAR::Packed packed executable. TLDR; remove the "unless(caller)" block and just run the Wx event loop unfettered. For more information, please read the PAR::FAQ.
2. earlier versions of wxGlade also used a non-Exporter import tage that wxpar could not properly follow; see the code "before" and "after" below:

use Wx qw[:allclasses];
use strict;

...

package main;

unless(caller){
    my $local = Wx::Locale->new("English", "en", "en"); # replace with ??
    $local->AddCatalog("app"); # replace with the appropriate catalog name

    my $app = MyApp->new();
    $app->MainLoop();
}

Should be modified to look like the following:

use Wx qw;
use strict;

...

package main;

my $local = Wx::Locale->new("English", "en", "en"); # replace with ??
$local->AddCatalog("app"); # replace with the appropriate catalog name

my $app = MyApp->new();
$app->MainLoop();

See this Github issue for wxGlade, where both were fixed. At the time of this writing, the changes. have not been put out in an official release; but they are applied in the master branch.

PPL (portable Perl loader)

... to fill in

Creating Installers for Windows EXEs

Professional Windows programs are expected to provide installers. This section will be developed as I figure out how to do this. A few notes:

• Strawberry Perl itself uses WiX Toolset (Windows Installer XML Toolset) to generate its MSI installer (see here)
• NSIS (Nullsoft Scriptable Install System) is another option - (tutorials, examples, screenshots) - it also has its own IDE for visually designing installers! See more here.
• A possible "old school" approach, may be to use Office'97 Office Developer Edition (ODE) - via Access'97 there is an installer builder - this is a last resort and still needs to be verified to work for non-Access distributions
• Inno Setup (github) - Inno Setup is a free installer for Windows programs by Jordan Russell and Martijn Laan. First introduced in 1997, Inno Setup today rivals and even surpasses many commercial installers in feature set and stability.
• InstallShield (commercial - software monetization services)

Underdeveloped Sections

The following sections are "works in progress," and remain open questions (for this author anyway). Contributions to develop these sections are greatly appreciated, but not expected. Over time I will update these sections as I learn more about using wxGlade and Perl on Windows.

Distributing EXEs to other Windows Machines

While wxpar does indeed create EXEs that can run on Windows machines that do not otherwise have any required libraries on them, I have found some early problems that are most likely due to lack of experience in this area. An understanding of this area is forthcoming.

Maintaining Perl Applications using XRC

XRC is a language agnostic and XML based way of describing the GUI layout for wxWidgets. It appears to be the right way to maintain the GUI layout of your production grade program, while maintaining the set of Perl handlers in your own source tree. Think of XRC as the separation of the controller and view in MVC - it to GUI programming what templates are to web application programming. It seems that as one advances his skills in this area, he will want to use XRC. The benefit also of this is that one may be able to create controllers in multiple languages rather than tie the GUI construction in Perl or some other language exclusive - of course, wxGlade can output in different languages, but none is as abstract as XRC.

Wx::Demo example of loading an XRC file; wxGlade can output directly to XRC, which can then be read in Perl. This is how.

Wx::Demo has a few good examples of running XRX applications; wxGlade can output XRC, but it is not aware of any language bindings or drivers for it.

Experience with managing XRC files may allow us as Perl programmers to use RAD tools and GUI builders that were not intended to support wxPerl, but can output XRC files. DialogBlocks is such a professional and commercial GUI builder for wxWidgets, and it is actively maintained.

Frequently Asked Questions

Nobody actually asks contacts me to ask these questions, but they seem to be important.

Q: Can these wxPerl applications using Strawberry Perl make https requests?

A: Yes! Strawberry Perl comes with HTTP::Tiny (a core Perl module) and Net::SSLeay (used by HTTP::Tiny for https requests).

Additional Resources

Printed Books

This great, but out of print wxWidgets book is available for free (PDF) at https://wxwidgets.org/docs/book/. It mentions wxPerl and has an index of tools and programs that any wxWidgets programmer may find interest.

Cross-Platform GUI programming with wxWidgets (free PDF!!) by Julian Smart and Kevin Hock (with Stefan Csomor) is an old, but nice resource to have. It mentions wxPerl quite a bit and has a nice index of tools to help the wxWidgets GUI programmer, regardless of the language they are using. In particular, "Appendix E: Third-Party Tools for wxWidgets" is a very interesting read.

Longer List of RAD Tools and GUI Builders*

• wxGlade (Latest at this time, Version 1.1.0, July 7, 2024)
• wxDesigner (Latest at this time, 2.14 - wxWidgets 2.8.8/ 2.20a - wxidgets pre-3.0, May 2009)
  • outputs Perl code
  • archived but a trial is downloadable [here] (archive.org)
  • Reliable contact for license: undetermined at this time
• DialogBlocks - (Latest at this time, Version 5.18, August 21st, 2024)
  • can export C++, XRC, which wxGlade should be able to import
  • No Perl export (see XRC)
  • Cross Platform (Windows, Mac, Linux)
  • Registration required, but support is discontinued - email support@anthemion.co.uk, they may just give you a free key if you are nice :-)

*You may want to also check this duplicated internal page.