 |
Home | Changes | Index | Search | Go
Download, Configure, Build and Run from the Wonderland v0.5 Source
This page describes how to download, configure, build and run Project Wonderland v0.5 from the source code. Generally only software developers will use Wonderland in this way--to do so, you should be familiar and comfortable with building open-source software from the command-line using ant or via an IDE.
The Project Wonderland source code comes bundled with most of the software you will need, including an up-to-date version of jMonkeyEngine and Project Darkstar.
Requirements
Wonderland is set up as a Netbeans project that includes ant scripts for running the various Wonderland services. If you're using Netbeans you can check out and compile the project directly. If not, you need to install the following tools if not already present on your system:
- Have Java SE 6 installed on your system.
- Have ant version 1.7.1 installed on your system (http://ant.apache.org/).
- Have subversion installed on your system (http://subversion.tigris.org/).
- Have an account on java.net. To register for an account (free), visit: https://www.dev.java.net/servlets/Join
If you wish to use the command-line in addition to Netbeans, be aware that Netbeans does not add ant to your path. You will need to do this manually. If you are using Netbeans, the wonderland workspace is setup as a Netbeans project. The Netbeans community has published tutorials on using Subversion (here). You may invoke the ant targets (specified below) directly from Netbeans.
Download the Project Wonderland workspace
The wonderland workspace contains all of the source code and any libraries that Project Wonderland depends upon and is available via svn. It contains its own ant-based build system. This tutorial assumes you will place this workspace under a base directory named ~/src, although you are free to place it anywhere.
User Preview 2 Source Code
To download the source from our most recent stable release (User Preview 2), inside a terminal window from your home directory, after you have created the src subdirectory:
% cd ~/src
% mkdir 0.5-preview2; cd 0.5-preview2
% svn checkout https://wonderland.dev.java.net/svn/wonderland/branches/0.5-preview2 wonderland --username <username>
where you should replace <username> with your java.net user name.
Latest Source Code (trunk)
If you wish to work with the latest source code, inside a terminal window from your home directory, after you have created the src subdirectory:
% cd ~/src
% mkdir trunk; cd trunk
% svn checkout https://wonderland.dev.java.net/svn/wonderland/trunk wonderland --username <username>
where you should replace <username> with your java.net user name.
Building Project Wonderland
You can build the Project Wonderland source code by running the ant command in a terminal window:
% ant
Running Project Wonderland
You run Project Wonderland by using ant targets provided by the build system. When you run Wonderland, you are really starting a web server on your machine. This web server provides a number of functions: it supports a web-based administration interface that lets you start/stop the Wonderland server and associated services. (It also manages the modules that you have installed on your system).
To run wonderland, in the wonderland directory:
% ant run-server
Once you start Wonderland, you can administer the server via a web-based user interface. Please visit the following tutorial for more details:
|