Click here to Skip to main content
16,019,768 members
Articles / Desktop Programming / MFC
Article

Easy Installer

Rate me:
Please Sign up or sign in to vote.
4.81/5 (57 votes)
14 Sep 2006CPOL11 min read 289.2K   3.7K   155   122
The Easy Installer program

For those who want a ridiculously simple installer, here's the original EasyInstaller version 1.

Create Installer screenshot

Target Installer screenshot

Latest updates

Version 2.4 - Added Vista as one of the Windows version options, and fixed a few bugs.

Version 2

This release has the following enhancements:

  • Improved user interface - The target installer is now Wizard style.
  • License page - The user can specify an optional license page to be displayed in the installer. The one displayed in the installer for the executable is a somewhat shameless copy-job and adaptation of the Info-Zip license found in the zip.cpp file.
  • Information page - The user can have an optional information page displayed in the installer which can be used to inform the user of new features or special details.
  • Check if project EXEs are running - The installer now checks if any of the EXEs in the project are running before continuing with the installation.

Still to be done (not necessarily by me :-)

  • Progress and completion pages - It would be nice to have a progress page after the user clicks "Finish" so that there is some idea of what's happening. Then an "Install successfully completed" gives the user that warm fuzzy feeling that he did something right.
  • Tabbed(?) interface for the CreateInstaller - The user interface for the CreateInstaller program is a bit crowded. However, since I personally prefer seeing all the details in one shot instead of having to page through the different tabs, I left it the way it is. This also saves me the effort of making changes to the program. If one more install item is added in the future, the user interface will probably require some sort of makeover.
  • Relative pathnames for files - This would allow the files to be installed in different locations. I'm not exactly sure what the best way (user interface) to do this is. Once that's figured out, the code will follow. No matter, I'm frankly just too lazy to think about it right now.

Introduction

I needed a simple install program for a Shareware/Fairware program of mine, but I just couldn't find anything suitable for my needs. I wanted a reasonably automatic creation of an installation executable, but I didn't want to spend hours learning scripts or complicated setups. After a protracted search, I found a couple of nice programs that created SFX files (self extracting executables), but I either had trouble compiling them, or they just didn't behave the way that I wanted.

After a while, I found the ExeCreator Utility, a nice little SFX builder written by Kaushal Malhotra. It too didn't really give me what I wanted. It wasn't enough for me to just be able to pack up my files into an SFX. However, it gave me a direction and a good start. I then decided it was time to get down on my hands and knees and start playing with Lego (tm). ExeCreator would function as that large green piece of Lego that serves as the base. The rest of the pieces are as follows (new stuff in bold):

  • Compression - The resulting install file was too big, so I needed a compression utility. Lucian Wischik's Zip Utils was just what I was looking for. Lucian's Utils are an easy-to-use repackaged form of the Info-Zip source code available here. In a matter of minutes, I had a compressed SFX. For version 2, I needed to apply the fixes as described in this forum thread. This is because I decided to zip all of the files together into one big ZIP instead of each file being zipped separately as in the first version.
  • Shortcuts - Most installers let the user create Desktop, Start menu, and Startup shortcuts. I found some code to do this that I had been playing around with some time ago that I believe was based on the works by PJ Naughter and Igor Vigdorchik.
  • Website link - To include a website link in the installer program, I used XHyperLink by Hans Dietrich.
  • Project configuration - I wanted the option of defining and saving install projects. I added some code for saving the project settings in an INI file. This file sits in the same directory as the CreateInstaller program, and can be easily moved to other machines if needed. I don't like using the registry - it's sort of a religious thing with me.
  • Windows versions - Since my Fairware program only runs on Windows 2K and XP, I figured I should add a way for the user to specify which versions of Windows the installation should work for. For this, I used the GetWinVer function by Hans Dietrich in his FontFile demo.
  • Install path creation - The Windows function _access() checks to see if the install directory path already exists. If the directory doesn't exist, MakeSurePathExists() by Arlen Albert creates each directory of the path until arriving at the final destination directory. MakeSurePathExists() is now being used since Microsoft's MakeSureDirectoryPathExists() is not available on Win 95/98/NT.
  • Register DLLs - The DLL is first checked to see if it can be registered. If so, WinExec() calls "regsvr32.exe". According to the MSDN, WinExec() only exists for compatibility with 16 bit Windows, and CreateProcess() should be used instead. I read the material on CreateProcess three times, and I still don't understand it. I'm either lazy or stupid (maybe both), but I don't care. WinExec() works just fine, so for me, it's a great choice.
  • Detect if the project EXEs are currently executing - The installer now checks if any of the EXEs in the project are running. If so, it prompts the user to close all of the programs before continuing with the installation. For the life of me, I can't remember where I found the code for this. If anyone knows, please let me know and I'll include the appropriate acknowledgment here.
  • Wizard installer - I figured that the best way to improve the appearance of the installer was to turn it into a Wizard. I found a nice Wizard project by Robert Pittenger on CodeProject which fits the bill.

After all this, Kaushal's code is no longer recognizable. For that matter, it's damn near impossible to find. But nonetheless, it still serves as a sturdy Lego base for Easy Installer, and it's what gave me the start.

Philosophy

I wanted an easy-to-use installer and I'm pretty happy with the results. No scripts and no complex tasks means no learning curve.

EasyInstaller is not meant to be a vote getter, and it will certainly never rival InstallShield. It's just a little something I cobbled together for my own use. I'm pretty happy with the results, and I'm using it to distribute my Fairware program. To be honest, the version that I am using (or at least was using) was a lot less polished than the version that I'm submitting. It didn't seem right to submit a mess and expect others to be able to benefit.

If you find it useful, that's great. If you think it's missing something, then let me know and I'll see what I can do. If what you think it's missing is scripting, then forget it. I can almost promise that EasyInstaller will never have scripting.

Using the installer

Projects can be named and defined. Defining a project is very simple. After giving it a name, you add the files that you would like to be packaged into the installer, check the Windows versions, and assign it an output name. You can optionally provide a website link. Fill in the caption and URL fields. If only a URL is provided (with no caption), then the URL will be displayed as-is in the installer. If a URL is not provided, then no link will appear in the installer. When you click "Create", it creates the executable that will serve as the installer. The current settings are also saved in an .ini file found in the same directory as the CreateInstaller executable. Click "Save project" to save the changes without creating an installer.

Projects can be modified or copied. Select a project from the list and modify the settings. If you give it a new name, you've created a new project. If you no longer need a project, select that project from the list and click "Delete project".

New in ver 2 - When creating an installer, you can now optionally point to a license agreement file and an information file. These will be displayed on their own pages in the target installer Wizard.

New in ver 2 - The install that's created checks to see if an executable with the name of the current project (e.g.: CurrentProject.exe) is currently running. If so, it informs the user that the program must be terminated before continuing with the installation.

The installer allows the user to ask for a Desktop shortcut as well as a Startup shortcut. The only requirement is that the .exe file to have shortcuts must have the same name as the project. As an example, if you have a project named SuperApp, it will create Desktop and Startup shortcuts to SuperApp.exe. I hope to make this feature a little more flexible in a future version.

If the user selects Start menu links to be created, then the installer will create a link for all executables in a Start menu directory that has the name as the project.

My code

OK, before you get frustrated, let me explain one point. When you compile the project in debug, you will get an error that Installer.exe is missing. You can either change the path in the resource file to point to the debug version of Installer.exe, or build in Release first. This will create the file and you won't get the error message. I'm sure that there's a better way to do this, but I'm not aware of it. If you know how to do this, let me know and I'll fix up the project.

Nothing fancy really - in fact, pretty much quick and dirty. The project started out as a Lego project, and I just kept massaging it (with dirty hands) till I got the results that I was looking for.

I was not too consistent (well, actually pretty sloppy) concerning Unicode-friendly code. I'll try to clean this up in the next iteration. (Yeah, you're right - I didn't even attempt to clean this up for version 2. Sorry.)

Development was done under VS7. I don't really plan on porting this to VS6 since I just don't have the time. I don't see any reason why it shouldn't work under VS6. I'd be glad to incorporate the changes if anyone wants to do the port.

MFC is statically linked. The first time that I used it, someone complained about "a missing DLL". Now, why didn't I see that coming? Anyhow, statically linking MFC makes the final installer slightly larger, but avoids hassles and headaches. If you can live with dynamically linked, then go ahead.

History

No betas, pre-releases, or release candidates. Just an occasional release as the need or mood arises. I don't have time for version control or complicated test procedures. In fact, I barely have enough time for personal hygiene.

  • Version 2.4 - (13 September 2006) - Added Vista as one of the Windows version options. Fixed a bug in the license and info routines where the allocated memory block was one byte short to not allow for the delimiter. Fixed a bug with creating an installer that already exists. I think there are a couple other bug fixes but I can't remember what (I don't keep very good records).
  • Version 2.3 - (never released - too lazy).
  • Version 2.2 - (20 February 2005) - Bummer, another month, another update :-) Seems like Easy Installer has taken on a life of its own. I was again able to find a pre-existing piece of "Lego" (by Arlen Albert) to help me out. His routine MakeSurePathExists() is a replacement for the routine MakeSureDirectoryPathExists() which only exists in Win2K/XP. Thanks to Testeer and Jean-Luc for pointing out this problem. Easy Installer should now work under Win9x/NT.
  • Version 2.1 - (20 January 2005) - License and info files weren't properly added to the installer. This feature now saves the files in the target directory during installation.
  • Version 2.0 - (22 December 2004) - Target installer is now a Wizard; license and info pages were added.
  • Version 1.0 - (15 November 2004) - Initial release.

This time I got some respite before creating a new version - mostly since I never had time to read the comments on CP so I never get around to making any changes. I finally needed to make some changes, and a new version is the result. Suggestions are welcome, but will just end up as a lost Post-It note somewhere in the clutter on my desk. Take care.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Israel Israel
lichen farmer, semi-lingual, never saw a Sylvester Stallone movie

Comments and Discussions

 
QuestionLicense? Pin
User 138647513-Jan-14 6:56
User 138647513-Jan-14 6:56 
AnswerRe: License? Pin
Abu Mami14-Jan-14 1:37
Abu Mami14-Jan-14 1:37 
NewsCannot add more than 6 files at a time, very annoying. Pin
mensfort23-May-09 8:03
mensfort23-May-09 8:03 
GeneralCompressing is not working for AIR installer.exe Pin
VishalIndia11-May-09 22:10
VishalIndia11-May-09 22:10 
GeneralRe: Compressing is not working for AIR installer.exe Pin
Abu Mami11-May-09 23:05
Abu Mami11-May-09 23:05 
GeneralRe: Compressing is not working for AIR installer.exe Pin
VishalIndia12-May-09 5:31
VishalIndia12-May-09 5:31 
GeneralRe: Compressing is not working for AIR installer.exe Pin
VishalIndia14-May-09 0:50
VishalIndia14-May-09 0:50 
GeneralRe: Compressing is not working for AIR installer.exe Pin
Abu Mami23-May-09 8:18
Abu Mami23-May-09 8:18 
GeneralRe: Compressing is not working for AIR installer.exe Pin
VishalIndia15-May-09 2:59
VishalIndia15-May-09 2:59 
AnswerRe: Compressing is not working for AIR installer.exe Pin
mensfort23-May-09 7:59
mensfort23-May-09 7:59 
GeneralRe: Compressing is not working for AIR installer.exe Pin
Abu Mami23-May-09 8:15
Abu Mami23-May-09 8:15 
AnswerRe: Compressing is not working for AIR installer.exe Pin
mensfort26-May-09 1:53
mensfort26-May-09 1:53 
GeneralRe: Compressing is not working for AIR installer.exe Pin
mensfort25-May-09 21:07
mensfort25-May-09 21:07 
GeneralRe: Compressing is not working for AIR installer.exe Pin
Abu Mami25-May-09 22:18
Abu Mami25-May-09 22:18 
GeneralRe: Compressing is not working for AIR installer.exe Pin
VishalIndia31-May-09 1:41
VishalIndia31-May-09 1:41 
GeneralRe: Compressing is not working for AIR installer.exe Pin
Abu Mami31-May-09 1:53
Abu Mami31-May-09 1:53 
GeneralMy vote of 1 Pin
Mohammad Dayyan24-Jan-09 16:18
Mohammad Dayyan24-Jan-09 16:18 
Generalun-install Pin
Member 40339369-Dec-08 23:59
Member 40339369-Dec-08 23:59 
GeneralRe: un-install Pin
Abu Mami10-Dec-08 6:40
Abu Mami10-Dec-08 6:40 
GeneralRe: un-install Pin
Member 403393610-Dec-08 14:18
Member 403393610-Dec-08 14:18 
QuestionProblem?? Pin
LloydA11110-Oct-08 12:51
LloydA11110-Oct-08 12:51 
AnswerRe: Problem?? Pin
Abu Mami11-Oct-08 7:04
Abu Mami11-Oct-08 7:04 
QuestionNot very compatible with Vista? Pin
The Cake of Deceit23-Jun-08 10:54
The Cake of Deceit23-Jun-08 10:54 
AnswerRe: Not very compatible with Vista? Pin
MadMan-2972922-Sep-08 8:57
MadMan-2972922-Sep-08 8:57 
RantRe: Not very compatible with Vista? Pin
The Cake of Deceit5-Oct-08 12:46
The Cake of Deceit5-Oct-08 12:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.