Dev:NetbeansHowTo
Aus YaCyWiki
Inhaltsverzeichnis |
Netbeans HowTo
Diese Seite beschreibt, wie man die Entwicklungsumgebung (IDE) Netbeans einrichten muss, um damit den Quellcode von YaCy bearbeiten zu können. Basis dafür ist Netbeans Version 6.0.1 unter Linux. Bei anderen Versionen können Unterschiede auftreten.
Benötigte Software
Netbeans kann kostenlos von Netbeans.org heruntergeladen werden. Es stehen mehrere Versionen zur Auswahl, wobei jede für die Arbeit an YaCy geeignet ist. Wer sich unsicher ist, kann daher zunächst die kleinste Version auswählen.
Neben Netbeans muss Subversion installiert sein. Neuere Versionen von Netbeans sind in der Lage, die für einen Zugriff auf Subversion-Repisitories notwendige Software bei Bedarf nachzuinstallieren. Subversion kann aber auch von subversion.tigris.org heruntergeladen werden. Für Windows-Systeme empfiehlt sich TortoiseSVN, das sich sehr gut in den Windows Explorer integriert.
Außerdem wird ANT benötigt, das ebenfalls in vielen Linux-Distributionen enthalten ist oder aber von ant.apache.org heruntergeladen werden kann.
Projekt einrichten
Nach der Installation von Netbeans und Subversion kann Netbeans gestartet werden. Im Menü Window - Versioning muss unter Subversion der Punkt Checkout... gewählt werden. Im nun erscheinenden Fenster wird der Benutzer aufgefordert, den Pfad zum Subversion Repository einzugeben.
Sollte statt dieses Fensters eine Aufforderung erscheinen, den Pfad zu SVN einzugeben, so konnte Netbeans SVN nicht automatisch erkennen. Gründe hierfür können eine Fehlerhafte SVN-Installation oder eine nicht oder falsch gesetzte Umgebungsvariable sein. Neben der Eingabe des Pfades zur SVN-Software kann es helfen, Netbeans oder den Computer neu zu starten oder SVN neu zu installieren.
Der Pfad zum Subversion-Repository (Repository URL) lautet: https://svn.berlios.de/svnroot/repos/yacy/trunk
Weiter Informationen - auch zu alternativen Übertragungswegen (HTTP, SSH) - bietet die BerliOS-Seite zum Thema SVN.
In den Feldern User und Password können nun die entsprechenden Daten eingetragen werden, dies ist aber nicht unbedingt notwendig, da auch ein anonymer (nur lesender) Zugriff auf das Repository möglich ist. Werden später Daten in das Repository eingecheckt, werden die Daten dann von Netbeans erfragt.
Nach dem Klick auf Next fragt Netbeans nach, ob das Zertifikat von BerliOS akzeptiert werden soll. Diese Frage bestätigen (außer es besteht Grund zum Zweifel an der Authentizität).
Die im sich daraufhin öffnenden Fenster enthaltenen Daten können übernommen und mit Finish bestätigt werden. Netbeans beginnt nun, den Quellcode von YaCy herunterzuladen, was in Abhängigkeit von der Geschwindigkeit des Internetzugangs einige in Anspruch nehmen kann. Nachdem der Quellcode heruntergeladen wurde, erscheint ein Fenster, in dem die Art des Projects anzugeben ist. Hier sollte Java Project with Existing Ant Script bzw. Java Free-Form Project (ab Netbeans 6.1) gewählt und mit Next bestätigt werden.
Im nächsten Fenster muss unter Location der Ordner angegeben werden, in dem Netbeans den Quellcode von YaCy abgelegt hat. In dem hier verwendeten Beispiel ist dies /home/low012/NetBeansProjects/trunk. Die restlichen Werte sollten nun automatisch von Netbeans ergänzt werden. Die nach Next erscheinenden Daten können ebenfalls übernommen werden.
Im nun folgenden Fenster müssen unter Package Folder alle Verzeichnisse in trunk/source/de/anomic ausgewählt und dann mit Next bestätigt werden. Im nächsten Fenster muss der Haken neben Separate Classpath for Each Source Package Folder entfernt werden und alle JAR-Dateien in libx und lib hinzugefügt werden.
Nachdem auch die letzten Schritte bestätigt wurden, kann das Projekt zum ersten Mal kompiliert werden (rechte Maustaste auf dem Projekt drücken und entsprechende Option auswählen). Danach sollte zum Classpath noch das Verzeichnis trunk/classes hinzugefügt werden. Dazu muss mit der rechten Maustaste auf das Projekt YaCy geklickt und dann Properties ausgewählt werden. Hier kann nun unter Java Sources Classpath die Änderung vorgenommen werden.
Java 1.5
Da YaCy auf Java 1.5 basiert, sollte (wenn möglich) das JDK 1.5 installiert werden und zum Kompilieren (zumindest für lokale Tests) genutzt werden, um versehentliches Benutzen von Java 1.6-features zu verhindern. Es is möglich, mehrere JDKs parallel zu installieren. In Netbeans können unter Tools > Java Platforms zusätzliche Java-Umgebungen hinzugefügt werden. Um Java 1.5 auch tatsächlich zum Kompilieren zu nutzen, kann unter Java Sources Classpath (siehe vorheriger Absatz) die gewünschte Version gewählt werden.
