Downloading and installing JOGL: Difference between revisions

From JogampWiki
Jump to navigation Jump to search
No edit summary
m (Removed a few apostrophes and changed a few word choices)
Line 1: Line 1:
To manually install JOGL, all you have to do is download the platform ZIP archives,  
To manually install JOGL, all you have to do is download the 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.
containing JARs and native libraries for your platform, and extract them in the 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.
Line 6: Line 6:
= Downloading a released version =
= Downloading a released version =


JogAmp follows it's [[Jogamp_Versioning_and_Releases#Release_Classification|release scheme]],
JogAmp follows a [[Jogamp_Versioning_and_Releases#Release_Classification|release scheme]],
describing the following resource locations to download the platform ZIP archives:
which describes the following locations to download the platform ZIP archives from:


* [http://jogamp.org/deployment/webstart/archive/ Signed Release]
* [http://jogamp.org/deployment/webstart/archive/ Signed Release]
Line 13: Line 13:
* [http://jogamp.org/deployment/jogamp-next/archive/ Candidate]
* [http://jogamp.org/deployment/jogamp-next/archive/ Candidate]


You'll need to download your platform's ZIP archive for each desired module, ie gluegen, jogl, jocl, etc.
You'll need to download your platform's ZIP archive for each desired module (GlueGen, JOGL, JOCL, or JOAL).


* <tt>gluegen-2.0-b8-20101213-linux-amd64.zip</tt>
* <tt>gluegen-2.0-b8-20101213-linux-amd64.zip</tt>
* <tt>joal-2.0-20101213-linux-amd64.zip</tt>
* <tt>jogl-2.0-b11-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>
* <tt>jocl-0.9-b1-20101213-linux-amd64.zip</tt>
* <tt>joal-2.0-20101213-linux-amd64.zip</tt>


The platform and version tags are explained in the [[Jogamp_Versioning_and_Releases#Version_Classification|versioning]] chapter.
The platform and version tags are explained in the [[Jogamp_Versioning_and_Releases#Version_Classification|versioning]] chapter.
Line 25: Line 25:


* <tt>gluegen-javadoc.zip</tt>
* <tt>gluegen-javadoc.zip</tt>
* <tt>joal-javadoc.zip</tt>
* <tt>jogl-javadoc.zip</tt>
* <tt>jogl-javadoc.zip</tt>
* <tt>jocl-javadoc.zip</tt>
* <tt>jocl-javadoc.zip</tt>
* <tt>joal-javadoc.zip</tt>


= Downloading the latest automatic build =
= Downloading the latest automatic build =
Line 33: Line 33:
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 <tt>jogl-b*</tt> directory, then download the right zip file for your platform from it. For 64-bit Windows the file will be <tt>jogl-2.0-bvvv-2010mmdd-windows-amd64.zip</tt>.
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 <tt>jogl-b*</tt> directory, then download the right zip file for your platform from it. For 64-bit Windows the file will be <tt>jogl-2.0-bvvv-2010mmdd-windows-amd64.zip</tt>.


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


= Unzipping the files =
= Unzipping the files =
Line 40: Line 40:
Using a common folder will leave the API documentation intact and resembles the original directory layout.
Using a common folder will leave the API documentation intact and resembles the original directory layout.


A common methodology is to unzip the platform ZIP archive and rename the new folder by it's module name, eg:
A common methodology is to unzip the platform ZIP archive and rename the new folder by its module name, for example:
<pre>
<pre>
unzip gluegen-2.0-b261-20110202-linux-amd64.zip
unzip gluegen-2.0-b261-20110202-linux-amd64.zip
Line 52: Line 52:
</pre>
</pre>


Now you have the following structure (same for all modules):
Now you have the following structure (the same for all modules):
<pre>
<pre>
gluegen/
gluegen/
Line 63: Line 63:
</pre>
</pre>


Now you may copy the required JARs out of each <i>jar</i> folder and the native libraries out of each <i>lib</i> 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.


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.
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.

Revision as of 00:48, 6 March 2011

To manually install JOGL, all you have to do is download the platform ZIP archives, containing JARs and native libraries for your platform, and extract them in the 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 a release scheme, which describes the following locations to download the platform ZIP archives from:

You'll need to download your platform's ZIP archive for each desired module (GlueGen, JOGL, JOCL, or JOAL).

  • gluegen-2.0-b8-20101213-linux-amd64.zip
  • jogl-2.0-b11-20101213-linux-amd64.zip
  • jocl-0.9-b1-20101213-linux-amd64.zip
  • joal-2.0-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
  • jogl-javadoc.zip
  • jocl-javadoc.zip
  • joal-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/ to see the test results for the automatic builds and make sure you're not downloading a broken build.

Unzipping the files

Unzip all downloaded platform ZIP archives (and the API doc's ZIP files) in a common folder. Using a common folder will leave the API documentation intact and resembles the original directory layout.

A common methodology is to unzip the platform ZIP archive and rename the new folder by its module name, for example:

unzip gluegen-2.0-b261-20110202-linux-amd64.zip
mv gluegen-2.0-b261-20110202-linux-amd64 gluegen

unzip jogl-2.0-b280-20110202-linux-amd64.zip
mv jogl-2.0-b280-20110202-linux-amd64 jogl

unzip gluegen-javadoc.zip
unzip jogl-javadoc.zip

Now you have the following structure (the same for all modules):

gluegen/
gluegen/artifact.properties
gluegen/javadoc/
gluegen/jar/
gluegen/lib/
gluegen/jnlp-files/
gluegen/LICENSE

Now you may copy the required JARs out of each jar folder and the native libraries out of each lib folder.

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.