Benutzer-Werkzeuge

Webseiten-Werkzeuge


develop:scripting-plugin

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Letzte ÜberarbeitungBeide Seiten der Revision
develop:scripting-plugin [d.m.Y H:i] – [Aufbau der plugin.xml] willuhndevelop:scripting-plugin [d.m.Y H:i] – [Aufbau des Plugins] willuhn
Zeile 1: Zeile 1:
 ===== Hibiscus: Scripting-Plugin erstellen ===== ===== Hibiscus: Scripting-Plugin erstellen =====
  
-Mit Jameica 2.ist es erstmals möglich, Plugins zu erstellen, die keinen Java-Code enthalten. Das ist z.Bsp. für Plugins nützlich, die lediglich Bibliotheken (Jar-Dateien) für andere Plugins bereitstellen oder für Scripting-Plugins. Das folgende Tutorial beschreibt letzteres beispielhaft an einem Plugin "hibiscus.script.abcbank", welches Hibiscus um ein Javascript zur Umsatz-Synchronisierung mit der Bank "abcbank" erweitert und hierfür auch ein paar benötigte Jar-Dateien mitbringt.+Mit Jameica 2.ist es erstmals möglich, Plugins zu erstellen, die keinen Java-Code enthalten. Das ist z.Bsp. für Plugins nützlich, die lediglich Bibliotheken (Jar-Dateien) für andere Plugins bereitstellen oder für Scripting-Plugins. Das folgende Tutorial beschreibt letzteres beispielhaft an einem Plugin "hibiscus.script.abcbank", welches Hibiscus um ein Javascript zur Umsatz-Synchronisierung mit der Bank "abcbank" erweitert und hierfür auch ein paar benötigte Jar-Dateien mitbringt.
  
  
Zeile 10: Zeile 10:
 <code:shell> <code:shell>
   hibiscus.script.abcbank.zip   hibiscus.script.abcbank.zip
-    |-- plugin.xml +    
-    |-- hibiscus.script.abcbank.js +    +-- hibiscus.script.abcbank (Ordner) 
-    +-- lib +         |-- plugin.xml 
-         |-- commons-codec-1.4.jar +         |-- hibiscus.script.abcbank.js 
-         |-- commons-io-1.4.jar +         +-- lib 
-         |-- cssparser-0.9.5.jar +              |-- commons-codec-1.4.jar 
-         |-- serializer-2.7.1.jar +              |-- commons-io-1.4.jar 
-         |-- xml-apis-1.3.04.jar +              |-- cssparser-0.9.5.jar 
-         |-- commons-collections-3.2.1.jar +              |-- serializer-2.7.1.jar 
-         |-- commons-lang-2.4.jar +              |-- xml-apis-1.3.04.jar 
-         |-- htmlunit-2.7.jar +              |-- commons-collections-3.2.1.jar 
-         |-- nekohtml-1.9.14.jar +              |-- commons-lang-2.4.jar 
-         |-- xalan-2.7.1.jar +              |-- htmlunit-2.7.jar 
-         |-- commons-httpclient-3.1.jar +              |-- nekohtml-1.9.14.jar 
-         |-- commons-logging-1.1.1.jar +              |-- xalan-2.7.1.jar 
-         |-- htmlunit-core-js-2.7.jar +              |-- commons-httpclient-3.1.jar 
-         |-- sac-1.3.jar +              |-- commons-logging-1.1.1.jar 
-         |-- xercesImpl-2.9.1.jar +              |-- htmlunit-core-js-2.7.jar 
-         +-- LICENSE.TXT+              |-- sac-1.3.jar 
 +              |-- xercesImpl-2.9.1.jar 
 +              +-- LICENSE.TXT
 </code> </code>
  
 ===== Aufbau der plugin.xml ===== ===== Aufbau der plugin.xml =====
  
-Die Datei "plugin.xml" ist das Manifest eines Plugins ([[develop:plugin.xml|siehe auch]]). Es beschreibt die Eigenschaften des Plugins sowie dessen Abhängigkeiten zu anderen Plugins. Im konkreten Beispiel erfordert es Jameica mindestens in Version 2.3.0 (erst seit dieser Version ist es möglich, Plugins ohne Java-Code zu erstellen), ausserdem die Plugins "hibiscus" und "jameica.scripting" in mindestens den angegebenen Versionen.+Die Datei "plugin.xml" ist das Manifest eines Plugins ([[develop:plugin.xml|siehe auch]]). Es beschreibt die Eigenschaften des Plugins sowie dessen Abhängigkeiten zu anderen Plugins. Im konkreten Beispiel erfordert es Jameica mindestens in Version 2.4.0 (erst seit dieser Version ist es möglich, Plugins ohne Java-Code zu erstellen), ausserdem die Plugins "hibiscus" und "jameica.scripting" in mindestens den angegebenen Versionen.
 Das Plugin sendet ausserdem eine Message an die Queue "jameica.scripting.add" mit dem Inhalt "${manifest.pluginDir}/hibiscus.script.abcbank.js". Diese Queue wird vom Plugin "jameica.scripting" bereitgestellt. Die Message bewirkt, dass die Javascript-Datei "hibiscus.script.abcbank.js" beim Start von Jameica automatisch registriert wird. Die Variable "${manifest.pluginDir}" wird hierbei von Jameica automatisch gegen den Installationspfad des Plugins ersetzt. Das Plugin sendet ausserdem eine Message an die Queue "jameica.scripting.add" mit dem Inhalt "${manifest.pluginDir}/hibiscus.script.abcbank.js". Diese Queue wird vom Plugin "jameica.scripting" bereitgestellt. Die Message bewirkt, dass die Javascript-Datei "hibiscus.script.abcbank.js" beim Start von Jameica automatisch registriert wird. Die Variable "${manifest.pluginDir}" wird hierbei von Jameica automatisch gegen den Installationspfad des Plugins ersetzt.
  
Zeile 47: Zeile 49:
   <license>GPL - http://www.gnu.org/copyleft/gpl.html</license>   <license>GPL - http://www.gnu.org/copyleft/gpl.html</license>
  
-  <requires jameica="2.3.0+">+  <requires jameica="2.4.0+">
     <import plugin="jameica.scripting" version="2.3.0+" />     <import plugin="jameica.scripting" version="2.3.0+" />
-    <import plugin="hibiscus" version="2.3.0+" />+    <import plugin="hibiscus" version="2.4.0+" />
   </requires>   </requires>
  
Zeile 65: Zeile 67:
 Fertig. Die ZIP-Datei kann nun bequem über den Plugin-Manager von Jameica (im Menu zu finden unter Datei->Einstellungen->Plugins) installiert werden. Bei der Installation prüft Jameica selbständig, ob die angegebenen Plugins in den benötigten Versionen vorhanden sind. Fertig. Die ZIP-Datei kann nun bequem über den Plugin-Manager von Jameica (im Menu zu finden unter Datei->Einstellungen->Plugins) installiert werden. Bei der Installation prüft Jameica selbständig, ob die angegebenen Plugins in den benötigten Versionen vorhanden sind.
  
-Nochmal der Hinweis: Das funktioniert erst seit Jameica 2.3 (derzeit Nightly-Build)+Nochmal der Hinweis: Das funktioniert erst seit Jameica 2.4
  
 Beachte bitte auch, die Lizenz-Informationen von Jar-Dateien mitzuliefern, insofern deren Lizenz das verlangt. Beachte bitte auch, die Lizenz-Informationen von Jar-Dateien mitzuliefern, insofern deren Lizenz das verlangt.
  


Impressum | Datenschutz
develop/scripting-plugin.txt · Zuletzt geändert: d.m.Y H:i von willuhn