Skip to content
wxWidgets - Cross-Platform GUI Library

Building Installers

When you have written your wxWidgets application, you will need some way of getting it to the user along with the supporting files that you may need (DLLs, documentation, images, and so on). For anything except the most informal internal releases, you should provide an installation program to do this in a friendly manner, if appropriate giving options to install only certain modules, and you should also give the user an uninstall facility. It will take you less time than you might think (at least on Windows!) and will give your application a more professional look than if you merely bundled a zip file containing your application files. You can use a commercial product such as InstallShield, but there are several free offerings that will probably be adequate for your needs. Here are some free Windows installers. My personal favourite at present is Inno Setup combined with ScriptMaker. I can still automate the production of parts of the script (see the files in distrib/msw in the wxWidgets distribution) but use ScriptMaker to edit the parts that would be tedious to edit by hand.

Windows Installers

You can use a commercial product such as InstallShield or InstallAnywhere, but there are several free offerings that will probably be adequate for your needs. Here are some free Windows installers:

  • Inno Setup, a free Windows installer with Pascal scripting
  • NSIS Nullsoft (SuperPiMP|Scriptable) Install System, originally written for installing Winamp
  • ScriptMaker, a very useful GUI adjunct to Inno Setup (unfortunately not maintained any more)
  • Install Creator, has a free version

My personal favourite at present is Inno Setup combined with ScriptMaker. I can still automate the production of parts of the script (see the files in distrib/msw in the wxWidgets distribution) but use ScriptMaker to edit the parts that would be tedious to edit by hand.

Note that you should install any DLLs that are needed by your application. You can determine the DLL dependencies of your application using Steve Miller's Dependency Walker.

Linux and Unix Installers

On Linux, the standard installation method is using the native package manager for each distribution. However this is quite an unfriendly installation method in my (Julian's) opinion: it has to be run as root, and it doesn't offer any application-specific options to the user. There's a GUI front-end to RPM, GnoRPM, but I find this also less than intuitive. However, RPM is an important standard; you might like to try using RUST to create them without having to learn about .spec files.

Some people prefer to write a shell script which may still invoke RPM. A good wxWidgets project would be to write a font-end installer builder that would write RPM spec files and/or a friendly shell script. An example shell script to put on the wxWidgets web site would be welcome.

The following is a list of known Linux or generic Unix installers.

The following articles may be of interest to those writing their own Linux application installer.

Mac OS X Installers

Apple recommends that Mac OS X applications are installed simply by copying a folder containing the application files to the hard disk. For more complex installations, you can use OS X's Package Manager. For details, see Installing your application at the Apple developer's web site.

For Classic (OS 9 and below), you can use InstallerMaker from Aladdin or Installer VISE from Mindvision.

Robert Roebling says:

"I put the whole dir into Alladin StuffIt (which you need to buy) and make the wxSomething.sit file into a wxSomething.sit.bin file with Alladin later, since the latter step is required for Netscape users downloading such an archive."

Brian Victor says:

"I'd like to point out that you can also use Alladin's DropStuff, which is shareware, to create .sit archives.

In OSX, it seems to be popular to create disk images of application bundle with directions to just drag the bundle into one's hard drive. Bundles make that really clean and easy. Usually these disk images are compressed with Stuffit or DropStuff.

Also, Apple has its own packaging system for OSX, which helps take care of things like click-through licensing, getting administrator (i.e., root) privileges, and probably dependencies also. Such packages have a .dpkg suffix."

The following is a list of known Mac installers.

Other Issues

Dynamic or Static Linking

It's tempting to compile wxWidgets as a DLL or shared library and then marvel at the tiny size of your application. However, you then have to worry about distributing potentially very large libraries with your application, and on both Unix and Windows there is potential for time-wasting confusion. So if you can, compile your application statically: a good linker (such as VC++'s) will strip out redundant code and produce a reasonably small executable.

On Unix, you can compile wxWidgets with the --disable-shared configure option, so that wxGTK and GTK+ will be linked into the application. Although your executable will be quite big, you will save on the hassles of installing shared libraries on your user's machine.

File Compression

You can 'cheat' and make an executable smaller by using a file compressor, such as the excellent UPX, which works on a variety of platforms. It can shrink your app by 50% or so, but you need to be aware that multiple invocations of the same application will no longer share memory and will therefore be more RAM-hungry. Also debuggers will not recognise the compressed executable format, so your Unix users may be puzzled when trying to figure out the cause of a core dump.