Introduction

Software Requirements

jsoar has the following software requirements:

• Java 1.6 - jsoar uses features from Java 1.6. If this is not an option, contact jsoar-dev@googlegroups.com and we'll see what we can do.

Checking out into Eclipse

jsoar has been developed in Eclipse so the easiest way to get started modifying the code is with Eclipse. You have two options for checking out the code. The first option is with the Subclipse SVN plugin. This method is highly recommended. Once Subclipse is installed:

• File -> Import ... -> SVN -> Checkout Projects from SVN
• Project URL: http://jsoar.googlecode.com/svn/trunk

Follow the wizard, selecting the jsoar-core, jsoar-debugger, etc projects, and the jsoar sources will be checked out into a set of Eclipse projects. The other option is some other SVN tool like the command-line or TortoiseSVN. In this case, once the code is checked out from http://jsoar.googlecode.com/svn/trunk:

• File -> Import ... -> General -> Existing Projects into Workspace

Follow the wizard, selecting the jsoar-core and jsoar-debugger projects, to pull the projects into Eclipse.

That's all that's necessary. Eclipse will automatically build the code and all library dependencies are already in the source tree.

Running the code

There are already Eclipse launch configurations set up in the tools/launches folder. To run one, click Run -> Run Configurations -> Java Applications and select an app to run. It is recommended that you duplicate one of the existing launch configurations if you need your own.

To run the unit tests (please do so you know you haven't broken anything), click Run -> Run Configurations -> JUnit -> jsoar - All Unit Tests. If the bar in Eclipse is green, everything is good. New unit tests go in the src/test/java folder or the appropriate sub-project.

Building a jar

TODO

Extending jsoar

TODO