Downloading and Installing Instructions for B-Soccer

Support

Feel free to ask any questions, or report bugs [contact]

Prerequisites

• JDK 1.1 or higher must be installed on your computer.
• GNU-Make facility is needed if you want to compile B-Soccer source code.
• Java Bot is needed in order to use the Java Soccer classes. (see B-Soccer OtherPackages).
• J-Unit is needed to run the B-Soccer test cases. (see B-Soccer OtherPackages).

Downloading

In order to keep the distribution files small I have split B-Soccer into three parts.

• B-Soccer Source: The source code and the appropriate make files in order to compile and run B-Soccer.
• B-Soccer OtherPackages: A collection of .jar files containing class files of packages used by B-Soccer. You may use these .jar files or download the newest version of these packages.
• B-Soccer Documentation: The documentation you are reading at the moment without the distribution itself.

Installation

• Unzip the B-Soccer Source in any directory. This directory is now your B-Soccer Base.
• If you downloaded B-Soccer OtherPackages, unzip them and put the .jar files in the /pkg sub directory of the B-Soccer base.
• If you downloaded B-Soccer Documentation, unzip them and put the contents in the doc sub directory of the B-Soccer base.
• Edit the make.cfg file in order to meet the preferences of your system. I have already prepared some sections for different systems. NT, OS/2 and Linux. Take these sections as a model.
• For Unix systems the line feed in the source- and make files can be converted by typing make dos2unix in the B-Soccer Base.
• Start the test cases by typing make test or make testGUI. There should not be any errors or failures.
• Send me an email [contact]

Handling

There is one make file for the B-Soccer project as a whole that resides in the /bsoc directory and all packages have their own make file. They have an all and a clean paragraph. So make clean all will recompile a package or the whole project. Most packages have a test paragraph to start the test cases. Starting the test cases should always result in 0 errors and 0 failures. Some packages contain a run paragraph. Try make runSocSim in B-Soccer Base or /fcfunny: make run. Look into the Makefiles in order to find out more.

[B-Soccer]