Building JOGL on the command line - Revision history

Xranby: /* Pull the JOGL source code from GitHub or JogAmp */ add --recurse-submodules

2015-10-10T13:02:56Z

Pull the JOGL source code from GitHub or JogAmp: add --recurse-submodules

← Older revision		Revision as of 15:02, 10 October 2015
Line 125:		Line 125:

	* Open a shell and cd to where you want the code to go.		* Open a shell and cd to where you want the code to go.
	* Type <tt>git clone git://github.com/sgothel/gluegen.git gluegen</tt> and wait for the code to download.		* Type <tt>git clone --recurse-submodules git://github.com/sgothel/gluegen.git gluegen</tt> and wait for the code to download.
	* Type <tt>git clone git://github.com/sgothel/jogl.git jogl</tt> and wait for the code to download.		* Type <tt>git clone --recurse-submodules git://github.com/sgothel/jogl.git jogl</tt> and wait for the code to download.

	If you wish, you can clone from <tt>git://jogamp.com/srv/scm</tt> instead of <tt>git://github.com/sgothel</tt>. The contents of the two repositories should be the same.		If you wish, you can clone from <tt>git://jogamp.com/srv/scm</tt> instead of <tt>git://github.com/sgothel</tt>. The contents of the two repositories should be the same.

Sgothel: /* Install MinGW (Windows only) */

2013-08-31T17:50:29Z

Install MinGW (Windows only)

← Older revision		Revision as of 19:50, 31 August 2013
Line 76:		Line 76:
	For the JOGL build scripts to run on Windows, you'll need Minimalist GNU for Windows (MinGW) so you can use the GCC compiler.		For the JOGL build scripts to run on Windows, you'll need Minimalist GNU for Windows (MinGW) so you can use the GCC compiler.

	We have to use MinGW64 not for the 64bit build ~~as well as~~ for the 32bit build,		We have to use MinGW64 not just for the 64bit build, but for the 32bit build as well.
	~~homepage~~ http://mingw-w64.sourceforge.net.		Homepage is http://mingw-w64.sourceforge.net.

	MinGW64 is deployed in different configurations, the following lists		MinGW64 is deployed in different configurations, the following lists

Sgothel at 06:02, 31 August 2013

2013-08-31T06:02:32Z

← Older revision		Revision as of 08:02, 31 August 2013
Line 2:		Line 2:

	To build JOGL on the command line, we'll need to install prerequisites like Ant, pull the code from a Git repository, and run the Ant build scripts.		To build JOGL on the command line, we'll need to install prerequisites like Ant, pull the code from a Git repository, and run the Ant build scripts.

			Note: A static html version exists in the JOGL project ''doc'' folder, [{{SERVER}}/jogl/doc/HowToBuild.html see].

	= Supported platforms =		= Supported platforms =

Sgothel: /* Install MinGW (Windows only) */

2013-08-31T06:00:31Z

Install MinGW (Windows only)

← Older revision		Revision as of 08:00, 31 August 2013
Line 70:		Line 70:
	* Test your Git installation by opening a new shell and typing <tt>git --version</tt>		* Test your Git installation by opening a new shell and typing <tt>git --version</tt>

	= Install MinGW (Windows only) =		= Install MinGW (''Windows'' only) =

	For the JOGL build scripts to run on Windows, you'll need Minimalist GNU for Windows (MinGW) so you can use the GCC compiler.		For the JOGL build scripts to run on Windows, you'll need Minimalist GNU for Windows (MinGW) so you can use the GCC compiler.

	* ~~Create a~~ <tt>C:\MinGW</tt> ~~directory~~.		We have to use MinGW64 not for the 64bit build as well as for the 32bit build,
			homepage http://mingw-w64.sourceforge.net.

			MinGW64 is deployed in different configurations, the following lists
			the version we use:
			* version: 4.8.1
			* threading: win32
			* exceptions: SJLJ
			* revision: 5

			== ''Windows'' /x86 (32 bit) ==
			* Manual Installation
			** Download from http://sourceforge.net/projects/mingwbuilds/files/host-windows/releases/, i.e.
			http://sourceforge.net/projects/mingwbuilds/files/host-windows/releases/4.8.1/32-bit/threads-win32/sjlj/
			** Unzip using 7zip into <tt> C:\ </tt> and rename folder <tt>C:\MinGW32</tt> to <tt>C:\MinGW</tt>
			* UI Installation
			** Download the installer http://sourceforge.net/projects/mingwbuilds/files/mingw-builds-install/mingw-builds-install.exe/download
			** Chose options as described above plus ''host x32'' for 32bit host
			** Install ..
			** Copy the including <tt> MinGW32 </tt> folder to become <tt> C:\MinGW</tt>
	* Append <tt>;C:\MinGW\bin</tt> to the end of your Path environment variable.		* Append <tt>;C:\MinGW\bin</tt> to the end of your Path environment variable.
	* ~~32-bit Windows:~~ Download ~~the installer~~ from http://sourceforge.net/projects/~~mingw~~/files/~~Installer~~/~~mingw-get~~/ ~~into the new MinGW directory~~.
	** For example, version mingw-~~get-0~~.~~5-beta-20120426-~~1 ~~is in a file called <tt>mingw~~-~~get~~-~~0.5-mingw32-beta-20120426-1-bin.zip<~~/~~tt>~~		== ''Windows'' /x86_64 (64 bit) ==
	** Unzip ~~the file.~~		* Manual Installation
	*** The <tt>~~bin~~</tt>, ~~<tt>libexec</tt>, and <tt>var</tt> directories~~ should be ~~directly inside~~ <tt>C:\~~MinGW~~</tt>		** Download from http://sourceforge.net/projects/mingwbuilds/files/host-windows/releases/, i.e.
	** Open new shell and type <tt>mingw-get install gcc</tt>		http://sourceforge.net/projects/mingwbuilds/files/host-windows/releases/4.8.1/64-bit/threads-win32/sjlj/
	*** This may take a few minutes to download and install the rest of 32-bit gcc.		** Unzip using 7zip into <tt> C:\ </tt>, new folder should be named <tt>C:\MinGW64</tt>
	* 64-bit Windows: Download the ~~zipped installation from~~ http://sourceforge.net/projects/~~mingw-w64~~/files/~~Toolchains%20targetting%20Win64/Personal%20Builds~~/ ~~into the new MinGW directory.~~		* UI Installation
	** For example, version sezero_4.5_20111101 is in a file called <tt>mingw-~~w64~~-~~bin_x86_64-mingw_20111101_sezero~~.~~zip<~~/~~tt>~~		** Download the installer http://sourceforge.net/projects/mingwbuilds/files/mingw-builds-install/mingw-builds-install.exe/download
	** ~~Unzip the file~~.		** Chose options as described above plus ''host x64'' for 32bit host
	** ~~The~~ <tt>~~bin~~</tt>, <tt>~~libexec~~</tt>~~, <tt>lib64</tt>, and other directories should be directly inside~~ <tt>C:\~~MinGW~~</tt>		** Install ..
	** No further installation is needed for the ~~64-bit version~~.		** Copy the including <tt> MinGW64 </tt> folder to become <tt>C:\MinGW64</tt>
	* Test your MinGW installation by opening a new shell and typing <tt>gcc --version</tt>		* Append <tt>;C:\MinGW64\bin</tt> to the end of your Path environment variable.

			Now you may test your MinGW installation by opening a new shell and typing <tt>gcc --version</tt>

	= Check and install developer packages (Linux and Solaris only) =		= Check and install developer packages (Linux and Solaris only) =

Wwalker: Fixed instructions for 64-bit Windows MinGW

2013-04-13T20:25:38Z

Fixed instructions for 64-bit Windows MinGW

← Older revision		Revision as of 22:25, 13 April 2013
Line 75:		Line 75:

	* Create a <tt>C:\MinGW</tt> directory.		* Create a <tt>C:\MinGW</tt> directory.
	* Download the installer from http://sourceforge.net/projects/mingw/files/Installer/mingw-get/ into the new MinGW directory.
	** For example, version mingw-get-0.4-alpha-1 is in a file called <tt>mingw-get-0.4-mingw32-alpha-1-bin.zip</tt>
	* Extract the installer file.
	** The <tt>bin</tt>, <tt>libexec</tt>, and <tt>var</tt> directories should be directly inside <tt>C:\MinGW</tt>
	* Append <tt>;C:\MinGW\bin</tt> to the end of your Path environment variable.		* Append <tt>;C:\MinGW\bin</tt> to the end of your Path environment variable.
	* Open new shell and type <tt>mingw-get install gcc</tt>		* 32-bit Windows: Download the installer from http://sourceforge.net/projects/mingw/files/Installer/mingw-get/ into the new MinGW directory.
	** This may take a few minutes to download and install the rest of MinGW.		** For example, version mingw-get-0.5-beta-20120426-1 is in a file called <tt>mingw-get-0.5-mingw32-beta-20120426-1-bin.zip</tt>
			** Unzip the file.
			*** The <tt>bin</tt>, <tt>libexec</tt>, and <tt>var</tt> directories should be directly inside <tt>C:\MinGW</tt>
			** Open new shell and type <tt>mingw-get install gcc</tt>
			*** This may take a few minutes to download and install the rest of 32-bit gcc.
			* 64-bit Windows: Download the zipped installation from http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/ into the new MinGW directory.
			** For example, version sezero_4.5_20111101 is in a file called <tt>mingw-w64-bin_x86_64-mingw_20111101_sezero.zip</tt>
			** Unzip the file.
			** The <tt>bin</tt>, <tt>libexec</tt>, <tt>lib64</tt>, and other directories should be directly inside <tt>C:\MinGW</tt>
			** No further installation is needed for the 64-bit version.
	* Test your MinGW installation by opening a new shell and typing <tt>gcc --version</tt>		* Test your MinGW installation by opening a new shell and typing <tt>gcc --version</tt>

Wwalker: Added Mac JDK 7 paths

2013-02-12T21:57:57Z

Added Mac JDK 7 paths

Wwalker: Removed periods

2011-11-17T15:33:01Z

Removed periods

← Older revision		Revision as of 17:33, 17 November 2011
Line 126:		Line 126:
	Before runing the tests, make sure the Z-Zip file archiver is installed.		Before runing the tests, make sure the Z-Zip file archiver is installed.
	* If you don't have it, download the latest version from http://www.7-zip.org/ and install it.		* If you don't have it, download the latest version from http://www.7-zip.org/ and install it.
	* Make sure <tt>7z</tt> is visible ~~from~~ a command shell.		* Make sure <tt>7z</tt> is visible in a command shell.
	** On Windows, append <tt>;C:\Program Files\7-Zip</tt> to your PATH environment variable.		** On Windows, append <tt>;C:\Program Files\7-Zip</tt> to your PATH environment variable.
	* Test 7-Zip by opening a new shell and typing <tt>7z</tt>		* Test 7-Zip by opening a new shell and typing <tt>7z</tt>

	Then to run the full suite of JUnit tests:		Then to run the full suite of JUnit tests:
	* For gluegen, cd to <tt>gluegen/make</tt> and type <tt>ant junit.run</tt>.		* For gluegen, cd to <tt>gluegen/make</tt> and type <tt>ant junit.run</tt>
	* For jogl, cd to <tt>jogl/make</tt> and type <tt>ant junit.run</tt>.		* For jogl, cd to <tt>jogl/make</tt> and type <tt>ant junit.run</tt>

	= Build Javadoc (optional) =		= Build Javadoc (optional) =

Wwalker: Minor edit to 7zip

2011-11-17T15:29:12Z

Minor edit to 7zip

← Older revision		Revision as of 17:29, 17 November 2011
Line 124:		Line 124:
	= Test the JOGL build =		= Test the JOGL build =

	Before runing the tests, ~~first install~~ the Z-Zip file archiver.		Before runing the tests, make sure the Z-Zip file archiver is installed.
	* ~~Download~~ the latest version from http://www.7-zip.org/ and install it.		* If you don't have it, download the latest version from http://www.7-zip.org/ and install it.
	* Make sure <tt>7z</tt> is visible from a command shell.		* Make sure <tt>7z</tt> is visible from a command shell.
	** On Windows, append <tt>;C:\Program Files\7-Zip</tt> to your PATH environment variable.		** On Windows, append <tt>;C:\Program Files\7-Zip</tt> to your PATH environment variable.

Wwalker: Added info about 7z (now needed to run the JUnit tests)

2011-11-17T15:28:27Z

Added info about 7z (now needed to run the JUnit tests)

← Older revision		Revision as of 17:28, 17 November 2011
Line 124:		Line 124:
	= Test the JOGL build =		= Test the JOGL build =

	~~To test~~ the ~~build~~, cd to <tt>~~jogl~~/make</tt> and type <tt>ant junit.run</tt>. ~~This will~~ run ~~the full suite of JUnit tests~~.		Before runing the tests, first install the Z-Zip file archiver.
			* Download the latest version from http://www.7-zip.org/ and install it.
			* Make sure <tt>7z</tt> is visible from a command shell.
			** On Windows, append <tt>;C:\Program Files\7-Zip</tt> to your PATH environment variable.
			* Test 7-Zip by opening a new shell and typing <tt>7z</tt>

			Then to run the full suite of JUnit tests:
			* For gluegen, cd to <tt>gluegen/make</tt> and type <tt>ant junit.run</tt>.
			* For jogl, cd to <tt>jogl/make</tt> and type <tt>ant junit.run</tt>.

	= Build Javadoc (optional) =		= Build Javadoc (optional) =

Wwalker: Updated MinGW installation links

2011-11-17T14:36:39Z

Updated MinGW installation links

← Older revision		Revision as of 16:36, 17 November 2011
Line 75:		Line 75:

	* Create a <tt>C:\MinGW</tt> directory.		* Create a <tt>C:\MinGW</tt> directory.
	* Download the installer from http://sourceforge.net/projects/mingw/files/~~Automated%20MinGW%20Installer~~/mingw-get/ into the new directory.		* Download the installer from http://sourceforge.net/projects/mingw/files/Installer/mingw-get/ into the new MinGW directory.
	** For example, version mingw-get-0.1-alpha-5 is in a file called <tt>mingw-get-0.1-mingw32-alpha-5-bin.zip</tt>		** For example, version mingw-get-0.4-alpha-1 is in a file called <tt>mingw-get-0.4-mingw32-alpha-1-bin.zip</tt>
	* Extract the installer file.		* Extract the installer file.
	** The <tt>bin</tt>, <tt>libexec</tt>, and <tt>var</tt> directories should be directly inside <tt>C:\MinGW</tt>		** The <tt>bin</tt>, <tt>libexec</tt>, and <tt>var</tt> directories should be directly inside <tt>C:\MinGW</tt>

← Older revision		Revision as of 23:57, 12 February 2013
Line 14:		Line 14:
	** You must use a JDK, not a JRE, because Ant needs <tt>bin/javac</tt>, which doesn't come in the JRE. On Windows and Linux, Ant also needs <tt>lib/tools.jar</tt>, which doesn't come in the JRE.		** You must use a JDK, not a JRE, because Ant needs <tt>bin/javac</tt>, which doesn't come in the JRE. On Windows and Linux, Ant also needs <tt>lib/tools.jar</tt>, which doesn't come in the JRE.
	** On Windows and Linux, if you've got some kind of Java installed, but you're not sure whether it's a JDK or a Java Runtime Environment (JRE), look inside the directory. If it's got a <tt>jre</tt> subdirectory inside, it's a JDK. A JRE contains only <tt>bin</tt> and <tt>lib</tt> directories.		** On Windows and Linux, if you've got some kind of Java installed, but you're not sure whether it's a JDK or a Java Runtime Environment (JRE), look inside the directory. If it's got a <tt>jre</tt> subdirectory inside, it's a JDK. A JRE contains only <tt>bin</tt> and <tt>lib</tt> directories.
	** On Mac OS X, Apple's JDK ~~ships~~ with the operating system. It ~~should~~ be at <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk</tt>.		** On Mac OS X, Apple's JDK 6 may be included with the operating system, depending on what version you're running. It would be at <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk</tt>. If you want to use Java 7, you'll need to install that yourself (see below).
	* Get a JDK if needed		* Get a JDK if needed
	** On Windows and Linux, download the JDK from at http://www.oracle.com/technetwork/java/javase/downloads/index.html. Make sure you get Java SE 6 update 24 or later. You can install the JDK wherever you like.		** On Windows and Linux, download the JDK from at http://www.oracle.com/technetwork/java/javase/downloads/index.html. Make sure you get Java SE 6 update 24 or later. You can install the JDK wherever you like.
	** On Mac OS X, click "Apple menu > Software update..." to update Apple's JDK.		** On Mac OS X, for Java 7 and later, you can download it from http://www.oracle.com/technetwork/java/javase/downloads/index.html just like on Windows and Linux. If you're using Apple's JDK 6, click "Apple menu > Software update..." to update Apple's JDK.
	* Add the JDK's <tt>bin</tt> directory to your path.		* Add the JDK's <tt>bin</tt> directory to your path.
	** On Windows, append <tt>;your JDK\bin</tt> to your Path environment variable.		** On Windows, append <tt>;your JDK\bin</tt> to your Path environment variable.
	** On Linux, append <tt>:your JDK/bin</tt> to your PATH environment variable.		** On Linux, append <tt>:your JDK/bin</tt> to your PATH environment variable.
	** On Mac OS X, prepend <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home/bin:</tt> to your PATH environment variable.		** On Mac OS X, prepend <tt>/Library/Java/JavaVirtualMachines/jdk1.7.x_x.jdk/Contents/Home/bin:</tt> (or <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home/bin:</tt> for Apple's JDK 6) to your PATH environment variable.
	* Set the <tt>JAVA_HOME</tt> environment variable		* Set the <tt>JAVA_HOME</tt> environment variable
	** On Windows and Linux, set the <tt>JAVA_HOME</tt> environment variable to your JDK path.		** On Windows and Linux, set the <tt>JAVA_HOME</tt> environment variable to your JDK path.
	** On Mac OS X, set <tt>JAVA_HOME</tt> to <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home</tt>		** On Mac OS X, set <tt>JAVA_HOME</tt> to <tt>/Library/Java/JavaVirtualMachines/jdk1.7.x_x.jdk/Contents/Home</tt> (or <tt>/System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home</tt> for Apple's JDK 6).
	* Test your JDK by opening a shell and typing <tt>java -version</tt> and <tt>javac -version</tt>		* Test your JDK by opening a shell and typing <tt>java -version</tt> and <tt>javac -version</tt>