Ressourcen: Sourcecode

Aus OpenMPT-Wiki
Zur Navigation springenZur Suche springen

Wie der Name OpenMPT schon andeutet, ist diese Anwendung quelloffen. Jeder kann sich den Sourcecode runterladen und nach belieben modifizieren. Das OpenMPT-Entwicklerteam ist sehr klein (momentan sind wir zwei Leute!), neue Helfer sind von daher immer willkommen.

Was brauche ich?[Bearbeiten]

  • Visual Studio 2017 oder neuer (alle Editionen werden unterstützt).
  • Optional TortoiseSVN oder ein beliebiger anderer SVN-Client, um die jeweils aktuelle Version des Sourcecodes über das SVN-System zu beziehen

Den Sourcecode beziehen[Bearbeiten]

  • Zuerst musst du ein Verzeichnis anlegen, in dem der Sourcecode abgelegt werden soll. Führe danach einen Rechtsklick auf dieses Verzeichnis aus und wähle den Menüpunkt "SVN Checkout..." aus. Die "Repository URL" für das darauf erscheinende Fenster lautet: https://source.openmpt.org/svn/openmpt/trunk/OpenMPT/
  • Klicke auf OK. Es werden nun alle Dateien heruntergeladen.
  • Die jeweils aktuelle Version kannst du danach mit einem Rechtsklick auf das Verzeichnis über den Menüpunkt "SVN Update..." erhalten.
  • Das ASIO-SDK wird aus rechtlichen Gründen nicht mit dem OpenMPT-Code mitgeliefert, kann aber automatisch durch Aufruf der Datei build/download_externals.cmd runtergeladen werden. Falls du dies stattdessen lieber von Hand erledigen möchtest, so lade zunächst das SDK von der Steinberg-Webseite runter. Die folgenden Dateien aus dem SDK müssen kopiert werden: asio.h, asiosys.h und iasiodrv.h aus common/ in den include-Ordner von OpenMPT kopieren.
    Möchtest du stattdessen OpenMPT ohne ASIO-Support kompilieren, muss die Konstanten NO_ASIO in der Datei common/BuildSettings.h definiert werden. Die entsprechenden Codezeile dafür ist schon vorhanden, aber auskommentiert.

Falls du keinen SVN-Client verwenden möchtest, um den Code herunterzuladen, kannst du auch den aktuellen Snapshot aus dem WebSVN laden, indem du dort auf den Download-Link klickst. Dazu musst du dann aber bei jedem Update den Code erneut komplett herunterladen.

Den Sourcecode kompilieren[Bearbeiten]

Öffne die Datei build/vs20xx/OpenMPT.sln (xx enspricht der Visual-Studio-Version) in Visual Studio, klicke auf das Menü "Build"→"Build solution" ("Erstellen"→"Projektmappe erstellen" in deutschen Versionen), um den Sourcecode zu kompilieren. Beachte, dass dieser Vorgang mehrere Minuten brauchen kann!

Patches beisteuern[Bearbeiten]

Falls du einen Patch für OpenMPT erstellt hast, kannst du mir diesen zusenden oder im Forum veröffentlichen.

Aktuell bleiben[Bearbeiten]

Um immer automatisch über die neuesten Commits informiert zu werden, kannst du die SVN-Commit-Mailingliste oder das RSS-Feed abonnieren.