General rules:
Work the utility with the host program is implemented through the launch of the utility with the command line.
All parameters passed to the command line should be in quotes ("option"). Parameters must be separated by a space.
In the folder "Settings" should be file "UMessages.ini", it sets the frequency to check for update messages, by default, once in 7 days. You can change the frequency within 1-30 days.
Recommended the file "ProgramsTool.ini" with the settings for your program put in the installation package (in folder "Settings").
Utility is compatible with Windows 2000 and later, when running on earlier versions of Windows in the folder "Settings" file will be created "NotSupportedOS.ini".
If the host program runs in full screen mode, then windows of utility will not be visible, take it into account, especially when you run the utility in modes the "Write a review about the program" and "Send error description".
Explanation of parameters:
ProName - program name *
ProVers - program version *
Lang - language (only "Russian" or "English") *
EMail - e-mail to send the feedback and bug reports *
PatchToExe - path (absolute) to the exe-file of host program *
PatchToFile - path (absolute) to the attachment file with the bug report, the text files only, no more than 100 kb.
URLtoFile - folder with the file with information about update *
Example: "http://sbgames.narod.ru/newversion/"
Update file name = ProName +'_'+ ProVers + '. Txt' for Russian and ProName +'_'+ ProVers + 'Eng.txt' for English.
If you don't use Russian language then the file ProName +'_'+ ProVers + '. Txt' may be empty (but it must be).
If the file is missing on the server, the utility believes that software updates were not.
URLtoMSG - folder with the file with information about update file of messages.
Example: "http://sbgames.narod.ru/messages/"
filename with the date of update of the Russian version message = 'Messages_LastEdit.txt'
filename with a Russian message = 'Messages.txt'
and / or
filename with the date of update of the English version message = 'MessagesEng_LastEdit.txt'
filename with a English message = 'MessagesEng.txt'
* - required parameters.
If you are not using any modes of utility, you must still fill out the required fields, without files on the server utility will work fine.
|
Startup modes:
- Mode - check for updates of program or update message. If the new version or message is available then show window for a user.
Running the utility with this command line is recommended to do when your program starts and closes.
Utility in this mode does not show its window, if there is no update or message.
Command Line in this mode:
'0 '+ProName+' '+ProVers+' '+Lang+' '+PatchToExe+' '+URLtoFile+' '+URLtoMSG
- Settings of check for updates.
Recommended that you make in your program button "Configure check for updates" and call the utility with this command line when pressing a button.
This is the default mode, if you have run the utility without any command line.
Command Line in this mode:
'1 '+ProName+' '+ProVers+' '+Lang+' '+PatchToExe+' '+URLtoFile
- Write a review about the program.
Recommended that you make in your program button "Write a comment on program" and call the utility with this command line when pressing a button.
Command Line in this mode:
'2 '+ProName+' '+ProVers+' '+Lang+' '+PatchToExe+' '+EMail
- Send error description and a text file with the report to your e-mail.
If you have an error handler, then you can do in his window button "Reveal to the author" and call the utility with this command line when pressing a button.
In this mode update and message windows are not shown.
Command Line in this mode:
'3 '+ProName+' '+ProVers+' '+Lang+' '+PatchToExe+' '+EMail+' '+PatchToFile
- Erase settings files of utility.
Utility can store their settings in the folder "Application Data" (if an entry in the folder "Settings" is not possible) to remove the settings from the folder "Appication Data" call the utility in this mode.
Command Line in this mode:
'UnInstall '+ProName
|