README


JNI Wizards for Visual C++ 7.1 (Visual Studio .NET 2003)

Version 0.1

July 17, 2004



Contents

Features of JNI Wizards for Visual C++ 7.1

System Requirements

What Will Be Installed on Your System

Installation Instructions

Installation Issues

Troubleshooting the Installation

Visual C++ 7.1 Integration

How To: Make a New JNI DLL

How To: Add JNI Support to An Existing Projects


Features of JNI Wizards for Visual C++ 7.1

This product includes two wizards for Microsoft Visual C++ 7.1 and Visual Studio .NET 2003: (1) JNI DLL Wizard, (2) Add JNI To Project. Both wizards are free tools from PureNative Software for the community of Java developers on Windows. They may be used for commercial and noncommercial use alike, regardless of whether the source code for your project is open source or not.

JNI DLL Wizard is an application wizard. It allows you to simply generate new dynamic link library application projects that use Java Native Interface (JNI).

Add JNI To Project is an Add Class wizard. It allows you to easily add Java Native Interface (JNI) support to an existing C++ DLL or application project.

PureNative Software produces other tools for Java/C++ developers on Windows. These include NewJ Library for C++, a 100% native implementation of the core Java API for C++, and NewJNI, the natural C++ interface to JREs built on standard JNI.


System Requirements

Minimum System:

Intel Pentium, 150 MHz or faster
Windows XP/2000/NT4/ME/98/95
Microsoft Visual C++ 7.1 (Visual Studio .NET 2003)

Recommend System:

Intel Pentium, 800 MHz or faster
Windows XP/2000
Microsoft Visual C++ 7.1 (Visual Studio .NET 2003)

JNI Wizards for Visual C++ 7.1 do not support the earlier Visual C++ 7.0, which is part of Visual Studio .NET 2002. We expect that practically all Visual C++ 7.0 developers have upgraded to Visual C++ 7.1. If you require support for Visual C++ 7.0 (Visual Studio .NET 2002), feel free to make this known to us for our consideration by sending an email to the support account for pure-native.com.


What Will Be Installed on Your System

The installation program will install the following on your system:


Installation Instructions

To install JNI Wizards for Visual C++ 7.1 follow these steps:

  1. Run the installation program, which is named JNIWizards-0_1-vc71-install.exe. You may do this using the mouse by double-clicking on the program icon. If you prefer to use the keyboard, you may run the program from the Start menu’s Run option or from any command prompt. Be sure to enter the full path to the executable.

  2. Choose the directory where you wish to install JNI Wizards for Visual C++ 7.1.

That’s it. The installer does the rest.


Installation Issues

Problem: On Windows 2000, the installation program will fail to update your Visual C++ settings if you do not have administrator privileges.

Solution: Have administrator grant your user account administrator privileges.


Troubleshooting the Installation

If you experience problems with installing JNI Wizards for Visual C++ 7.1, you may find helpful information at the PureNative Software web site at http://www.pure-native.com. If the problem you are experiencing is not addressed on our web site, you may contact us via the support email account for pure-native.com.


Visual C++ 7.1 Integration

The installation program automatically updates your Visual C++ 7.1 development environment for JNI Wizards for Visual C++ 7.1. JNI DLL Wizard will appear with all other wizards for Visual C++ Project whenever you select File > New > Project... The Add JNI To Project wizard will appear with all other Add Class wizards whenever you select a project and choose Add Class...


How To: Make a New JNI DLL

In the Visual C++ 7.1 IDE, to create a new DLL that supports JNI, do the following:

  1. Select the menu item File > New > Project...

  2. Select the Visual C++ Projects folder.

  3. Choose JNI DLL.

  4. Enter the name of your application.

  5. Choose OK.

  6. The JNI DLL Wizard will appear. Choose Finish to make the new application project.

Your new JNI DLL is now ready to be edited, compiled, and loaded.


How To: Add JNI Support to An Existing Project

In the Visual C++ 7.1 IDE, to add JNI support to an existing C++ DLL or application project, follow these steps:

  1. Open your C++ DLL or application project/solution in the Visual C++ 7.1 IDE.

  2. Select your project in the Solution Explorer.

  3. Select the menu item Project > Add Class...

  4. Under Categories, select Visual C++.

  5. Under Templates, select Add JNI To Project.

  6. Choose Open.

  7. The Add JNI To Project wizard will appear. Choose Finish.

Your C++ DLL or application is now ready to use JNI.


Copyright © 2004 PureNative Software Corporation. All rights reserved.

PureNative, NewJ, NewJNI, NewJNInterop, and Pie are trademarks of PureNative Software Corporation. Other trademarks and registered trademarks are property of their respective holders.

For more information, please visit http://www.pure-native.com.