Arianne

Marauroa on NetBeans: Difference between revisions

← Older editNewer edit →
Content deleted Content added
VisualWikitext
imported>SimonSmall
m →Start NetBeans: some clarification
imported>SimonSmall
Moved versions to Talk. Minor corrections
Line 1:
= Introduction =
 
These instructions assume that you will installinclude the minimum required to use the Marauroa engine. Additional features and functions are covered in separate pages.
 
Note that the Marauroa Engineengine is NOT a complete application. You will need to add more code to use it within a game application.
 
See the Talk page for version information.
 
= Requirements =
 
If not already installed, you will need the following.
 
== Java ==
 
The Marauroa engine is written using Java. You will need to install the Java Development Kit (JDK) from [http://www.oracle.com/technetwork/java/javase/downloads/index.html].
[http://www.oracle.com/technetwork/java/javase/downloads/index.html].
 
== NetBeans ==
Line 19 ⟶ 21:
== Marauroa Source ==
 
You can take the source code from the repositories, but these instructions use the released version available from the website, in this case the source marauroa-3.8.7-src.tar.gz [http://arianne.sourceforge.net/engine/marauroa.html].
 
== Directory structures ==
 
The following directory structure is one suggestion and is used in the instructions. Choose a different one if you wish.
 
You will need a location where you can save the files needed for development. The top level location is referred to as DEVPATH. Replace this with whatever you have chosen as that location. Do not create any sub-directories yet.
Line 37 ⟶ 40:
 
Return to the NetBeans IDE (Projects tab). It should have rescanned the files and read them into the project. If not, select Source, Scan for External Changes from the menu. A red exclamation mark warning icon shows the location of several errors. Right click the Libraries branch of the Project tree, and select Add Jar/Folder. Browse to the the libs directory for this project and select the h2.jar file. Wait until the Scanning process has finished, then repeat for each of the jar files copied from the source file libs directory (or use Ctrl-click to select multiple jar files). All red warning icons should disappear.
 
NOTE: version 3.8.7 gives an error, as it does not override the abstract method getRemoteAddress() in java.nio.channels.SocketChannel for marauroa.tools.protocolanalyser.FakeSocketChannel. The red exclamation mark warning icon shows the location of this error. Expand the Project tree until this file is shown, double click it to show it in the editor pane then locate the class definition FakeSocketChannel in the code. Position the cursor in that line (left click) then press Alt-Enter and select the option Implement all abstract methods. This adds the following lines:
 
<source lang="Java">
import java.net.SocketOption;
import java.util.Set;
@Override
public SocketChannel bind(SocketAddress local) throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public <T> SocketChannel setOption(SocketOption<T> name, T value) throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public SocketChannel shutdownInput() throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public SocketChannel shutdownOutput() throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public SocketAddress getRemoteAddress() throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public SocketAddress getLocalAddress() throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public <T> T getOption(SocketOption<T> name) throws IOException {
throw new UnsupportedOperationException("Not supported yet.");
}
@Override
public Set<SocketOption<?>> supportedOptions() {
throw new UnsupportedOperationException("Not supported yet.");
}
</source>
 
== Build Marauroa ==
Line 89 ⟶ 45:
If there are no errors in the package, select Run, Clean and Build Project from the NetBeans menu bar. This will create marauroa.jar in the dist directory.
 
Select Run, Generate Javadoc from the NetBeans menu bar. This will create the Javadoc documentation files in the dist\javadoc directory, and open the index.html file from that directory in your web browser. The javadoc files contain the marauroaMarauroa documentation extracted from the source files. Read them or ignore them, it is your choice; you do not have to create them. They will be useful when you are trying to understand the structure of the Marauroa Engineengine. To read them later, open the index.html in your web browser.
== Completion ==
Retrieved from "https://meet.konsthol.eu/w/index.php?title=Marauroa_on_NetBeans"