Downloading and installing JOGL: Difference between revisions

From JogampWiki
Jump to navigation Jump to search
(First cut at fixes to describe new archive format)
(Added table of JAR and native library names)
Line 1: Line 1:
Before you can build a project that uses JOGL [https://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE in your IDE or on the command line], you'll need to download and install the JOGL JAR files and native libraries (.dll/.so/.dynlib files).
Before you can build a project that uses JOGL [https://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE in your IDE or on the command line], you'll need to download and install the JOGL JAR files and native libraries (.dll/.so/.jnilib files).


You have a choice of JOGL versions to download. The [{{SERVER}}/deployment/jogamp-current/archive/ latest stable version] is probably safer, but lags behind in features. The [{{SERVER}}/deployment/autobuilds/master/ latest automatic build] contains all checked-in code, but may be failing some tests.
You have a choice of JOGL versions to download. The [{{SERVER}}/deployment/jogamp-current/archive/ latest stable version] is probably safer, but lags behind in features. The [{{SERVER}}/deployment/autobuilds/master/ latest automatic build] contains all checked-in code, but may be failing some tests.
Line 43: Line 43:
= Unzipping the files =
= Unzipping the files =


Unzip all the downloaded files with [http://www.7-zip.org/ 7zip]. An unzipped file has these general contents
Unzip all the downloaded files with [http://www.7-zip.org/ 7zip]. An unzipped file has this general directory structure:


<pre>
<pre>
Line 52: Line 52:
</pre>
</pre>


Now you may copy the required JARs out of each <tt>jar</tt> folder and the native libraries out of each <tt>lib</tt> folder.
Now you may copy the required JARs out of each <tt>jar</tt> folder and the native libraries out of each <tt>lib</tt> folder. For a full desktop installation, here are the files you need:
 
{|cellpadding="4" cellspacing="0"
!align="left"|Windows
!align="left"|Linux
!align="left"|Mac
|-
|<tt>gluegen-rt.jar</tt>||<tt>gluegen-rt.jar</tt>||<tt>gluegen-rt.jar</tt>
|-
|<tt>jogl.all.jar</tt>||<tt>jogl.all.jar</tt>||<tt>jogl.all.jar</tt>
|-
|<tt>jogl.all.jar</tt>||<tt>jogl.all.jar</tt>||<tt>jogl.all.jar</tt>
|-
|<tt>gluegen-java-src.zip</tt>||<tt>gluegen-java-src.zip</tt>||<tt>gluegen-java-src.zip</tt>
|-
|<tt>jogl-java-src.zip</tt>||<tt>jogl-java-src.zip</tt>||<tt>jogl-java-src.zip</tt>
|-
|<tt>gluegen-rt.dll</tt>||<tt>libgluegen-rt.so</tt>||<tt>libgluegen-rt.jnilib</tt>
|-
|<tt>jogl_desktop.dll</tt>||<tt>libjogl_desktop.so</tt>||<tt>libjogl_desktop.jnilib</tt>
|-
|<tt>nativewindow_awt.dll</tt>||<tt>libnativewindow_awt.so</tt>||<tt>libnativewindow_awt.jnilib</tt>
|-
|<tt>nativewindow_win32.dll</tt>||<tt>libnativewindow_win32.so</tt>||<tt>libnativewindow_win32.jnilib</tt>
|-
|<tt>newt.dll</tt>||<tt>libnewt.so</tt>||<tt>libnewt.jnilib</tt>
|}


= More information =
= More information =

Revision as of 17:40, 21 December 2011

Before you can build a project that uses JOGL in your IDE or on the command line, you'll need to download and install the JOGL JAR files and native libraries (.dll/.so/.jnilib files).

You have a choice of JOGL versions to download. The latest stable version is probably safer, but lags behind in features. The latest automatic build contains all checked-in code, but may be failing some tests.

Downloading the latest stable version

Go to this page and download one of these files for each platform you're developing on:

32-bit Windows: jogamp-windows-i586.7z
64-bit Windows: jogamp-windows-amd64.7z
32/64-bit Mac OS X: jogamp-macosx-universal.7z
32-bit Linux: jogamp-linux-i586.7z
64-bit Linux: jogamp-linux-amd64.7z
32-bit Solaris: jogamp-solaris-i586.7z
64-bit Solaris: jogamp-solaris-amd64.7z

Downloading the latest automatic build

For the latest automatic build, we have to download gluegen and jogl separately.

First, go to [https://jogamp.org/deployment/autobuilds/master/ this page and click on the most recent gluegen-b* directory. Then download one of these files for each platform you're developing on:

32-bit Windows: gluegen-2.0-bvvv-20yymmdd-windows-i586.7z
64-bit Windows: gluegen-2.0-bvvv-20yymmdd-windows-amd64.7z
32/64-bit Mac OS X: gluegen-2.0-bvvv-20yymmdd-macosx-universal.7z
32-bit Linux: gluegen-2.0-bvvv-20yymmdd-linux-i586.7z
64-bit Linux: gluegen-2.0-bvvv-20yymmdd-linux-amd64.7z
32-bit Solaris: gluegen-2.0-bvvv-20yymmdd-solaris-i586.7z
64-bit Solaris: gluegen-2.0-bvvv-20yymmdd-solaris-amd64.7z

Then, go to [https://jogamp.org/deployment/autobuilds/master/ this page and click on the most recent jogl-b* directory. Then download one of these files for each platform you're developing on:

32-bit Windows: jogl-2.0-bvvv-20yymmdd-windows-i586.7z
64-bit Windows: jogl-2.0-bvvv-20yymmdd-windows-amd64.7z
32/64-bit Mac OS X: jogl-2.0-bvvv-20yymmdd-macosx-universal.7z
32-bit Linux: jogl-2.0-bvvv-20yymmdd-linux-i586.7z
64-bit Linux: jogl-2.0-bvvv-20yymmdd-linux-amd64.7z
32-bit Solaris: jogl-2.0-bvvv-20yymmdd-solaris-i586.7z
64-bit Solaris: jogl-2.0-bvvv-20yymmdd-solaris-amd64.7z

Note that these automatic builds may not have passed all the regression tests. You can check the build server to see the test results for the automatic builds and make sure you're not downloading a broken build.

Unzipping the files

Unzip all the downloaded files with 7zip. An unzipped file has this general directory structure:

<archive>/
<archive>/jar/
<archive>/lib/
<archive>/<module>-java-src.zip*

Now you may copy the required JARs out of each jar folder and the native libraries out of each lib folder. For a full desktop installation, here are the files you need:

Windows Linux Mac
gluegen-rt.jar gluegen-rt.jar gluegen-rt.jar
jogl.all.jar jogl.all.jar jogl.all.jar
jogl.all.jar jogl.all.jar jogl.all.jar
gluegen-java-src.zip gluegen-java-src.zip gluegen-java-src.zip
jogl-java-src.zip jogl-java-src.zip jogl-java-src.zip
gluegen-rt.dll libgluegen-rt.so libgluegen-rt.jnilib
jogl_desktop.dll libjogl_desktop.so libjogl_desktop.jnilib
nativewindow_awt.dll libnativewindow_awt.so libnativewindow_awt.jnilib
nativewindow_win32.dll libnativewindow_win32.so libnativewindow_win32.jnilib
newt.dll libnewt.so libnewt.jnilib

More information

JogAmp follows a release scheme, which describes the following locations to download the 7z archives from:

JOGL Deployment describes the content of the 7z archive files.

These installations contain all of JOGL. If you want to remove parts you don't use, see JOGL Deployment for more information.