Downloading and installing JOGL: Difference between revisions

From JogampWiki
Jump to navigation Jump to search
No edit summary
(Fixed release installation docs to use platform ZIP archives)
Line 1: Line 1:
To install JOGL, all you have to do is download the JARs and native libraries for your platform and put them in a directory of your choosing. No installer is necessary.
To manually install JOGL, all you have to do is download the your platform ZIP archives,
containing JARs and native libraries for your platform, and extract them in the same directory of your choice. No installer is necessary.


You have a choice of 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.
You have a choice of 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 =
= Downloading a released version =


You can download the files for the latest stable version at https://jogamp.org/deployment/webstart/. You'll need to download eight things, shown below. Pick the "natives" JARs appropriate to your platform; we show 64-bit Windows versions in the examples below.
JogAmp follows it's [[Jogamp_Versioning_and_Releases#Release_Classification|release scheme]],
describing the following resource locations to download the platform ZIP archives:


* <tt>gluegen-rt.jar</tt> (downloads as <tt>gluegen-rt.gz</tt>)
* [http://jogamp.org/deployment/webstart/archive/ Signed Release]
* <tt>gluegen-rt-natives-windows-amd64.jar</tt>
* [http://jogamp.org/deployment/webstart-next/archive/ Signed Candidate]
* <tt>jogl.all.jar</tt> (downloads as <tt>jogl.all.gz</tt>)
* [http://jogamp.org/deployment/jogamp-next/archive/ Candidate]
* <tt>jogl-natives-windows-amd64.jar</tt>
 
* <tt>nativewindow.all.jar</tt> (downloads as <tt>nativewindow.all.gz</tt>)
You'll need to download your platform's ZIP archive for each desired module, ie gluegen, jogl, jocl, etc.
* <tt>nativewindow-natives-windows-amd64.jar</tt>
 
* <tt>newt.all.jar</tt> (downloads as <tt>newt.all.gz</tt>)
* <tt>gluegen-2.0-b8-20101213-linux-amd64.zip</tt>
* <tt>newt-natives-windows-amd64.jar</tt>
* <tt>joal-2.0-20101213-linux-amd64.zip</tt>
* <tt>jogl-2.0-b11-20101213-linux-amd64.zip</tt>
* <tt>jocl-0.9-b1-20101213-linux-amd64.zip</tt>
 
The platform and version tags are explained in the [[Jogamp_Versioning_and_Releases#Version_Classification|versioning]] chapter.
 
You may also extract the API documentation:
 
* <tt>gluegen-javadoc.zip</tt>
* <tt>joal-javadoc.zip</tt>
* <tt>jogl-javadoc.zip</tt>
* <tt>jocl-javadoc.zip</tt>


= Downloading the latest automatic build =
= Downloading the latest automatic build =

Revision as of 22:25, 2 February 2011

To manually install JOGL, all you have to do is download the your platform ZIP archives, containing JARs and native libraries for your platform, and extract them in the same directory of your choice. No installer is necessary.

You have a choice of 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 a released version

JogAmp follows it's release scheme, describing the following resource locations to download the platform ZIP archives:

You'll need to download your platform's ZIP archive for each desired module, ie gluegen, jogl, jocl, etc.

  • gluegen-2.0-b8-20101213-linux-amd64.zip
  • joal-2.0-20101213-linux-amd64.zip
  • jogl-2.0-b11-20101213-linux-amd64.zip
  • jocl-0.9-b1-20101213-linux-amd64.zip

The platform and version tags are explained in the versioning chapter.

You may also extract the API documentation:

  • gluegen-javadoc.zip
  • joal-javadoc.zip
  • jogl-javadoc.zip
  • jocl-javadoc.zip

Downloading the latest automatic build

Every time changes to the JOGL code base are checked in, it starts an automatic build and test process. The resulting builds are placed at https://jogamp.org/deployment/autobuilds/master/, where you can download a build as one big file. Just pick the most recent jogl-b* directory, then download the right zip file for your platform from it. For 64-bit Windows the file will be jogl-2.0-bvvv-2010mmdd-windows-amd64.zip.

Note that these automatic builds may not have passed all the regression tests. You can check the build server at https://jogamp.org/chuck/job/jogl/ to see the test results for the automatic builds and make sure you're not downloading a broken build.

Unzipping the files

Unzip or unjar all the files you downloaded, then pull out gluegen-rt.jar, jogl.all.jar, nativewindow.all.jar newt.all.jar, and all the native library files (the .dll, .so, or .jnilib files). These files form your JOGL installation, which you can put wherever you want.

This installation contains all of JOGL. If you want to trim it down, see https://jogamp.org/jogl/doc/deployment/JOGL-DEPLOYMENT.html for more information.