Erweiterungen erstellen

Externe Entwickler können jede Art von Erweiterung für SMath Studio selbst entwickeln — vor allem eigene Plug-ins, die nach den spezifischen Anforderungen eines Kunden geschrieben werden. Ein Plug-in kann die Anwendung um neue Funktionen, neue Datentypen, neue Oberflächenelemente oder die Anbindung externer Systeme erweitern und ist damit der wirkungsvollste Weg, SMath Studio an einen bestimmten Arbeitsablauf anzupassen. Als Ausgangspunkt können Sie die Plug-ins studieren, deren Quellcode öffentlich verfügbar ist.

Eigenes Plug-in erstellen

Um unter Windows mit dem Code eines eigenen Plug-ins zu arbeiten, gehen Sie wie folgt vor:

1. Installieren Sie die aktuelle Version von SMath Studio.
2. Installieren Sie die aktuelle Version von Visual Studio Community.
3. Legen Sie ein Projekt vom Typ Class Library (.NET Framework) an und geben Sie im Dialog zur Projekterstellung im Feld Framework .NET Framework 2.0 an.
4. Implementieren Sie eine oder mehrere Schnittstellen von SMath Studio, die von IPlugin erben:
   • IPluginLowLevelEvaluationFast — Abfangen von Operatoren und Funktionen.
   • IPluginMathNumericEvaluation — Abfangen numerischer Berechnungen.
   • IPluginCustomRegion — Abfangen der Erstellung eines Elementtyps im Blatt.
   • IPluginRegionDrawing — Abfangen eines Formelelements beim Zeichnen einer mathematischen Formel.
   • IPluginSaveFileTypes — Abfangen des Speicherns einer Berechnung in eine Datei.
   • IPluginOpenFileTypes — Abfangen des Öffnens einer Berechnungsdatei.
   • IPluginDataInputOutput — eigenes Format für Eingangsdaten und Rechenergebnisse bei Automatisierung und Integration in andere Anwendungen.
   • IPluginMenuExtender — Erweiterung des Hauptmenüs des Programms.
5. Damit Ihr Plug-in auf verschiedenen Plattformen möglichst kompatibel ist, empfiehlt es sich, überall dort, wo Grafik gezeichnet werden muss, die Bibliothek SMath Studio Drawing zu verwenden.

Eigenes Plug-in debuggen

Während der Entwicklung kann es nötig sein, die Funktion des erzeugten Quellcodes zu prüfen. Um den Code Ihres Plug-ins im Kontext des Prozesses von SMath Studio auszuführen, gehen Sie wie folgt vor:

1. Bauen Sie Ihr Plug-in in Visual Studio im Modus Debug (dabei entstehen auch die Debug-Dateien *.pdb).
2. Kopieren Sie die Ausgabe in den Ordner plugins im Installationsverzeichnis von SMath Studio.
3. Starten Sie das Programm SMath Studio.
4. Wenn Sie Ihren Code debuggen möchten, verwenden Sie die Visual-Studio-Funktion Attach to Process... im Menü Debug.
5. Wählen Sie im sich öffnenden Dialogfeld SMath Studio (dort meist als Solver.exe aufgeführt) aus der Liste der verfügbaren Prozesse und klicken Sie auf die Schaltfläche Attach.

Beachten Sie, dass Sie nach jeder Codeänderung alle beschriebenen Schritte wiederholen müssen.

Eigenes Plug-in ausliefern

Damit Ihr eigenes Plug-in Teil des Standardverfahrens zur Auslieferung an andere Benutzer wird, gehen Sie wie folgt vor:

1. Laden Sie den Quellcode des Plug-ins in das öffentliche SVN-Repository hoch.
2. Öffnen Sie den Release Manager des Projekts unter https://smath.com/ReleaseManager/ — dazu müssen Sie zuerst mit Ihrem SMath-Konto angemeldet sein — und legen Sie dort ein neues Plug-in an, wobei Sie den Pfad zu seinem Quellcode im öffentlichen SVN-Repository angeben.
3. Bauen Sie das Plug-in im Release Manager (Klick auf Build) und prüfen Sie, dass das Protokoll keine Warnungen oder Fehler enthält. Wurden Warnungen oder Fehler gefunden, beheben Sie sie und wiederholen Sie den Build.
4. Nach erfolgreichem Build veröffentlichen Sie das Plug-in (Klick auf Publish) in der Plug-in-Registry.
5. Die erste Veröffentlichung des Plug-ins muss eventuell vom SMath-Team geprüft und bestätigt werden. Um das zu beschleunigen, wenden Sie sich an die Entwickler unter folgender E-Mail-Adresse: support@smath.com.
6. Im Ergebnis wird das Plug-in in die Plug-in-Registry aufgenommen und steht allen Benutzern des Programms SMath Studio über die im Programm eingebaute Erweiterungs-Verwaltung zur Verfügung.