Wie komme ich an den Quellcode von X-Force heran?

Programming.Inhalt

Wie kann ich die Tools zu X-Force kompilieren?

---

Das Compilieren des Quellcodes wurde nach Veröffentlichung der 915b01 wesentlich vereinfacht, indem sämtliche externen Units direkt in den Quellcode von X-Force aufgenommen wurden. Zum compilieren von X-force muss man nur noch Delphi installieren, den Quellcode herunterladen und das Ausgabeverzeichnis anpassen. Dabei gibt es im wesentlichen 2 kostenlose Optionen. Entweder man installiert Delphi 2005 Personal oder man entscheidet sich für Turbo Delphi 2006 Explorer (Installationsanleitung). Letzteres ist deutlich anwendungsfreundlicher, läuft schneller/stabiler und bietet neben deutlich besseren Debugoptionen auch eine Reihe Refractor-Funktionen und Shortcuts, die das Arbeiten wesentlich erleichtern. Leider kann man in der Explorer-Version keine externen Komponenten installieren. Wenn man nur X-Force compilieren will, spielt das keine Rolle - die 2 bisher verwendeten exterfnen Komponenten DXInput und Arrows (ImageList) wurden als Quellcode umgesetzt. Falls man aber plant, später auch die Tools zu kompilieren, dann sollte man überlegen, ob man besser zu 2005 Personal greift. Zwar klappt das Kompilieren, allerdings wird man immer eine lässtige Fehlermeldung beim Öffnen des Quellcodes bekommen (Komponente nicht gefunden), bei der man auf Abbrechen klicken muss. Außerdem ist es nicht möglich, die externen VLC-Komponenten über die grafische Oberfläche zu bearbeiten. Ich persönlich empfehle, beide Versionen zu installieren.

So, nun aber zur Anleitung.

• Aktuellste Version von X-Force installieren und per Online-Updater die wichtigen Updates ziehen.
• Quellcode herunterladen (SVN-Verzeichnis Source) und in ein beliebiges Verzeichnis speichern. Verzeichnisstruktur muss dabei beibehalten werden (siehe Anleitung).
• Als weiteres sollten die aktuellsten Dateien aus dem bin-Verzeichnis des SVN Archive installiert werden. Dies sind aktuellere Sprachdateien, die für eine neuere xforce.exe eventuell benötigt werden. Einfach in das XForce-Verzeichnis in die passende Struktur kopieren.

• Delphi 2005 Personal bzw. Turbo Delphi 2006 Explorer installieren.
• Projektgruppe für die entsprechende Delphi Version öffnen, z.B. ->C:\xforce-sandbox\game\source\xforce_delphi2005.bpg
• Projekt X-Force aktivieren
• Projektoptionen aufrufen
  • unter Verzeichnisse/Bedingungen folgende Optionen anpassen
    • Ausgabeverzeichnis: Hier muss nun das Installationsverzeichnis von X-Force angegeben werden, damit die EXE direkt dort erstellt wird.
• In der Defines.pas die Konstante SettingsDir: String = 'c:\XFQuellcode\v0915\game\bin\settings\'; ams eigene System anpassen
• Compilieren (Hinweis: Manchmal wird beim compilieren eine fehlende *.dcu angemekert, oder eine zirkuläre Unitverwendung. Das ist vermutlich ein Problem des Linkers - einfach nochmal compilieren, im zweiten Anlauf sollte es dann klappen).

Hinweis: da ich nicht genau weiß, was man von den nachfolgenden Dingen als Komponente für die Editoren braucht, lasse ich den Text erstmal noch drin. Die benötigten Dateien sind aber alle als Unit ins SVN und in den Quellcode eingebunden. Eine Installation ist nur dann erforderlich, wenn einige Komponenten auch auf den Frames von medit bzw. edit verwendet werden (müsste mal jemand prüfen, vermutlich kann man das hier alles ignorieren, und muss nur noch die Hinweise zum compillieren der Tools beachten)

Der Quellcode zu X-Force: Fight For Destiny wurde bisher erfolgreich unter folgenden Delphi-Versionen kompiliert:

• Delphi 5 Enterprise
• Delphi 5 Enterprise mit Service Pack 1
• Delphi 6 Personal
• Delphi 6 Enterprise
• Delphi 2005 Personal (kostenlos downloadbar)

Zur Einrichtung müssen folgende Schritte unternommen werden:

• Aktuellste Version von X-Force installieren und per Online-Updater die wichtigen Updates ziehen.

• Quellcode herunterladen (SVN-Verzeichnis Source) und in ein beliebiges Verzeichnis speichern. Verzeichnisstruktur muss dabei beibehalten werden.

Am besten ins Verzeichnis c:\xforce-sandbox

• Als weiteres sollten die aktuellsten Dateien aus dem bin-Verzeichnis des SVN Archive installiert werden.
  • Dies sind aktuellere Sprachdateien, die für eine neuere xforce.exe eventuell benötigt werden. Einfach in das XForce-Verzeichnis in die passende Struktur kopieren.
• Patch für Delphi2005 Personal installieren (Anleitung auf der verlinkten Seite, einfach nur eine Datei umbenennen und kopieren).

Hinweis zu Vista: Unter Vista macht die Installation von Delphi 2005 Probleme, da Net.Framework 1.1 nicht kompatibel zu Vista ist. Das Problem wird aber durch ein Servicepack behoben. Daher erstmal trotz Warnung versuchen, zu installieren. Sollte dies klappen, das SP1 für Net.Framework 1.1 von Microsoft runterladen und installieren. Es kann aber passieren, das die Installation kurz vor Abschluss hängenbleibt. In diesen Fällen ist die Sache etwas komplizierter, aber im Internet finden sich Lösungen dafür (einfach mal eine Suchmaschiene benutzen; da das ganze doch etwas umständlicher ist und auch nur selten nötig wird, wird an dieser Stelle nicht näher darauf eingegangen)

• JEDI Visual Component Library installieren. Der Download befindet sich hier:

• Im Anschlus c:\delphi\jvcl\install.bat starten und installieren lassen
  

Hinweis: hat bei mir unter Vista auch mit der aktuellen Version JVCL334CompleteJCL1102-Build3072 geklappt.

• Pascal Script Homepage

• Utility Library von http://philo.de/xml/downloads.shtml herunterladen und installieren.

• Projektgruppe für die entsprechende Delphi Version öffnen (xforce_delphix.bpg)

• Projektverwaltung anzeigen (Ansicht->Projektverwaltung) (wenn nicht sichtbar)

• Package delphix_forx.dpr in der Projektverwaltung aktivieren und installieren.

delphix_for2005.dpr

Die Datei C:\xforcev910\bass.dll ins "C:\Program Files\Borland\BDS\3.0\Bin" (oder PATH-Variable ergänzen, das diese Datei von Delphi gefunden wird)
kd4dx_delphi2005.dpr aktivieren und installieren.

Hinweis: kd4dx_delphi2005.dpr ist bei mir nicht mehr Bestandteil der Projektgruppe. Soweit ich weiß, ist die extra Installation auch nicht mehr nötig (bei mir klappt es jedenfalls auch ohne).

• Projekt X-Force aktivieren

• Projektoptionen aufrufen
  • unter Verzeichnisse/Bedingungen folgende Optionen anpassen
    • Ausgabeverzeichnis: Hier muss nun das Installationsverzeichnis von X-Force angegeben werden, damit die EXE direkt dort erstellt wird.

• Projekt X-Force kompilieren und hoffen.

• Wenn alles geklappt, müsste X-Force kompiliert sein und du kannst mit den Arbeiten beginnen.
  Empfehlenswert ist es unter Tools->Debugger-Optionen->Sprachexceptions die Option "bei Delphi-Exceptions stoppen" zu deaktivieren. Dadurch wird verhindert, dass X-Force stehen bleibt, sobald eine Exception auftritt.

Und noch ein wichtiger Tipp: Aktiviert das Auto-Speichern. Nichts ist schlimmer als ein Absturz nach dem man längere Zeit Programmiert hat und nicht gespeichert hat.

---