Open Source

Sara's picture

Get The Source(tm)

Der aktuelle "cutting-edge" Quellcode ist jetzt über monotone verfügbar. Dies beinhaltet alle aktuellen Änderungen, sogar solche, die noch nicht in eine Runde eingespielt wurden.
Was man dafür braucht:

Eine Entwickler-Mailinglist ist hier:

https://lists.sourceforge.net/lists/listinfo/cqs-devel

Schnellstart: monotone einrichten

Ein vollständige monotone Anleitung mit Tutorial gibt es auf der monotone Homepage. Hier nur die Schnellfassung:

  1. Datenbank anlegen
    mtn --db=mydatabase.db db init
  2. Quellcode ziehen
    mtn --db=mydatabase.db pull exeter.conquer-space.net "net.cqs.*"
  3. CqS auschecken
    • CqS Aktuellste Version:
      mtn --db=mydatabase.db co cqs-trunk --branch=net.cqs.game.trunk
    • CqS Version 18 (Gamma):
      mtn --db=mydatabase.db co cqs-18 --branch=net.cqs.game.ver18

Schnellstart: Mit Ant compilieren und starten

  1. Öffnen Sie eine Konsole (Eingabeaufforderung) und gehen Sie in das Verzeichnis, in das Sie CqS ausgecheckt haben - dieses beinhaltet die Datei build.xml. Wenn Sie die Anleitung von oben benutzt haben, so sollte das Verzeichnis cqs-trunk oder cqs-17 heißen.
  2. ant
  3. java -jar startup.jar setup
  4. java -jar startup.jar start

Entwicklung mit Eclipse

Wenn Sie CqS weiterentwickeln wollen, so empfehlen wir die Nutzung von Eclipse (http://www.eclipse.org/). Das Einrichten von Eclipse ist allerdings etwas aufwendiger.

Eclipse: CqS als Projekt anlegen

  1. Eclipse starten
  2. Rechtsklick auf den "Package Explorer"
  3. New -> Project
  4. "Java Project" auswählen und auf "Next" klicken
  5. "Project Name" vergeben (zum Beispiel "CqS")
  6. "Create project from existing source" anwählen
  7. Auf "Browse" klicken und das Verzeichnis auswählen, in dem sich der Quellcode von CqS befindet (zum Beispiel /home/ulfjack/monotone/cqs/ oder C:\Projekte\OpenSource\cqs\)
  8. "Ok" klicken (als "Directory" sollte jetzt das Verzeichnis ausgewählt sein, in dem sich der Quellcode befindet)
  9. "Finish" klicken
  10. Links im "Package Explorer" erscheint CqS als Projekt

Eclipse: Lokales Starten von Conquer-Space.net

Wir empfehlen, CqS in einer Konsole von Hand zu starten. Dies ist ganz einfach möglich mit java -jar startup.jar setup (Galaxie erstellen) und java -jar startup.jar start (starten). Wenn Eclipse zum Compilieren verwendet wird, so werden die von Eclipse compilierten Klassen automatisch verwendet.

Administration eines lokalen CqS-Servers

Hilfe dazu findet sich unter http://www.conquer-space.net/de/server-help.

2 Fehlermeldungen

Ich bekomme im Eclipse 2 Fehler Angezeigt

1.)
The project was not built since its build path is incomplete.
Cannot find the class file for java.lang.Object.
Fix the build path then try building this project

2.)
The type java.lang.Object cannot be resolved.
It is indirectly referenced from required .class files UnitPeer.java cqs/Source/net/cqs/web/ulfscript/peers line 1

Ihr schreibt :
"......dann die Java-Anwendung net.cqs.main.SetupWizard im Verzeichnis Demo ausgeführt werden."

es gibt keine Datei net.cqs.main.SetupWizard
wie sollte ich die da auch ausführen wenn sie nicht im Verz. liegt bzw. vorhanden ist?

Ihr schreibt weiter:
"Um CqS lokal zu starten, muss die Java-Anwendung net.cqs.main.Main im Verzeichnis Demo ausgeführt werden."

Ich habe ebenfalls keine Datei "net.cqs.main.Main"

Sara's picture

Hoffentlich Antworten

1.) Anscheinend findet er deine Java Library nicht.
In Eclipse im Package Explorer:

Rechts-Klick auf CqS -> Properties -> Java Build Path -> Libraries

Ist dort eine "JRE System Library" vorhanden? Ich denke Du brauchst mindestens Version 1.5. Falls die Library nicht vorhanden ist, hinzufügen. Falls doch ... mal schauen ob das hier der Grund ist ;)

2.) Sieht so aus als wäre der CLASSPATH nicht richtig gesetzt. Er muss sowohl alle .jar aus dem Verzeichnis Libraries enthalten als auch den Pfad zu Classes.
Bei mir liegt zum Beispiel CqS im Verzeichnis /home/sara/monotone/CqS

Ich gehe zum Beispiel in /home/sara/monotone/CqS/Demo und mache folgendes:

export CLASSPATH=.:/home/sara/monotone/CqS/Libraries/catfish.jar:
/home/sara/monotone/CqS/Libraries/cssparser-0.9.4.jar:
/home/sara/monotone/CqS/Libraries/emma.jar:
/home/sara/monotone/CqS/Libraries/irc.jar:
/home/sara/monotone/CqS/Libraries/js.jar:
/home/sara/monotone/CqS/Libraries/junit.jar:
/home/sara/monotone/CqS/Libraries/ulfio.jar:
/home/sara/monotone/CqS/Libraries/ulfscript.jar:
/home/sara/monotone/CqS/Classes/

java net.cqs.main.SetupWizard

java net.cqs.main.Main

und CqS startet...

Ich hoffe das hilft.

-- Sara

Immernoch ein Fehler

Also ich habe folgedes gemacht :

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/Libraries/cssparser-0.9.4.j
ar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/emma.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/irc.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/js.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/junit.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/ulfio.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/ulfscript.jar:

C:\Programme\monotone\cqs\Demo>SET CLASSPATH=.:c:/Programme/monotone/cqs/Classes/

C:\Programme\monotone\cqs\Demo>java net.cqs.main.SetupWizard
Exception in thread "main" java.lang.NoClassDefFoundError: net/cqs/main/SetupWizard

Sara's picture

Zweiter Versuch

Die jar-Dateien sollten im Libraries-Verzeichnis sein. In cqs wird er sie nicht finden können. Außerdem musst du eventuell \ statt / benutzen, ich weiß nicht wie das in der DOS-Box (Eingabeaufforderung) ist.

Außerdem kannst Du wohl den CLASSPATH unter Windows auch wie folgt ändern (engl. Windows XP):


  1. "Start"->"Settings"->"Control Panel"-> "classic view"

  2. "System"->"Advanced"->"Environmelt Variables"

  3. Neue Variable mit Namen CLASSPATH anlegen

  4. Wert der Variable wie oben angeben, hier aber sicherlich mit \ statt /


Dann sollte hoffentlich der CLASSPATH dauerhaft gespeichert werden. Sonst müsstest Du den Kram wohl jedes Mal eingeben.

-- Sara

XP auf deutsch

# "Start"->"Settings"->"Control Panel"-> "classic view"
# "System"->"Advanced"->"Environmelt Variables"
# Neue Variable mit Namen CLASSPATH anlegen

zu deutsch:
1 start->Einstellungen->Systemsteuerung
dort entweder auf "klassische Ansicht" oder einfach "Leistung und Wartung"
2 Systen->Erweitert->Umgebungsvariablen
3 siehe sara

Aktueller Source Code??

Hi,

wie kanni ch mir den den aktuellen Code ziehen?

Der Branch ver14-2 ist doch nicht aktuell oder? Die Gamma hat ja schon ver14-8

Dank und Gruß

Wistler

UlfJack's picture

Den aktuellen Source gibts

Den aktuellen Source gibts mit monotone wie oben beschrieben. Die zweite Nummer, also die '3' in '14-3' ist nur die lokale Versionsnummer, wie oft mit ant compiliert wurde.

Ant nur fürs "Offline" spielen?

Hi!

Wenn ich das richtig verstehe, dann ist Ant nur der Server, um das Spiel zu spielen, nicht um aber den Sourcecode zu bearbeiten, oder?

Weil ich plane ein eignes Browsergame und wollte (mit eurer Erlaubnis und den entsprechenden Regeln eurer gewählten Lizens) die CQS Engine nutzen.

Mir fehlt halt noch ne vernüftige Produktions und Testumgebung.

Gruß
Das
HyP

Sara's picture

Zum Editieren: Eclipse

Ant wird zum Compilieren des Codes verwendet. Den Sourcecode kannst Du mit einem Texteditor bearbeiten, das kann aber schnell sehr unübersichtlich werden. Besser ist es eine Entwicklungsumgebung zu verwenden - zum Beispiel Eclipse.

Thor's picture

Anmelden

Ich hab mir den aktuellen Code gesaugt und alles klappt auf anhieb wunderbar.
Bloss wie kann ich mich anmelden?
Bzw. wie kann ich User anlegen?