Step by step: How to use the wizard to protect your project

The purpose of this tutorial is to show how to use the wizard to build a customized plan for error handling. The detailed use of the selected options will not be discussed here - for more info please see the VB Watch Wizard topic.

1. Run the protector: menu Start / Programs / VB Watch 2 / VB Watch Protector.

2. Click the Launch Wizard... button.

3. Welcome screen: click Next.

4. Select Error Handling. Click Next.

5. Select Trap exceptions, Add line numbers, Preserve existing line numbers, Invite user to email a bug report.

Email report: put the email address where you wish to receive the reports.

Select Include call stack, Include Screenshot, Include system info.

Select Include procedure calls trace, With parameters, Include line execution trace. Select Command line or registry setting.

Select Include variable dump and check the 3 boxes below.

Click Next.

Warning: when shipping an application instrumented with the line execution trace option, it is recommended to use the Encrypt line trace file option from the General Options tab of the Control Center. The Encrypt line trace file option must be set prior to instrumenting a project.

Info: these settings require that you ship the vbwExtenderVB6.dll file with your application. To avoid that, you may check the No additional redistributable box but for less powerful reporting and emailing capabilities.

6. Miscellaneous: Select Let me select modules and procedures to instrument button. Click Next.

7. Select On your disk and a destination if the default doesn't suit you. You may leave this box unchecked only if you want to compile directly (see next step) and not keep the transformed source code on your disk.

Select In a zip file, so that you can keep an archived version of the transformed source code with all line numbers.

 Click Next.

8. Select Load the project in a new VB session. That way you can examine the transformed code before compiling, eventually removing some variables from the variables report.

Click Next.

9. Save the plan as Protector (Tutorial). Eventually enter a description. Click Next.

10. The plan is done. Select Start the process now if you wish to apply it immediately. Click Finish.

 To re-use ther plan later, you don't need the wizard anymore: just select it in the toolbar combo box, and click the Start selected plan button.

11. Click here (see Step 4) to continue and see what happens.

What do you want to know more about?

Topic link

VB Watch Wizard