NOTE: Before running this example, you must first put a copy of the JPEPortable.exe file in the Normal directory and rename it to notepad.exe.
This example presents a typical way of using the jauntePE runtime when first starting to portablize an application. This is the "old" recommendation. The new recommendation is given in the Normal2 example.
The Launch section
This section's settings are all launch settings and are read by the JauntePE-built application launcher. Each overrides its equivalent stored within the launcher executable file.
Please note that with the new Path, JPERuntime, and JPERuntimeIni settings, you now have complete control over the placement of the various files necessary to launch an application via JauntePE.
The ExeDir setting is turned off in this example since we don't want the current working directory changed to that of the launched executable's directory, but rather, want it to remain the same, which in most cases should be the launcher's directory. This allows relative paths to text files to be used on the command line, such as in bat or cmd files.
[Launch]
Path=%System%\%appname%.exe
JPERuntime=..\Runtime\Def\jauntePE.dll
JPERuntimeIni=.\%appname%_jauntePE.ini
ExeDir=0
The rest of this file's sections are all for runtime settings and are read by the JauntePE runtime dll. Each overrides its equivalent stored within the launcher executable file.
The Redirection section
This section's settings are from the Portablizer plugin's Redirection section and the Identification plugin's Redirection section.
If you're familiar with the "old" JauntePE runtime ini settings, these should look familiar to you. Please note the explicit setting of the settings. This is done since the launcher used has all settings turned off by default.
Also note that in this example the use of the in-memory portable registry is turned off (MemRegistry=0). This is the recommended setting when initially setting up an application that you are not familiar with. It is also the recommended setting if you are not familiar with the minor shortcomings associated with the use of the in-memory portable registry.
Also note the explicit indication to apply this ini's settings to any launched child applications (RedirMisc=1), and the explicit indication to prevent MS Installer installs from running (RedirMSI=1). Again, turning these 2 settings on is recommended if you are not familiar with the launched application.
[Redirection]
UseIcon=1
ModFrame=1
FlashDisco=1
IconDisco=1
InnerColor=0
OuterColor=0
MemRegistry=0
RedirMisc=1
RedirMSI=1
The Registry sections
With registry redirection turned on, by default all registry changes are redirected. So the only keys of concern are those that we don't want to have redirected into the portable registry. This is done via the registry exclusion list.
The list used in this example is one that has been created during the testing of a large number of applications. So it should provide a good starting point for new portablization efforts. You may need to add to it or take away from it for your particular applications as needed.
[Registry]
Use=1
Data=..\Data\%appname%.reg
[RegistryExclude]
1=HKEY_CURRENT_USER\Software\Microsoft\DirectInput
2=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\BitBucket
3=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\ComDlg32
4=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Discardable
5=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\MountPoints
6=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\MountPoints2
7=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders
8=HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Streams
9=HKEY_CURRENT_USER\Software\Microsoft\Windows\ShellNoRoam
10=HKEY_LOCAL_MACHINE\Software\Microsoft\Direct3D
11=HKEY_LOCAL_MACHINE\Software\Microsoft\DirectDraw
12=HKEY_LOCAL_MACHINE\Software\Microsoft\DirectInput
13=HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer\BitBucket
14=HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders
15=HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings
16=HKEY_LOCAL_MACHINE\System\CurrentControlSet
The Filesystem sections
With file system redirection turned on, by default all special folder file system changes are redirected. This is the recommended starting point for file system redirection since you don't really have any idea yet how the application makes use of the file system. Once you determine this then you can begin excluding as needed. Ideally you should be able to get to the point where you can exclude all and then add back in just those directories of interest.
Please note that in this example the SpecialFolders entries are included only to keep this example's portable file system directory names consistent with the other examples. You don't have to enter them if you don't want, as the jauntePE runtime will default them to something sensible when needed.
[Filesystem]
Use=1
Data=..\Data\Filesystem
[SpecialFolders]
5=Documents
20=Fonts