Downloading and installing JOGL: Difference between revisions

From JogampWiki
Jump to navigation Jump to search
No edit summary
(First cut at fixes to describe new archive format)
Line 1: Line 1:
To manually install JOGL, all you have to do is download the platform ZIP archives,
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).
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 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.


[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment] describes the content of the 7z archive files.
= Downloading the latest stable version =
 
Go to [{{SERVER}}/deployment/jogamp-current/archive/ this page] and download one of these files for each platform you're developing on:
 
: 32-bit Windows: <tt>jogamp-windows-i586.7z</tt>
: 64-bit Windows: <tt>jogamp-windows-amd64.7z</tt>
: 32/64-bit Mac OS X: <tt>jogamp-macosx-universal.7z</tt>
: 32-bit Linux: <tt>jogamp-linux-i586.7z</tt>
: 64-bit Linux: <tt>jogamp-linux-amd64.7z</tt>
: 32-bit Solaris: <tt>jogamp-solaris-i586.7z</tt>
: 64-bit Solaris: <tt>jogamp-solaris-amd64.7z</tt>


= Downloading a released version =
= Downloading the latest automatic build =


JogAmp follows a [[Jogamp_Versioning_and_Releases#Release_Classification|release scheme]],
For the latest automatic build, we have to download gluegen and jogl separately.
which describes the following locations to download the platform ZIP archives from:


* [{{SERVER}}/deployment/ Deployment Home]
First, go to [{{SERVER}}/deployment/autobuilds/master/ this page and click on the most recent <tt>gluegen-b*</tt> directory. Then download one of these files for each platform you're developing on:
** [{{SERVER}}/deployment/jogamp-current/archive/ Signed Release]
** [{{SERVER}}/deployment/jogamp-next/archive/ Signed Candidate]
** [{{SERVER}}/deployment/jogamp-next/v2.0-rc3archive/ Specific Version]


You'll need to download your [[Jogamp_Versioning_and_Releases#Release_and_Archived_Files|platform's 7z archive]].
: 32-bit Windows: <tt>gluegen-2.0-bvvv-20yymmdd-windows-i586.7z</tt>
: 64-bit Windows: <tt>gluegen-2.0-bvvv-20yymmdd-windows-amd64.7z</tt>
: 32/64-bit Mac OS X: <tt>gluegen-2.0-bvvv-20yymmdd-macosx-universal.7z</tt>
: 32-bit Linux: <tt>gluegen-2.0-bvvv-20yymmdd-linux-i586.7z</tt>
: 64-bit Linux: <tt>gluegen-2.0-bvvv-20yymmdd-linux-amd64.7z</tt>
: 32-bit Solaris: <tt>gluegen-2.0-bvvv-20yymmdd-solaris-i586.7z</tt>
: 64-bit Solaris: <tt>gluegen-2.0-bvvv-20yymmdd-solaris-amd64.7z</tt>


= Downloading the latest automatic build =
Then, go to [{{SERVER}}/deployment/autobuilds/master/ this page and click on the most recent <tt>jogl-b*</tt> directory. Then download one of these files for each platform you're developing on:


Every time changes to the JOGL code base are checked in, it starts an [[Jogamp_Versioning_and_Releases#Autobuilds|automatic build and test process]]. The resulting builds are placed at {{SERVER}}/deployment/autobuilds/master/, where you can [[Jogamp_Versioning_and_Releases#Autobuild_Files|download the autobuild files]]. 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>.
: 32-bit Windows: <tt>jogl-2.0-bvvv-20yymmdd-windows-i586.7z</tt>
: 64-bit Windows: <tt>jogl-2.0-bvvv-20yymmdd-windows-amd64.7z</tt>
: 32/64-bit Mac OS X: <tt>jogl-2.0-bvvv-20yymmdd-macosx-universal.7z</tt>
: 32-bit Linux: <tt>jogl-2.0-bvvv-20yymmdd-linux-i586.7z</tt>
: 64-bit Linux: <tt>jogl-2.0-bvvv-20yymmdd-linux-amd64.7z</tt>
: 32-bit Solaris: <tt>jogl-2.0-bvvv-20yymmdd-solaris-i586.7z</tt>
: 64-bit Solaris: <tt>jogl-2.0-bvvv-20yymmdd-solaris-amd64.7z</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/ 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 [https://jogamp.org/chuck/ build server] 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 =


Unzip all downloaded platform ZIP archives (and the API doc's ZIP files) in a common folder.
Unzip all the downloaded files with [http://www.7-zip.org/ 7zip]. An unzipped file has these general contents
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:
<pre>
<pre>
unzip gluegen-2.0-b261-20110202-linux-amd64.zip
&lt;archive&gt;/
mv gluegen-2.0-b261-20110202-linux-amd64 gluegen
&lt;archive&gt;/jar/
&lt;archive&gt;/lib/
&lt;archive&gt;/&lt;module&gt;-java-src.zip*
</pre>


unzip jogl-2.0-b280-20110202-linux-amd64.zip
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.
mv jogl-2.0-b280-20110202-linux-amd64 jogl


unzip gluegen-javadoc.zip
= More information =
unzip jogl-javadoc.zip
 
</pre>
JogAmp follows a [[Jogamp_Versioning_and_Releases#Release_Classification|release scheme]],
which describes the following locations to download the 7z archives from:


Now you have the following structure (the same for all modules):
* [{{SERVER}}/deployment/ Deployment Home]
<pre>
** [{{SERVER}}/deployment/jogamp-current/archive/ Signed Release]
gluegen/
** [{{SERVER}}/deployment/jogamp-next/archive/ Signed Candidate]
gluegen/artifact.properties
** [{{SERVER}}/deployment/jogamp-next/v2.0-rc3archive/ Specific Version]
gluegen/javadoc/
gluegen/jar/
gluegen/lib/
gluegen/jnlp-files/
gluegen/LICENSE
</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.
[{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment] describes the content of the 7z archive files.


This installation contains all of JOGL. If you want to trim it down, see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment] for more information.
These installations contain all of JOGL. If you want to remove parts you don't use, see [{{SERVER}}/jogl/doc/deployment/JOGL-DEPLOYMENT.html JOGL Deployment] for more information.

Revision as of 16:11, 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/.dynlib 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 these general contents

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

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.