Maven And Android - Revision history

Mraynsford: Note 2.0.2

2013-07-22T18:20:01Z

Note 2.0.2

← Older revision		Revision as of 20:20, 22 July 2013
Line 36:		Line 36:
	<groupId>org.jogamp.jogl</groupId>		<groupId>org.jogamp.jogl</groupId>
	<artifactId>jogl-all</artifactId>		<artifactId>jogl-all</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	</dependency>		</dependency>
	</dependencies>		</dependencies>
Line 112:		Line 112:
	<groupId>org.jogamp.gluegen</groupId>		<groupId>org.jogamp.gluegen</groupId>
	<artifactId>gluegen-rt-android</artifactId>		<artifactId>gluegen-rt-android</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	</dependency>		</dependency>
	<!-- Depend on the correct natives for Android -->		<!-- Depend on the correct natives for Android -->
Line 118:		Line 118:
	<groupId>org.jogamp.gluegen</groupId>		<groupId>org.jogamp.gluegen</groupId>
	<artifactId>gluegen-rt</artifactId>		<artifactId>gluegen-rt</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	<classifier>natives-android-armv6</classifier>		<classifier>natives-android-armv6</classifier>
	</dependency>		</dependency>
Line 125:		Line 125:
	<groupId>org.jogamp.jogl</groupId>		<groupId>org.jogamp.jogl</groupId>
	<artifactId>jogl-all-android</artifactId>		<artifactId>jogl-all-android</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	</dependency>		</dependency>
	<!-- Depend on the correct natives for Android -->		<!-- Depend on the correct natives for Android -->
Line 131:		Line 131:
	<groupId>org.jogamp.jogl</groupId>		<groupId>org.jogamp.jogl</groupId>
	<artifactId>jogl-all</artifactId>		<artifactId>jogl-all</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	<classifier>natives-android-armv6</classifier>		<classifier>natives-android-armv6</classifier>
	<scope>runtime</scope>		<scope>runtime</scope>
Line 210:		Line 210:
	<groupId>org.jogamp.jogl</groupId>		<groupId>org.jogamp.jogl</groupId>
	<artifactId>jogl-all</artifactId>		<artifactId>jogl-all</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	<classifier>natives-android-armv6</classifier>		<classifier>natives-android-armv6</classifier>
	<overWrite>true</overWrite>		<overWrite>true</overWrite>
Line 233:		Line 233:
	<groupId>org.jogamp.jogl</groupId>		<groupId>org.jogamp.jogl</groupId>
	<artifactId>jogl-all-android</artifactId>		<artifactId>jogl-all-android</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	<overWrite>true</overWrite>		<overWrite>true</overWrite>
	<outputDirectory>${project.basedir}/assets</outputDirectory>		<outputDirectory>${project.basedir}/assets</outputDirectory>
Line 254:		Line 254:
	<groupId>org.jogamp.gluegen</groupId>		<groupId>org.jogamp.gluegen</groupId>
	<artifactId>gluegen-rt</artifactId>		<artifactId>gluegen-rt</artifactId>
	<version>2.0~~-rc11post03~~</version>		<version>2.0.2</version>
	<classifier>natives-android-armv6</classifier>		<classifier>natives-android-armv6</classifier>
	<overWrite>true</overWrite>		<overWrite>true</overWrite>

Mraynsford: Captions

2013-01-07T15:06:34Z

Captions

← Older revision		Revision as of 17:06, 7 January 2013
Line 356:		Line 356:
	Success		Success
	</pre>		</pre>

			The program running on an ordinary Linux desktop:

	[[File:blue.png\|Highly complex rendering]]		[[File:blue.png\|Highly complex rendering]]

			The program installed on the Android emulator:

	[[File:maven-android-emu1.png\|The installed application]]		[[File:maven-android-emu1.png\|The installed application]]

			The program running on the Android emulator:

	[[File:maven-android-emu2.png\|The running application]]		[[File:maven-android-emu2.png\|The running application]]

Mraynsford: Additional images and command line install

2013-01-07T15:04:58Z

Additional images and command line install

← Older revision		Revision as of 17:04, 7 January 2013
Line 350:		Line 350:
	The <tt>jp4da-android/target</tt> directory now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.		The <tt>jp4da-android/target</tt> directory now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.

			<pre>
			$ adb install jp4da-android/target/jp4da-android.apk
			1026 KB/s (2334537 bytes in 2.221s)
			pkg: /data/local/tmp/jp4da-android.apk
			Success
			</pre>

			[[File:blue.png\|Highly complex rendering]]

	[[File:~~blue~~.png\|~~Highly complex rendering~~]]		[[File:maven-android-emu1.png\|The installed application]]

			[[File:maven-android-emu2.png\|The running application]]

Mraynsford: /* Excluding redundant files */

2013-01-07T15:01:06Z

Excluding redundant files

← Older revision		Revision as of 17:01, 7 January 2013
Line 166:		Line 166:
	<configuration>		<configuration>
	<sdk>		<sdk>
	<platform>9</platform>		<platform>10</platform>
	</sdk>		</sdk>
	</configuration>		</configuration>

Mraynsford: /* Excluding redundant files */

2013-01-07T13:57:10Z

Excluding redundant files

← Older revision		Revision as of 15:57, 7 January 2013
Line 166:		Line 166:
	<configuration>		<configuration>
	<sdk>		<sdk>
	<platform>8</platform>		<platform>9</platform>
	</sdk>		</sdk>
	</configuration>		</configuration>

Mraynsford: Missed a word

2013-01-05T14:13:58Z

Missed a word

← Older revision		Revision as of 16:13, 5 January 2013
Line 348:		Line 348:
	</pre>		</pre>

	The <tt>jp4da-android/target</tt> now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.		The <tt>jp4da-android/target</tt> directory now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.



	[[File:blue.png\|Highly complex rendering]]		[[File:blue.png\|Highly complex rendering]]

Mraynsford: Missed a word

2013-01-05T14:13:20Z

Missed a word

← Older revision		Revision as of 16:13, 5 January 2013
Line 69:		Line 69:
	=== Dependencies ===		=== Dependencies ===

	For running code on Android, JOGL provides separate <tt>jogl-all-android</tt> and <tt>gluegen-rt-android</tt> jar files. However, this is where the first problem arises due to Maven's [http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html transitive dependency handling]: The <tt>jp4da-android</tt> project depends on <tt>jp4da-core</tt> which depends on <tt>jogl-all</tt>. The <tt>jp4da-android</tt> will therefore also implicitly depend on <tt>jogl-all</tt>, which will now conflict with <tt>jogl-all-android</tt>!		For running code on Android, JOGL provides separate <tt>jogl-all-android</tt> and <tt>gluegen-rt-android</tt> jar files. However, this is where the first problem arises due to Maven's [http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html transitive dependency handling]: The <tt>jp4da-android</tt> project depends on <tt>jp4da-core</tt> which depends on <tt>jogl-all</tt>. The <tt>jp4da-android</tt> module will therefore also implicitly depend on <tt>jogl-all</tt>, which will now conflict with <tt>jogl-all-android</tt>!

	There are two accepted methods to handle this problem:		There are two accepted methods to handle this problem:

Mraynsford: Eliminate commas

2013-01-05T01:18:31Z

Eliminate commas

← Older revision		Revision as of 03:18, 5 January 2013
Line 146:		Line 146:
	=== Excluding redundant files ===		=== Excluding redundant files ===

	So, firstly, the Android Maven plugin needs to be told not to include anything from the JOGL and GlueGen jar files. This is achieved by giving a regular expression, against which the names of each jar file on the classpath will be tested. If a jar file is matched, then the contents of the jar file are ''not'' included in the resulting APK. Essentially, specific jar files are blacklisted.		So, firstly, the Android Maven plugin needs to be told not to include anything from the JOGL and GlueGen jar files. This is achieved by giving a regular expression against which the names of each jar file on the classpath will be tested. If a jar file is matched then the contents of the jar file are ''not'' included in the resulting APK. Essentially, specific jar files are blacklisted.

	<pre>		<pre>

Mraynsford: Missed a word

2013-01-05T01:16:11Z

Missed a word

← Older revision		Revision as of 03:16, 5 January 2013
Line 74:		Line 74:

	* Make <tt>jogl-all</tt> an [http://maven.apache.org/guides/introduction/introduction-to-optional-and-excludes-dependencies.html#Optional_Dependencies optional dependency] of the <tt>jp4da-core</tt> project. It is then the responsibility of <tt>jp4da-android</tt> to provide a dependency that satisfies all constraints. Or:		* Make <tt>jogl-all</tt> an [http://maven.apache.org/guides/introduction/introduction-to-optional-and-excludes-dependencies.html#Optional_Dependencies optional dependency] of the <tt>jp4da-core</tt> project. It is then the responsibility of <tt>jp4da-android</tt> to provide a dependency that satisfies all constraints. Or:
	* Have the <tt>jp4da-android</tt> explicitly ignore the <tt>jogl-all</tt> dependency of <tt>jp4da-core</tt>.		* Have the <tt>jp4da-android</tt> module explicitly ignore the <tt>jogl-all</tt> dependency of <tt>jp4da-core</tt>.

	Neither method has any particular advantages or disadvantages in this case, so in the interest of keeping things explicit, the second method was chosen. The <tt>jp4da-android</tt> module explicitly ignores the <tt>jogl-all</tt> dependency and provides its own instead:		Neither method has any particular advantages or disadvantages in this case, so in the interest of keeping things explicit, the second method was chosen. The <tt>jp4da-android</tt> module explicitly ignores the <tt>jogl-all</tt> dependency and provides its own instead:

Mraynsford: /* Building */

2013-01-05T01:08:16Z

Building

← Older revision		Revision as of 03:08, 5 January 2013
Line 349:		Line 349:

	The <tt>jp4da-android/target</tt> now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.		The <tt>jp4da-android/target</tt> now contains a <tt>jp4da-android.apk</tt> file that can be installed onto devices or the Android emulator.



			[[File:blue.png\|Highly complex rendering]]