CodeSonar With CodeWarrior: DLL Approach (Windows Only)

• Introduction
• DLLs
• Installing
• Building

Introduction

Use the approach described in this section if your CodeWarrior installation uses DLLs. See Using CodeSonar With CodeWarrior: Which Approach? if you are not sure.

If your CodeWarrior installation uses compiler executables rather than DLLs, do not use the approach described in this section. Instead, use the standard approach.

DLLs

CodeSonar has its own versions of the DLLs used by CodeWarrior. In general, the CodeSonar version of a specific CodeWarrior DLL consists of references to that DLL, plus additional code that supports the CodeSonar build. This approach is used to ensure that the CodeSonar build captures everything that happens when a CodeWarrior project is built. There is no effect on the underlying software project.

When you install the CodeSonar DLLs, they will be stored with the same names and locations as the original CodeWarrior DLLs, which will in turn be renamed from fname.dll to fname.dll.csbak.

Installing

You can install the CodeSonar DLLs for CodeWarrior when you install CodeSonar, or wait until you want to build a CodeSonar project based on a CodeWarrior build. If installing the DLLs will require special privileges then they should be installed by an administrator as part of the CodeSonar installation process. Otherwise, the choice depends only on user preference.

Install The DLLs During CodeSonar Installation

The DLLs for CodeWarrior are installed by the Windows installer for CodeSonar.

Important: If you have a 32-bit version of CodeWarrior, you will need to install a 32-bit version of CodeSonar in order to use the CodeSonar DLLs for CodeWarrior.

Follow the installer instructions, making sure you do the following.

1. On the second screen of the installer, which is titled Choose Components, select CodeWarrior Support.
2. Once you have clicked Install, the Installing screen will display the progress as CodeSonar is installed. Toward the end of the process, a CodeWarrior Support dialog will display:

   

   The dialog has the following components.

   Plugin Path field	A list of all plugin DLLs that CodeSonar knows about, with a checkbox next to each. On OK, CodeSonar will install its own versions of all DLLs on the list (checked or not), and configure its versions of the checked DLLs to be hooked by the CodeSonar project build (the CodeSonar versions of unchecked DLLs will simply pass calls straight through to the original versions). Warning: do not unselect your compiler executable, or CodeSonar will not be able to properly observe the project build.
   Delete button	If there are listed plugins that you do not want CodeSonar to replace, select them and click Delete to remove their names from the list. Warning: do not delete your compiler executable from the list, or CodeSonar will not be able to properly observe the project build.
   Add Files... button	To add individual files to the list of plugins, click Add Files... and use the dialog that opens to browse to and select the desired files.
   Add Directory... button	To add all plugins for a CodeWarrior installation, click Add Directory... and use the dialog that opens to browse to and select the top-level installation directory. For selected directory CW_dir, CodeSonar will add all plugins stored in CW_dir\bin\plugins\compiler to the list.
   Activate All button	Click to select all plugins in the list.
   Disable All button	Click to deselect all plugins in the list.
   OK button	Click when you are satisfied with the plugin list and selections. The listed plugins will be replaced with CodeSonar versions, and the selected plugins will be configured to be hooked during the CodeSonar build.
   Cancel button	Click to cancel plugin setup and return to the CodeSonar installation. No plugins will be replaced.

3. When you click OK (or Cancel), the CodeSonar installation will proceed accordingly.

Install The DLLs During The CodeSonar Project Build: Windows Build Wizard

The Windows build wizard provides a mechanism for specifying DLL installation and use. Once the CodeSonar versions of the DLLs have been installed they remain installed (unless CodeSonar is uninstalled), but the build wizard can still be used to specify whether or not the CodeSonar-specific parts of the DLLs should be activated for a particular build.

Use the build wizard to set up and perform the build, with the following additional steps on screen 2.

1. Click the Change... button next to the CodeWarrior: field.
2. A CodeWarrior Support dialog will open. This is like the dialog for installing the DLLs during CodeSonar installation (as described above) with a few important differences.
   • There is no Delete button.
   • Only the selected DLLs will be replaced with CodeSonar versions (if this has not already occurred). Unselected DLLs will not be replaced.

     If unselected DLLs have previously been replaced by CodeSonar versions, they will be configured so that they pass calls through to the original DLLs without performing any additional work in support of the CodeSonar build.

3. Once you have finished choosing the plugins to replace, click OK to install the replacements. If you decide not to replace any plugins, click Cancel.
4. Finish building the project.

Install The DLLs During The CodeSonar Project Build: Command Line

CodeSonar has CodeWarrior-specific configuration file parameters for controlling DLL installation and activation during command line builds (these parameters are ignored by the Windows build wizard).

Building

CodeSonar project builds can be based on CodeWarrior builds using the standard command line or Windows build wizard procedures. There are a few points to note, however.