NSB All Systems Installer Creator

ome

Let us go directly to the point. What this program may do for users?
Reading several messages of the NSB Group it is clear that the users of 
this language need an installer's program that is easy to use giving them
as result a package that could install all the files that their programs
need to run in a single step.
INFactoryW_2003 does all the above requiring user to know only:

-Program's name
-Author's name (you)
-Device Operating System
-CPU Type (Only if you do not use ALL option)
-Additional files' path on the device (if any)

The program uses the standard way to work (i.e. Cab files,Ini files) and
add the possibility to create a compressed autorunning exe installer if 
used with EzSetup (under Win2000 and over only).
You must consider INFactoryW_2003 as an installer developing enviroment to
which user must add additional files that usually a programmer can easily
get and that are:

-CABwiz.exe
-EzSetup.exe
(NSBruntime)Basic.exe,MSCEfile.dll,MSCEPicture.dll,DialogX.ocx,regsvrce.exe
(eVBruntime for Mobile2003 only)Pvbform2.dll,Pvbhost2.dll,Pvbload.exe,
                Pvbdecl.dll,Pvbctrl.exe,Pvbkill.exe,Vbscript.dll

NOTE: This files are not included in the zipped distribution file of my  program as 
           well known to registered users of the language or easily available on net.
           into the new MS eVB runtime   -     If you wish to learn how to get them See HERE

When you collected all files you need, you must store them into the folders
that, unzipping program, are authomatically created on your HD.
The folder names recall the OS/CPU to use (example: PocketPC_ARM)
You MUST store into each folder the same files otherwise you will be unable
to create a single MultiCab installer for different CPUs

The folders'tree will be shown as at side.
You do not need to fulfill all the folders
(You may leave PPC and HPC folders empty if
you planned to not use this O.S., but you
must remember, in this case, to not use the
option ALL Devices.)
The users of the previous version will note
a new subfolder named 'Mobile'.
This is the only one that does not need to
contain the same files stored into the others
folders. You will store therein the eVB files
that are required for Mobile2003 system.
When you finished to load the required files 
your are near to have INFactoryW2003 operative.
The above operation must be made the first 
time only but, obviously, you can add all the
Dll, Ocx files you need at any time.
We can now see the use of the main folders:

-INFactory
 You have to copy in this folder the file CABwiz.exe and you will
 find here, after the use, the file .inf created in the form 
 [YourProgramName].inf
-ApplicationFiles
 In this folder you must copy your .nsb program file and all the
 additional files (images,sounds,help,data etc) if any.
-FileResult
 As the name says you will find here the Installer created.
 Into this folder you will find a Setup.exe file and also
 the Ezsetup.exe file must be stored herein.
 If you can use Ezsetup you must store here also two text files
 Eula.txt and User.txt that you will write with the terms you
 like. (you may change the names but the format must be Text)

NOTE: As several time written the so easy use of Microsoft installer is due to its
           integration into the programming system so to get a similar easy use i have
           to ask you to perform, on starting the above mentioned actions.
           If you do not like this you can use other kind of installers but in this case 
           it may be that you will need to give to the program a lot more of informations
           so the learning time to use program could be longer than the one required to
           find and copy some files into the relative folders. 

After reading and executing the above you are ready to run and
use INFactoryW_2003. 

This is the FIRST window of the program when you run it:

The user can see that the starting wind has not been changed except for the
missing checkbox used in the previous provisory version to use Mobile2003.

and two little label which use will be explained later.
Are always available the two TabLabel to select if use the WIZARD mode or
the ADVANCED mode. The First one can be used only with standalone programs
and accept as additional files dll or ocx only. The advanced mode allows 
user instead to add others types of files also (images,sound,helps etc) and
to select the path where to install them on the device.



Before starting select, by a click, the operative mode to apply thence to
use this first window you must only:
Type your ,nsb program's name without extention in the 1st input Textbox 
Type Author's or Company's name into the 2nd input Textbox 
Type a brief program's description (optional) in the 3rd input Textbox
thence you have to
Use 1st CheckBox to Add NSBasic Runtime (select to add all needed files) 
Use 2nd CheckBox to create Program's schortcut (select it if requested)
Now select the Operating System and the CPU's type following these rules 
You may create Single O.S. Installer for a single CPU >    PocketPC4_Arm.Cab
                              (select  1 O.S. for your device thence 1 CPU type only) 
                                                                                            ( PocketPC_Arm.Cab 
                              Multiple CPU installer for single O.S. > ( PocketPC_Mips.Cab
                                                                                            ( PocketPC_SH3.Cab
                              (select 1 O.S.for your device thence the ALL option for CPU)
                                                                                       ( PocketPC4_Arm.Cab
                                                                                       ( PocketPC4_Mips.Cab
                              Selected O.S. for multiple CPUs       ( PocketPC_Arm.Cab
                                                                                       ( PocketPC_Mips.Cab
                                                                                       ( PocketPC_SH3.Cab
                              (select 2 separate O.S thence the ALL option for CPU)
                                                                                              ( PocketPC4_Arm.Cab
                                                                                              ( PocketPC4_Mips.Cab
                              Global multiple O.S. for multiple CPUs   ( PocketPC_Arm.Cab 
                                                                                              ( PocketPC_Mips.Cab
                                                                                              ( PocketPC_SH3.Cab
                                                                                              ( PPC_Mips.Cab
                                                                                              ( PPC_SH3.Cab
                               (select 'ALL devices' O.S. option thence ALL option for CPU) 

  doing this you must remeber

-YOU CANNOT CREATE MIXED PALM SIZE AND HANDLE SIZE DEVICE INSTALLERS 
-The little label on top of the Combo boxes will show how many O.S. 
 and CPUs you are using even if the combo text will show last selection.

Below the ComboBoxes line you find a further ComboBox as here shown:
  You may use it to modify the Device Install 
Directory that is by default - \Program Files -. 
It is anyway strongly suggested to add to the default dir a SubDir
using your program name (for example \Program Files\MyProgram). 
Doing this any program of yours will be installed into a SubDir so
named under the Folder Program Files.

AT this point the beaviour of INFactory will be different if you
selected WIZARD or ADVANCED

How to go over if WIZARD option has been selected:

You will see at side of the ComboBox
showing Device Default Directory a
Button captioned ADD that open below
a list showing all the available Dlls.
You may click on their name to add the
libraries to your installer.
Note that the dlls marked by a '*' have
beem already added to the installer by
the program authomatically.
Remember that,as any subDir must contain
the same files the new selected Dll/ocx
will be added to any Cab files that will
be created.
The limit is that in this case you will
see and you will be able to add Dll/ocx
only. If your program does not need any
additional library ignore the ADD button.
   
As soon as finished to complete the first window of INFactoryW_2003
press the button  (You may now see the INF file code
using the button on top right corner with caption SEE CODE now 
enabled.(Use the same button to close code's window).
Otherwise click the new button shown under the NEXT button that has
been disabled in the meantime and looks like the one below
  Clicking the 'Create CAB file' command you
will see one or more DOS windows flashing on the screen to confirm
you that CABwiz program is doing its job, thence the same button
will change its caption in 'Create INI file'.
Click on it to finish and go to see into FileResult folder where you
will find the CAB files and the Setup.ini file you need to get the
installer package.

NOTE: The Wizard option allows to use the files created with the file SetUp.exe that you find
            included in the FileResult folder.
           This means that in this case you will be unable to use Ezsetup program to get a 
            compressed autorunning installer even if you use win2k or over.

                                                       **************************

If your program needs not only additional libraries but also others
kind of files as images, sounds, dat or help files etc and it needs
also to load the into a device' folder that is not the usual Windows
or Install folder you have to choice the ADVANCED option.

How to go over if ADVANCED option has been selected:

In this case, as soon as selected the Device Defauld Directory in the
relative ComboBox you will not see the ADD button but you have to click
the NEXT button immediatly.
This will show you the second window of the program INFactoryW_2003 that
looks like this:



NOTE: You can note the list of files on the right shows strange paths.
           This is due to the ALL option selected for CPU type that allows the program to authomatically
           apply only the CPU working with the selected Operating System. 
           You may also note that the O.S include also Mobile2003 because the eVB files have been added
           to the list along with the NSB runtime files.
On top of this second window you can see a line of InputTextBoxes like this


 

in the line you can see 3 Group each with its Icon.
A means Application Folder
W means Windows Folder
? means Optional Folder and will be changed if you use it.

We may assume that the program for which you are creating the installer uses
some Bmp files that must be copied into the MyDocuments folder of the device.

If you check the textboxes line you will find the bmp extention but as 
explained above this extention is (by defauld) linked to Application Folder.
So highlight and cancel the bmp textbox then go to the first blank box in
the Optional folder and type here the extention bmp (ATT. bmp not .bmp)
You will get a Boxes line like the following:

 

After changing the default path for the files with bmp extention you must
select the real Path to use for this files. Click on the label ' ?  '
and you will see this 

Dropdown the ComboBox list and you will find few folders' paths.
Select here '\MyDocuments' and click on the 'add' button to get this result

 The letter shown can be different if you choice a 
different path, while it will be X if you use your customized path typing
it directly in the ComboBox text window.

We can go now to see the below to see the files'list on the left of the 
window showing on top to buttons 'Other Files' and 'Sys Files' as below


                  
Show the additional files used            Show the System Files like 
by your program that you loaded           dlls,ocx or exe files,some 
into the ApplicationFiles Dir             already added, and others  
to create the installer.                  that you may wish to add.

NOTE: If you added some extentions of files not included in the one shown as default you must
           click Other File button to refresh the list before selecting the files to add that otherwise
           will be not shown in the relative list. This not need for SysFile list.

Click on each file's name you wish to add. You will se a confirmation
window. If you click OK therein the File's name will be shown into the
project List on the right. Continue until all the files your program 
needs are shown in the list on the right thence click NEXT button.

While the window on the screen will remain about unchanged the lists
that are in the middle of the window will look as follows:

 

You have nothing to do in this new view. Only check that all the files
on the right have the mark  <-+ at the end of the line.
This means that all the files have been duly linked to their final path
to be copied, loaded and registered on the CE devices.

Note: If the mark <-+ is missing somewhere this may be caused by a wrong use of the program
         but also to a bug that i was unable to verify. Please inform me at efsoft@inwind.it
  
Click NEXT again to see the Third window of INFactoryW_2003 program.

 

This window may easy to use if you select only the kind of the output 
required for the installer. The DEFAULT option will create a set of files
to be used with the enclosed Setup.exe file that you will have to compress
using Zip or Rar or others programs to get the installer package.
The EZ Cab Files option instead will allows you to get, if you are working
under NT/Win2000, a compressed autointalling exe file by an additional 
window of INFactoryW_2003. (Infactory check authomatically under which 
kind of System you are working)
If you wish or you need instead to use also the above shown registry's keys
editor the use can become more difficult. I suggest the use of it to the
really advanced user that know well what he is doing and can check if the 
resulting keys are correctly written in the code.
A separate help will be posted to explain the use of this tools in addition
to the instructions already written into this window.
After selecting the output type click NEXT again and you will see....
 Take note that, as already written, before to use 
the 'Create CAB file' you can check the file INF just created using the
button 'See Code' on top right corner.You will see an image like this one.

 

If all is in order or if you do not know the INF file sintax then click 
directly the command button 'Create CAB File'
You will see some flashing DOS windows as shown below 
 at the end you will note that the button
caption is now 'Create INI file'and clicking on it the behaviour of the
program will be different again.

A)If you are working under Win98 and you selected obviously the Default 
  output you will see both NEXT and Create INI File buttons are now 
  showing the word 'DONE' so you can only exit from the program and go
  to the ResultFile folder to get the files you need for the installer.

B)If you are working under NT/Win2000 the third window of the program
  INFactory will remain unchanged on the screen as above except for a 
  button with the caption 'Call EZsetup' that you will see now enabled.
  Click on it to reach the fourth (and last) window of the program that
  will be shown like the following:



In this window you have only to select the User text file and the
Eula(licence) text file and to click the command button with caption
'Create EXE setup'

NOTE: The above mentioned text files may have any name you like but  the format must be strictly
           Text type  You must create them before starting to use the INFactory program and to store
            them into FileResult folder that is the same where the Ezsetup.exe file must be copied to 
            have program operative.

When you clicked the button you will note a Dos Application icon to appear
minimized in the status bar of your screen when this icon will be no longer
visible EXIT from INFactoryW_2003 program a you will find in the ResultFile
as usual the [YourProgramName]setup.exe file compressed installer.

And that is all.

Go here to DOWNLOAD INFactoryW2003

I can assure you that to write this page, that i hope may be useful, it is
more difficult than create an installer using INFactoryW_2003. 
I tested the installers on a H2210, HP565, Ipaq3130 and an Aero1550. Obviously there are a lot
 of devices using different O.S. and CPUs so it is very difficult and will require a long time to 
test the program in any possible condition. Any your feedback will be greatly appreciated.