Benutzer-Werkzeuge

Webseiten-Werkzeuge


develop:repository

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
develop:repository [d.m.Y H:i] – angelegt willuhndevelop:repository [d.m.Y H:i] (aktuell) – [FAQ] willuhn
Zeile 1: Zeile 1:
 ===== Aufbau eines Online-Repositories für Jameica-Plugins ===== ===== Aufbau eines Online-Repositories für Jameica-Plugins =====
  
-mit einem [[http://www.willuhn.de/projects/jameica/?page=download_ext|Nightly-Build]] ab 17.12.2008 und Installation des Plugins [[http://www.willuhn.de/projects/jameica/releases/nightly/jameica.update-1.0-nightly.zip|jameica.update]] können Jameica-Plugins nun auch online installiert werden. Siehe hierzu der Blog-Beitrag [[http://www.willuhn.de/blog/index.php?/archives/435-Online-Updates-fuer-Jameica-Plugins.html|Online-Updates für Jameica-Plugins]].+Der in Jameica integrierte Plugin-Manager (zu finden im Menü unter "Datei->Einstellungen->Plugins") bietet die Möglichkeit, neben den "ab Werk" vorhandenen Plugin-Quellen (Repositories) weitere eigene hinzuzufügen.
  
-Neben dem initial eingerichteten Repository "https://www.willuhn.de/projects/jameica/updates" können noch beliebige weitere Repositories hinzugefügt werden. Diese Anleitung beschreibt den Aufbau eines solchen Repositories.+Diese Anleitung beschreibt den Aufbau eines solchen Repositories.
  
 ==== Grundlagen ==== ==== Grundlagen ====
Zeile 15: Zeile 15:
 <code xml> <code xml>
 <?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
-<repository xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
-            xsi:noNamespaceSchemaLocation="http://www.willuhn.de/schema/jameica-repository-1.0.xsd" 
-            name="Updates fuer Jameica-Plugins"> 
  
-  <plugins> +<repository xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/jameica.webadmin/> +  xsi:noNamespaceSchemaLocation="http://www.willuhn.de/schema/jameica-repository-1.0.xsd
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/jameica.xmlrpc/> +  name="Updates für Jameica-Plugins">
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/jameica.soap/>+
  
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/hibiscus/1.8" /> +   <plugins name="Jameica" certificate="https://www.willuhn.de/products/jameica/updates/jameica.update-pem.crt"> 
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/hibiscus/1.9" /> +     <plugin url="https://www.willuhn.de/products/jameica/updates/jameica.webadmin" /> 
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/hibiscus.xmlrpc" />+     <plugin url="https://www.willuhn.de/products/jameica/updates/jameica.xmlrpc" /> 
 +     [...] 
 +   </plugins> 
 +    
 +   <plugins name="Hibiscus" certificate="https://www.willuhn.de/products/jameica/updates/jameica.update-pem.crt"> 
 +     <plugin url="https://www.willuhn.de/products/jameica/updates/hibiscus/1.12" /> 
 +     <plugin url="https://www.willuhn.de/products/jameica/updates/hibiscus/1.13-nightly" /> 
 +     <plugin url="https://www.willuhn.de/products/jameica/updates/hibiscus.xmlrpc" /
 +   </plugins>
  
-    <plugin url="https://www.willuhn.de/projects/jameica/updates/syntax" /> +   <plugins name="SynTAX" certificate="https://www.willuhn.de/products/jameica/updates/jameica.update-pem.crt"> 
-  </plugins>+     <plugin url="https://www.willuhn.de/products/jameica/updates/syntax/1.6" /> 
 +     <plugin url="https://www.willuhn.de/products/jameica/updates/syntax/1.7-nightly" /> 
 +   </plugins> 
 +   
 </repository> </repository>
 </code> </code>
Zeile 36: Zeile 43:
  
 <code xml> <code xml>
-<repository ... name="Updates fuer Jameica-Plugins">+<repository ... name="Updates für Jameica-Plugins">
 </code> </code>
  
-| name | Legt den Namen des Repositories fest. |+| name | Bezeichnung des Repositories. |
  
  
Zeile 45: Zeile 52:
  
 <code xml> <code xml>
-<plugins+<plugins name="Jameica" certificate="https://www.willuhn.de/products/jameica/updates/jameica.update-pem.crt">
-  [...] +
-  <plugin url="https://www.willuhn.de/projects/jameica/updates/jameica.webadmin/>+
   [...]   [...]
 </plugins> </plugins>
 </code> </code>
  
-| plugins | Container-Element, welches die Liste der Plugins enthält. |+| plugins     | Container-Element, welches eine Liste von Plugins enthält. Das Element darf mehrfach vorkommen, falls das Repository mehrere Gruppen von Plugins enthält. | 
 +| name        | Optionale Angabe eines Namens für die Gruppe der Plugins. | 
 +| certificate | Optionale Angabe der URL eines PEM/DER-codierten Aussteller-Zertifikates, mit dem die Plugins signiert sind. | 
 + 
 +=== Plugin === 
 + 
 +<code xml> 
 +[...] 
 +<plugin url="https://www.willuhn.de/products/jameica/updates/jameica.webadmin" /> 
 +[...] 
 +</code> 
 | plugin  | Ein einzelnes Plugin | | plugin  | Ein einzelnes Plugin |
 | url     | URL zum Plugin-Verzeichnis. In diesem Verzeichnis muss sich die "plugin.xml" des Plugins befinden. | | url     | URL zum Plugin-Verzeichnis. In diesem Verzeichnis muss sich die "plugin.xml" des Plugins befinden. |
Zeile 67: Zeile 83:
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.willuhn.de/schema/jameica-plugin http://www.willuhn.de/schema/jameica-plugin-1.0.xsd"         xsi:schemaLocation="http://www.willuhn.de/schema/jameica-plugin http://www.willuhn.de/schema/jameica-plugin-1.0.xsd"
-        name="hibiscus" version="1.9" class="de.willuhn.jameica.hbci.HBCI">+        name="hibiscus" version="1.12" class="de.willuhn.jameica.hbci.HBCI">
  
   <description>HBCI-Onlinebanking-Plugin für Jameica</description>   <description>HBCI-Onlinebanking-Plugin für Jameica</description>
-  <url>https://www.willuhn.de/projects/hibiscus/releases/nightly/hibiscus-1.9-nightly.zip</url>+  <url>https://www.willuhn.de/products/hibiscus/releases/1.12/hibiscus.zip</url>
   [...]   [...]
 </plugin> </plugin>
Zeile 78: Zeile 94:
  
 Die "plugin.xml" kann weiterhin Abhängigkeiten zu weiteren Plugins definieren. Das Format ist in [[develop:plugin.xml#dependencies]] beschrieben. Die "plugin.xml" kann weiterhin Abhängigkeiten zu weiteren Plugins definieren. Das Format ist in [[develop:plugin.xml#dependencies]] beschrieben.
 +
  
 ==== Installationsvoraussetzungen für Plugins ==== ==== Installationsvoraussetzungen für Plugins ====
  
-Damit ein Plugin via Online-Update installiert werden kann, müssen folgende Voraussetzungen erfüllt sein. Andernfalls wird der Menu-Eintrag "Herunterladen und installieren..." von Jameica deaktiviert:+Damit ein Plugin via Online-Update installiert werden kann, müssen folgende Voraussetzungen erfüllt sein. Andernfalls wird der Menu-Eintrag "Herunterladen und installieren..." von Jameica deaktiviert bzw. beim Versuch der Installation wird eine Fehlermeldung angezeigt:
  
-  * Plugin darf nicht bereits in einer aktuelleren Version installiert sein. +  * Es muss ein beschreibbarer Plugin-Ordner auf dem Computer des Nutzers vorhanden sein. Entweder direkt im Programmordner oder im Jameica-Benutzerordner. Falls im Programmordner keine Schreibzugriffe für den Benutzer erlaubt sind (weil Jameica z.Bsp. in einem Verzeichnis installiert ist, in dem nur Root/AdministratorSchreibzugriff besitztdann wählt Jameica bei der Installation automatisch den Benutzerordner. Sind beide beschreibbar, zeigt Jameica einen Auswahldialog an, in dem der Nutzer selbst entscheiden kann. 
-  * Plugin darf nicht bereits im System-Plugin-Ordner von Jameica installiert (unter Linux z.Bsp. "/opt/jameica/plugins"), da es dort vom Update-Manager nicht überschrieben werden kann. +  * Falls das Plugin Abhängigkeit zu weiteren Plugins besitzt und diese von Jameica nicht automatisch aufgelöst werden können (Jameica sucht die abhängigen Plugins über alle eingerichteten Repositories und installiert diese automatisch mit), müssen sie vom Benutzer vorher manuell installiert werden.
-  * Falls das Plugin Abhängigkeit zu weiteren Plugins besitzt, müssen diese bereits installiert sein. Eine automatisch Auflösung der Abhängigkeiten ist noch nicht implementiert.+
   * Die in "<requires jameica="$version"> angegebene Jameica-Version muss kompatibel zur installierten Jameica-Version sein.   * Die in "<requires jameica="$version"> angegebene Jameica-Version muss kompatibel zur installierten Jameica-Version sein.
  
Zeile 91: Zeile 107:
 ==== Ablauf der Installation ==== ==== Ablauf der Installation ====
  
-Erfüllt ein Plugin alle Installationsvoraussetzungen, kann es durch den User mittels Rechtsklick und Auswahl des Menueintrages "Herunterladen und installieren..." heruntergeladen werden. Hierbei wird die ZIP-Datei im Benutzer-Ordner ".jameica/deploy" gespeichert. Beim nächsten Start von Jameica überprüft der "DeployService", um sich in diesem Verzeichnis neue zu installierende Plugins befinden. Ist das der Fall, entpackt er sie nach ".jameica/plugins". Ist das Plugin in diesem Verzeichnis bereits in einer gleichen oder älteren Version installiert, wird die Vorversion automatisch gelöscht. Durch das Löschen wird verhindert, dass eine neuere Version über die alte "drüberkopiert" wird und hierbei Programmfragmente der Vorversion erhalten bleiben könnten. Hat der User also manuelle Änderungen am Plugin-Verzeichnis vorgenommen (aus welchen Gründen auch immer), gehen diese hierbei verloren. +Erfüllt ein Plugin alle Installationsvoraussetzungen, kann es durch den User mittels Klick auf "Installieren..." heruntergeladen werden. Hierbei wird die ZIP-Datei im Ordner "deploy" (je nach Auswahl entweder im Jameica-Benutzerordner oder im Programmordner) gespeichert. Beim nächsten Start von Jameica überprüft der "DeployService", ob sich in diesem Verzeichnis neue zu installierende Plugins befinden. Ist das der Fall, entpackt Jameica sie. Ist das Plugin in diesem Verzeichnis bereits in einer gleichen oder älteren Version installiert, wird die Vorversion automatisch gelöscht. Durch das Löschen wird verhindert, dass eine neuere Version über die alte "drüberkopiert" wird und hierbei Programmfragmente der Vorversion erhalten bleiben könnten. Hat der User also manuelle Änderungen am Plugin-Verzeichnis vorgenommen (aus welchen Gründen auch immer), gehen diese hierbei verloren. 
-Plugins werden durch den Download-Manager also nicht im System-Plugin-Ordner (unter Linux "/opt/jameica/plugins") sondern im User-Plugins-Ordner (unter Linux "/home/<username>/.jameica/plugins") installiert.+
  
  
-==== Künftige Erweiterungen ====+==== FAQ ====
  
-  * Das Plugin "jameica.update" soll künftig (voraussichtlich ab Jameica 1.8) direkt Bestandteil von Jameica werden. +  * **Frage** Wie kann ich ein Plugin in mehreren Versionen anbieten?\\ **Antwort** Wenn die [[develop:plugin.xml#dependencies|Plugin-Abhängigkeiten]] korrekt formuliert sindkann das Plugin in verschiedenen Versionen im Repository angeboten werden. Der Update-Manager bietet dem Benutzer dann all jene Versionen an, die zur aktuellen Jameica-Installation des Users kompatibel sind.
-  Der Update-Manager soll künftig auch für die Installation von Patches verwendet werden können. +
-  * Der Update-manager soll um eine Funktion zum automatischen PrüfenHerunterladen und Installieren von Updates erweitert werden. Dies kann intervalloder event-gesteuert (z.Bsp. "täglich" oder "einmalig nach dem Start von Jameica") erfolgen.+


Impressum | Datenschutz
develop/repository.1229529294.txt.gz · Zuletzt geändert: d.m.Y H:i von willuhn