Environment Setup

If you have received a pre-built version of the dotnetproxyagent, there is no need to rebuild it. You can determine this by checking to see if you have a "runtime/dotnetproxyagent/jar/" directory containing the "dotnetproxyagent.jar" file. If you have this file, you have pre-built dotnetproxyagent distribution and you do not need to rebuild.

Similarly, if you have the files "lib/win32/Oaa2JavaNet.dll" and "lib/win32/Oaa2JavaNet.tlb", you may not need to build Oaa2JavaNet.dll. Note, however, that if you plan to use Oaa2JavaNet.dll with COM, it is necessary either to rebuild Oaa2JavaNet.dll or to use the MS Visual Studio regasm and gacutil commands. See install.html for details.

The agent requires the Sun Java Virtual Machine SDK, version 1.4.1. This can be downloaded from:

http://java.sun.com/j2se/1.4.1/download.html

The dotnet library is built using ant version 1.5.1 or higher (ant 1.5.3 has been tested as well). Ant is a tool for executing XML makefiles. It can be downloaded from the apache jakarta project at:

http://jakarta.apache.org/ant/

Before building the dotnet library, make sure the following two environment variables are set:

• JAVA_HOME : Set to the java installation directory
• ANT_HOME : Set to the ant installation directory

Also make sure ${ANT_HOME}/bin and ${JAVA_HOME}/bin are in the path.

To build Oaa2JavaNet.dll, you must have all this installed and have Microsoft Visual Studio .NET 2003 installed.

Building dotnetproxyagent

To build the dotnetproxyagent, navigate to the directory "src/dotnetproxyagent" and execute "ant". The following ant targets are defined:

• ant - Executes the main target. This will build the distribution.
• ant runtime - Generates runtime distribution into the runtime folder.
• ant clean - Cleans the distribution.
• ant test - Executed unit tests and generates a unit test report.

Building Oaa2JavaNet.dll

To build Oaa2JavaNet.dll, navigate to the directory "src/oaalib/dotnet/" and execute "ant". The following ant targets are defined:

• ant - Executes the main target. This will build the distribution.
• ant runtime - Generates runtime distribution into the runtime folder.
• ant clean - Cleans the distribution.

Note that building Oaa2JavaNet.dll will automatically build the dotnetproxy if necessary.