Anleitung zur Pluginentwicklung
ContRap Plugins liegen in Pluginbibliotheken, die reguläre dynamische Libraries sind. Eine Pluginbibliothek enthält dabei mehrere Plugins. Um eigene Plugins zu erstellen braucht mal also zunächst eine solche Bibliothek. Es wird davon ausgegangen, dass ContRap-Umgebung installiert und kofiguriert ist.
- Zuerst sucht man sich ein Verzeichnis aus, in dem die Bibliothek liegen soll. Dieses Verzichnis wird im Folgenden Basisverzeichnis genannt (z.B. ~/Projekte/DBV).
- In der Enticklungsumgebung wählt man die Option ''File->New library'' und füllt die Felder mit dem Namen, Projektnamen und dem Pfad aus. Der Name ist der Name der erstellten Bibliothek (libName.so oder libName.dylib auf Mac OS). Der Projektname ist der Name des CMake-Projektes. Der Pfad sollte auf das Basisverzeichnis zeigen.
- Sollte nach dem Drücken des Create-Buttons alls fehlerfrei verlaufen, so liegt nun im Basisverzeichnis eine leere Bibliothek. Man beachte, dass für diesen Schritt eine Internetverbindung erforderlich ist! Den Erfolg kann man zusätzlich dadurch prüfen in dem man in der Konsole "make" im Basisverzeichnis eintippt. Der Vorgang sollte fehlerfrei durchlaufen.
Plugins werden im eingebetteten Plugineditor der ContRap Entwicklungsumgebung erstellt.
- Um Pluginentwicklung zu starten wählt man die Option ''File->New plugin''.
- Nachdem man alle Parameter des Plugins eingestellt hat, speichtert man das Plugin im Verzeichnis ''Basisverzeichnis/src''.
- Das Plugin wird eingebettet in die Bibliothek, indem man im File-Browser (rechts) mit einem Rechtsklick auf ''Add plugin to library'' klickt.
- Um das neue Plugin in einen für ContRap erreichbaren Bereich zu installieren benutzt man aufeinanderfolgend die Optionen ''Plugin->Make plugin'' und ''Plugin->Install plugin''.
- Als letztes muss man zur Zeit ContRap neu starten, damit das neue Plugin im Suchfenster erscheint.