This topic describes how you can import your e-PocketSetup 3.x projects to VisualSetup 4.0. All projects for e-PocketSetup 3.x are automatically converted to the new project format. The dialogs and click-script format were drastically recreated, so we will explain how they are converted to help you understand the difference between this release and the old one. All these conversions are automatically done by VisualSetup 4.0.
Converting an e-PocketSetup 3.x Project
|
To do it, just click File > Import > Import e-PocketSetup 2002/2003 Project menu command.
Select your e-PocketSetup 3.x project file and click Open button.
All information you have defined on your project will be imported, but VisualSetup have included many new features and editors, including new messages that were not used on e-PocketSetup 3.x. So, you have a project in another language (you project does not have the messages in English), you must translate the new messages using the Setup Messages editor.
Dialog's format differences
|
VisualSetup 4.0 has new controls, dialog's properties and control's properties. Some restrictions were included to create a dialog format totally compatible with Windows Installer:
| • | Font color property is no longer supported for Buttons and Image Buttons. |
| • | Image Buttons do not exist any more, now the Buttons have an Icon property that can be assigned with icon files. Bitmaps are no longer supported in buttons, only Icon files are supported. |
| • | Shapes are no longer supported, VisualSetup has the Rectangle and Line controls instead of Shape control. |
System variables differences
|
Some system variables was replaced either with another variable or with an action. The main changes in the system variables are:
| • | %CmdParamNum%, variable that stores the index of parameter available in variable %CmdLineParam% is not necessary any more, so it was removed from the system variables set. Now %CmdLineParam% variable is an array, so, to get the first parameter use %CmdLineParam%[0]. |
| • | %ColorDepth% variable was replaced with the Get Color Depth action. |
| • | %CommonShellFolders% variable was replaced with the Common Shell Folders action. |
| • | %DeviceCPU% variable was replaced with the Get Processor action, when it is called inside a remote block. |
| • | %DLLResult% variable was removed from the system variables set. Since you only can call DLL functions in a VisualSetup 4.0 project defining a DLL Action, and the value returned by the DLL functions are stored in the Result variable of each DLL action, the %DLLResult% variable is no longer necessary. |
| • | %DoReboot% variable was removed from the system variables set. To reboot the computer you must call the Soft-reset action. |
| • | %EuropeanDate% variable was removed from the system variables set. To get the date in European style, just use the string %CurrentDay%/%CurrentMonth%/%CurrentYear%. |
| • | %FileGroup% variable stores the name of current file group (VisualSetup 4.0 calls the file groups as device components). This variable was used when you needed different click-script actions for check file group, since e-PocketSetup 3.0 had an unique click-script code for each file group. VisualSetup 4.0 allows you define a different click-script code for each device component, so this variable is no longer necessary. |
| • | %HotSyncUser% variable was replaced with the %SelectedHotSyncUsers% array. Now, VisualSetup allows you to access all selected HotSync users using this %SelectedHotSyncUsers% array. To get the first selected HotSync user (that actually was the value of %HotSyncUser% variable), just use %SelectedHotSyncUsers%[0]. |
| • | %ISODate% variable was removed from the system variables set. To get the date in European style, just use the string %CurrentYear%-%CurrentMonth%-%CurrentDay%. |
| • | %OSMajorVersion%, %OSMinorVersion% and %OSVersion% variables were replaced with the Get OS Version action. |
| • | %RAMMemory% variable was replaced with the Get RAM's Size action. |
| • | %SetupType% variable was replaced with the Set Setup Type action. |
| • | %ScreenHeight% and %ScreenWidth% variables where replaced with the Get Screen's Size action. |
Click-script's format differences
|
Click-Script 3.0 was completely rewritten. Many new actions were included, also VisualSetup 4.0 allows you define custom actions, DLL actions and import actions from Actions' Libraries. All actions of Click-Script 2.0 can be mapped to a Click-Script 3.0 action, the main differences are:
| • | The variables declared inside a click-script event are considered Local Variables, only the variables declared in the Global Variables' Declaration editor are considered Global Variables. |
| • | All remote actions were removed from the actions set. VisualSetup 4.0 includes a new clause named remote. All actions inside a remote block will be executed in the remote device. All available actions can be executed in the remote device (except for the DLL actions), so you have many new possibilities to configure your Windows Mobile application. |
| • | All files' operation actions now works with File Handles, now you can open how many files you want in the same time. |
| • | Open File action does not have the Magic Long property any more, but you can simulate this property including the Read DWORD From File action and then testing the returned value with the Magic Long property's value. |
| • | Write Text action was replaced with the Write Fixed String To File action. |
| • | Write Line action was replaced with the Write Line To File action. |
| • | Read Text action was replaced with the Read Fixed String From File action. |
| • | Read Line action was replaced with the Read Line From File action. |
| • | Read Registry Value action was replaced with Read String From Registry action. |
| • | Write Registry Value action was replaced with Write String To Registry action. |
| • | Remove Registry Item action was removed. Now, if you want to remove a registry's entry you must call Remove Registry's Entry action, or if you want to remove a registry's key you must call Remove Registry's Key action. |
| • | Set Variable action was removed. Now, if you want to change the value of a variable, or declare a local variable, you must call one of the Attribution Actions. e-PocketSetup 3.x has some system variables that, when they were modified, some imported action in the setup program happened, to now more about the Set Variable action read the previous section of this topic. |
| • | Cancel/Close action was removed. If you want to close a secondary dialog you must call the Close Dialog action. If you want to close the setup program, asking the end-user to confirm, you must call Close Setup action with the Force parameter as False. If you want to close the setup program without asking the end-user's confirmation, you must call Close Setup action with the Force parameter as True. When you closed the setup program created by e-PocketSetup 3.x, if the variable %DoReebot% was True, the computer was rebooted, now if you want to reboot the computer you must call the Soft-reset action. |
| • | Finish Setup action was replaced with the Close Setup action with the Force parameter as True. |
| • | Load Directory Dialog action was replaced with Browse For Folders action. |
| • | Call DLL Function action was removed. Now, if you want to call an external DLL function, first you must to define a DLL Action and then call it. |
| • | Math Operation action was removed. Now, if you want to execute a mathematical operation, just type the mathematical expression in the parameter, VisualSetup 4.0 supports all standard mathematical operations like addition (+), subtraction (-), multiplication (*), division (/) and power (^). |
| • | Get File Information action was removed. When the Info Type parameter is SIZE, just call the Get File Size action. When the Info Type parameter is VERSION, just call the Get File Version action. For the other Info Type parameter's values use the Parse File action to do the same functionality. |
| • | Random Number action was replaced with Get Random Number action. |
| • | Is Installed action was replaced with Software Installed action. |
| • | Use Uninstalled Settings action was replaced with Set Install Mode action with Mode parameter as ADD/REMOVE. |
| • | Is Connected action was replaced with Check Device Connection action. |
| • | Get Current Device action was replaced with Get Device Name action. |
| • | Get Current Processor action was replaced with Get Processor ID action. |
| • | Is XScale Processor action was replaced with Check XScale action. |
| • | Is Compatible action was replaced with Check Compatibility action. |
| • | HotSync Users Count action was removed. Now, if you want to get this information, first you must call the List HotSync Users action and then call the Get Array's Size action to get the size of the HotSync users' array. |
| • | HotSync User action was removed. Now, if you want to get this information, first you must call the List HotSync Users action and then get the user's name using the returned HotSync users' array. |
| • | For Each clause was removed. Now, if you want to use it, you must use the For clause. |
| • | Include in Array action was replaced with a simple Array Attribution. |
| • | Exclude of Array action was replaced with the Remove Array's String action. |
| • | Is in Array action was replaced with Get String's Index action. |
| • | Enable Button action was replaced with Enable Control action. |
| • | Disable Button action was replaced with Disable Control action. |
| • | Decimal To Hex action was replaced with Number To Hex action. |
| • | Hex To Decimal action was replaced with Hex To Number action. |
| • | Complete With Zeros action was replaced with Complete with Char action. |
| • | Rename File action was replaced with Move File action.
|
