AIInterface:Java - Revision history

Flozi: 1cat

2013-03-20T17:53:58Z

1cat

← Older revision		Revision as of 18:53, 20 March 2013
Line 110:		Line 110:
	''' [[AIs\|<- Back to AI page]]'''		''' [[AIs\|<- Back to AI page]]'''

	~~[[Category: AI]]~~
	[[Category: AIInterface]]		[[Category: AIInterface]]
	~~[[Category: Development]]~~

Hoijui at 22:23, 3 March 2010

2010-03-03T22:23:01Z

← Older revision		Revision as of 23:23, 3 March 2010
Line 8:		Line 8:

	==== Description ====		==== Description ====
	This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java, or any of the other [http://en.wikipedia.org/wiki/Java_Virtual_Machine languages supported by the JVM], like [http://en.wikipedia.org/wiki/Java_%28programming_language%29 Java], [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy], [http://en.wikipedia.org/wiki/JRuby JRuby], [http://en.wikipedia.org/wiki/Jython Jython], [http://en.wikipedia.org/wiki/Scala_%28programming_language%29 Scala] or [http://en.wikipedia.org/wiki/Clojure Clojure]. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/springrts/ai/AI.java'').		This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java, or any of the other [http://en.wikipedia.org/wiki/Java_Virtual_Machine languages supported by the JVM] like [http://en.wikipedia.org/wiki/Java_%28programming_language%29 Java], [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy], [http://en.wikipedia.org/wiki/JRuby JRuby], [http://en.wikipedia.org/wiki/Jython Jython], [http://en.wikipedia.org/wiki/Scala_%28programming_language%29 Scala] or [http://en.wikipedia.org/wiki/Clojure Clojure]. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/springrts/ai/AI.java'').

	For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>		For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>

Hoijui: /* Bugs */

2010-03-03T22:21:13Z

Bugs

← Older revision		Revision as of 23:21, 3 March 2010
Line 42:		Line 42:
	==== Bugs ====		==== Bugs ====
	'''Known Crashes:'''		'''Known Crashes:'''
	* When natively debugging (eg with GDB), you may get random ~~SIGSEGVs~~/segmentation ~~faults~~ when using Java AIs. This is due to the JVM using SIGSEGV as a signal for garbage collection. There are two workarounds:		* When natively debugging (eg with GDB), you may get random ''SIGSEGV''s/''segmentation fault''s when using Java AIs. This is due to the JVM using ''SIGSEGV'' as a signal for garbage collection. There are two workarounds:
	** '''recommended''': ~~ussue~~ a ''continue'' in your native debugger; if spring continues normally, it was a JVM garbage collection SIGSEGV		** '''recommended''': issue a ''continue'' in your native debugger; if spring continues normally, it was a JVM garbage collection ''SIGSEGV''
	** use the JVM without JIT (Just In Time compilation), as the JVM does not use SIGSEGVs in this mode.		** use the JVM without JIT (Just In Time compilation), as the JVM does not use ''SIGSEGVs'' in this mode. This will make cause additional run-time CPU usage.

	Please report bugs under		Please report bugs under
	[http://springrts.com/mantis/ Mantis]		[http://springrts.com/mantis/ Mantis]
	to the AI ~~subproject~~.		to the AI sub-project.

	==== How to compile ====		==== How to compile ====

Hoijui: /* Source */

2010-03-03T22:18:48Z

Source

← Older revision		Revision as of 23:18, 3 March 2010
Line 35:		Line 35:

	==== Source ====		==== Source ====
	The source can be found under:		The source can be found under ''{spring_source}/AI/Interface/Java/''.
	''{spring_source}/AI/Interface/Java/''		Not all the Java source files are available under this directory,
	Not all the Java source files are available under this ~~dir~~,
	as a big part of them are generated during the build process, and are therefore only available when you generate them yourself, or in the AIInterface-src.jar in		as a big part of them are generated during the build process, and are therefore only available when you generate them yourself, or in the AIInterface-src.jar in
	your spring installation.		your spring installation.

Hoijui: stress JVM langauges instead of Java only

2010-03-03T22:17:58Z

stress JVM langauges instead of Java only

← Older revision		Revision as of 23:17, 3 March 2010
Line 1:		Line 1:
	{{AIInterface\|Java\|hoijui\|0.1\|~~Java~~\|~stable\|GNU GPL v2+}}		{{AIInterface\|Java\|hoijui\|0.1\|[http://en.wikipedia.org/wiki/Java_Virtual_Machine JVM languages]\|~stable\|GNU GPL v2+}}

	== Java AI Interface Wrapper ==		== Java AI Interface Wrapper ==
Line 8:		Line 8:

	==== Description ====		==== Description ====
	This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/springrts/ai/AI.java'').		This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java, or any of the other [http://en.wikipedia.org/wiki/Java_Virtual_Machine languages supported by the JVM], like [http://en.wikipedia.org/wiki/Java_%28programming_language%29 Java], [http://en.wikipedia.org/wiki/Groovy_%28programming_language%29 Groovy], [http://en.wikipedia.org/wiki/JRuby JRuby], [http://en.wikipedia.org/wiki/Jython Jython], [http://en.wikipedia.org/wiki/Scala_%28programming_language%29 Scala] or [http://en.wikipedia.org/wiki/Clojure Clojure]. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/springrts/ai/AI.java'').

	For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>		For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>

Hoijui: package name updated

2009-06-27T11:10:50Z

package name updated

← Older revision		Revision as of 12:10, 27 June 2009
Line 8:		Line 8:

	==== Description ====		==== Description ====
	This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/~~clan_sy/spring~~/ai/AI.java'').		This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/springrts/ai/AI.java'').

	For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>		For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>

Hoijui at 08:49, 8 June 2009

2009-06-08T08:49:06Z

← Older revision		Revision as of 09:49, 8 June 2009
Line 1:		Line 1:
	{{AIInterface\|Java\|hoijui\|0.1 ~~(spring GIT)~~\|Java\|~~beta~~\|GNU GPL v2+}}		{{AIInterface\|Java\|hoijui\|0.1\|Java\|~stable\|GNU GPL v2+}}

	=== Forum threads ===		== Java AI Interface Wrapper ==

			==== Forum threads ====
	*[http://spring.clan-sy.com/phpbb/viewtopic.php?f=15&t=12308 Java AI Interface for Spring]		*[http://spring.clan-sy.com/phpbb/viewtopic.php?f=15&t=12308 Java AI Interface for Spring]
	*[http://spring.clan-sy.com/phpbb/viewtopic.php?f=15&t=15019 AI Interface redesign (in C)]		*[http://spring.clan-sy.com/phpbb/viewtopic.php?f=15&t=15019 AI Interface redesign (in C)]

	=== Description ===		==== Description ====
	This AI ~~interface~~ is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/clan_sy/spring/ai/AI.java'').		This AI Interface is written in C, Java and AWK, and heavily relies on JNI and JNA. It allows spring to load AIs written in Java. These AIs consist of a ''.jar'' file, which contains at least one class that implements the interface (see ''{spring_source}/AI/Interfaces/Java/java/src/com/clan_sy/spring/ai/AI.java'').

	~~The source of this AI interface library can be found here~~: ''~~{spring_source}/~~AI~~/Interfaces/Java/~~''~~. It is only available in the caiinterface branch of the spring repository directory at the moment.~~		For reference only: '''[[AI:JAI\|JAI]]''' <font color="red">DEPRECATED</font>

	~~For reference only: '''[[AI:JAI\|JAI]]'''~~ (~~DEPRECATED~~)		==== AIs using it ====
			(as of January 2009)

	~~=== AIs using it ===~~
	~~(as of January 2009)~~
	Skirmish AIs:		Skirmish AIs:
	* '''[[AI:NullJavaAI\|NullJavaAI]]'''~~<br>~~		* '''[[AI:NullJavaAI\|NullJavaAI]]'''
	* '''[[AI:NullOOJavaAI\|NullOOJavaAI]]'''		* '''[[AI:NullOOJavaAI\|NullOOJavaAI]]'''

	=~~== Download ===~~		==== Supported Platforms ====
	~~It comes with spring source, current development version (GIT branch ''caiinterface''), reffer to [[Building_spring#Obtaining_the_Source\|Obtaining the Source]].~~

	=== Supported Platforms ===
	As this interface uses JNA, it is limited to the platforms where it is available:		As this interface uses JNA, it is limited to the platforms where it is available:
	(as of Jan 2009)		(as of Jan 2009)
Line 33:		Line 31:
	this should not cause any problems at all.		this should not cause any problems at all.

	=== Download ===		==== Download ====
	It is only available in the ''~~caiinterface~~'' ~~branch of the spring repository at the moment~~ (~~January 2009~~). ~~Refer~~ to ~~[[Building_spring#Obtaining_the_Source\|Obtaining~~ the ~~Source]], and replace~~ ''~~master~~'' ~~with~~ ''~~caiinterface~~''.		It comes with a spring default install.

			==== Source ====
			The source can be found under:
			''{spring_source}/AI/Interface/Java/''
			Not all the Java source files are available under this dir,
			as a big part of them are generated during the build process, and are therefore only available when you generate them yourself, or in the AIInterface-src.jar in
			your spring installation.

			==== Bugs ====
			'''Known Crashes:'''
			* When natively debugging (eg with GDB), you may get random SIGSEGVs/segmentation faults when using Java AIs. This is due to the JVM using SIGSEGV as a signal for garbage collection. There are two workarounds:
			** '''recommended''': ussue a ''continue'' in your native debugger; if spring continues normally, it was a JVM garbage collection SIGSEGV
			** use the JVM without JIT (Just In Time compilation), as the JVM does not use SIGSEGVs in this mode.

			Please report bugs under
			[http://springrts.com/mantis/ Mantis]
			to the AI subproject.

	~~It will come with spring soon.~~		==== How to compile ====
			Make sure your Env-Vars are set like this (replace absolute paths according to your system):

	==~~= Known Crashes ===~~		''Windows:''<br>
	* None		<code>
			SET JAVA_HOME=C:/Program Files/Java/jdk1.6.0
			</code>

			''Linux:'' (you may want to place this in your ''~/.profile'' file)<br>
			<code>
			export JAVA_HOME=/usr/jdk1.6.0
			</code>

	~~=== How to compile ===~~
	'''The easy way'''<br>		'''The easy way'''<br>
	Use Scons or CMake (refer to [[Building_spring\|Building spring]]).		Use Scons or CMake (refer to [[Building_spring\|Building spring]]).
Line 62:		Line 84:
	* Or use the ant build script at: ''{spring_source}/AI/Interfaces/Java/bin/build.xml''		* Or use the ant build script at: ''{spring_source}/AI/Interfaces/Java/bin/build.xml''

	=== How to install/use ===		==== How to install/use ====
	Additional software you need to have installed to be able to use Java AIs:		Additional software you need to have installed to be able to use Java AIs:
	* [http://www.java.com/de/download/ Java Runtime Environment v1.5.0+ (tested with 1.6.0)]		* [http://www.java.com/de/download/ Java Runtime Environment v1.5.0+ (tested with 1.6.0)]

	Make sure your Env-Vars are set like this (replace absolute paths):		Make sure your Env-Vars are set like this (replace absolute paths according to your system):

	''Windows:''<br>		''Windows:''<br>
	<code>		<code>
	SET JAVA_HOME=C:/Program Files/Java/jre1.6.~~0_05<br>~~		SET JAVA_HOME=C:/Program Files/Java/jre1.6.0
	~~SET PATH=%JAVA_HOME%/bin;%JAVA_HOME%/bin/client;%PATH%~~
	</code>		</code>

	''Linux:''<br>		''Linux:'' (you may want to place this in your ''~/.profile'' file)<br>
	<code>		<code>
	export JAVA_HOME=/usr/jre1.6.~~0_10<br>~~		export JAVA_HOME=/usr/jre1.6.0
	~~export PATH=$JAVA_HOME/bin:$JAVA_HOME/bin/client:$PATH~~
	</code>		</code>

Line 90:		Line 110:

	''' [[AIs\|<- Back to AI page]]'''		''' [[AIs\|<- Back to AI page]]'''
	[[Category:AIInterface]]
			[[Category: AI]]
			[[Category: AIInterface]]
			[[Category: Development]]

Hoijui at 08:06, 15 January 2009

2009-01-15T08:06:55Z

← Older revision		Revision as of 09:06, 15 January 2009
Line 19:		Line 19:

	=== Download ===		=== Download ===
	It comes with spring current ~~dev~~ version (GIT branch ''caiinterface'').		It comes with spring source, current development version (GIT branch ''caiinterface''), reffer to [[Building_spring#Obtaining_the_Source\|Obtaining the Source]].

	=== Supported Platforms ===		=== Supported Platforms ===

Hoijui at 14:49, 14 January 2009

2009-01-14T14:49:04Z

← Older revision		Revision as of 15:49, 14 January 2009
Line 86:		Line 86:
	from: ''{spring_source}/AI/Interfaces/Java/''<br>		from: ''{spring_source}/AI/Interfaces/Java/''<br>
	to: ''{spring_data_dir}/AI/Interfaces/Java/{Java-AIInterface-version}/''		to: ''{spring_data_dir}/AI/Interfaces/Java/{Java-AIInterface-version}/''
	* copy ''lib.so'', ''lib.dylib'' or ''*.dll'' to .		* copy ''lib.so'', ''lib.dylib'' or ''*.dll'' to ''./''
	* copy ''data/*'' to .		* copy ''data/*'' to ''./''

	''' [[AIs\|<- Back to AI page]]'''		''' [[AIs\|<- Back to AI page]]'''
	[[Category:AIInterface]]		[[Category:AIInterface]]

Hoijui at 14:47, 14 January 2009

2009-01-14T14:47:51Z

← Older revision		Revision as of 15:47, 14 January 2009
Line 12:		Line 12:
	For reference only: '''[[AI:JAI\|JAI]]''' (DEPRECATED)		For reference only: '''[[AI:JAI\|JAI]]''' (DEPRECATED)

	=== ~~Used By~~ ===		=== AIs using it ===
	(as of January 2009)		(as of January 2009)
	Skirmish AIs:		Skirmish AIs:
	* '''[[AI:NullJavaAI\|NullJavaAI]]'''<br>		* '''[[AI:NullJavaAI\|NullJavaAI]]'''<br>
	* '''[[AI:NullOOJavaAI\|NullOOJavaAI]]'''		* '''[[AI:NullOOJavaAI\|NullOOJavaAI]]'''

			=== Download ===
			It comes with spring current dev version (GIT branch ''caiinterface'').

	=== Supported Platforms ===		=== Supported Platforms ===
Line 39:		Line 42:

	=== How to compile ===		=== How to compile ===
	'''The easy way'''		'''The easy way'''<br>
	Use Scons or CMake (refer to [[Building_spring\|Building spring]]).		Use Scons or CMake (refer to [[Building_spring\|Building spring]]).