72 lines
2.9 KiB
Plaintext
72 lines
2.9 KiB
Plaintext
|
|
||
|
|
|
||
|
|
USING THE JAVA WRAPPER FOR ARNETWORKING
|
||
|
|
|
||
|
|
"Wrapper" libraries for Java have been provided for both Aria and ArNetworking
|
||
|
|
in Aria's "java" directory ("../java"). This wrapper layer provides a Java API which simply
|
||
|
|
makes calls into the regular ArNetworking C++ implementation (using JNI).
|
||
|
|
|
||
|
|
To use the ArNetworking Java wrapper you need to download a Java SDK. Sun J2SE JDK
|
||
|
|
1.6 (Java SE6) was used to build the wrapper. You can download it from:
|
||
|
|
|
||
|
|
http://java.sun.com/javase/downloads
|
||
|
|
|
||
|
|
Find the Java SE Development Kit 6 and click "Download". (Only the JDK
|
||
|
|
is needed, ARIA does not need Java EE or any other extra Java technologies.)
|
||
|
|
|
||
|
|
The JDK also includes the runtime environment (JRE) that allows you to run
|
||
|
|
Java programs. If you only need the JRE, it can also
|
||
|
|
be obtained from <http://java.sun.com>.
|
||
|
|
|
||
|
|
Install it on your system, then you should put the bin
|
||
|
|
directory of the SDK into your PATH environment variable.
|
||
|
|
|
||
|
|
For information about Java on Debian GNU/Linux systems, install the
|
||
|
|
"java-common" package, and see the Debian Java FAQ in
|
||
|
|
/usr/share/doc/java-common/debian-java-faq/index.html
|
||
|
|
Chapter 11 describes how to install the Java 2 SDK from Blackdown using
|
||
|
|
Apt.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
In Windows you must then put the Aria\bin directory into your PATH enviornment
|
||
|
|
variable so that Java can find the dll needed to run the wrapper (use the System
|
||
|
|
control panel, or set in in the command shell prior to running java). On Linux,
|
||
|
|
Aria/lib should be in your LD_LIBRARY_PATH or in /etc/ld.so.conf.
|
||
|
|
|
||
|
|
For an example you should start the simulator, then go into
|
||
|
|
the javaExamples directory and compile the simple Java
|
||
|
|
example, and then run it.
|
||
|
|
|
||
|
|
On Windows:
|
||
|
|
javac -classpath ../../java/Aria.jar;../../java/ArNetworking.jar simple.java
|
||
|
|
java -cp ../../java/Aria.jar;../../java/ArNetworking.jar;. simple
|
||
|
|
|
||
|
|
On Linux:
|
||
|
|
javac -classpath ../../java/Aria.jar:../../java/ArNetworking.jar simple.java
|
||
|
|
java -cp ../../java/Aria.jar:../../java/ArNetworking.jar:. simple
|
||
|
|
|
||
|
|
The difference is the separator in the class path (; vs :).
|
||
|
|
|
||
|
|
The Java wrapper is not as well tested as ArNetworking itself. If you encounter
|
||
|
|
problems using it, please notify the aria-users mailing list.
|
||
|
|
|
||
|
|
|
||
|
|
REBUILDING THE JAVA WRAPPER
|
||
|
|
|
||
|
|
If you want to rebuild the Java wrapper you need to install SWIG:
|
||
|
|
See <http://www.swig.org/download.html> You should get at
|
||
|
|
least version 1.3.17. You then need to set the environment variable
|
||
|
|
JAVA_INCLUDE to the include directory in your Java SDK, and
|
||
|
|
JAVA_BIN to the bin directory in your Java SDK. (If you installed
|
||
|
|
the j2sdk1.4 from Blackdown on Debian, JAVA_INCLUDE should be
|
||
|
|
/usr/lib/j2se/1.4/include).
|
||
|
|
|
||
|
|
In Linux, set your path so that swig is in the path then run
|
||
|
|
'make java' in the Aria directory, then again in the ArNetworking directory.
|
||
|
|
|
||
|
|
In Windows with Visual Studio .NET, open java/ArNetworkingJava.vcproj, select
|
||
|
|
Tools menu -> Options -> Projects -> VC++ Directories and add your SWIG
|
||
|
|
directory. Then you should just be able to build the library.
|
||
|
|
|