MLD - Addons erstellen

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Aufbau)
(Aufbau)
Zeile 1: Zeile 1:
 
== Aufbau ==
 
== Aufbau ==
  
Addons haben einen sehr einfachen Aufbau. Jede entahltene Datei ist im Addon so platziert, wie sie nach der Installation auch im root Filesystem plaziert sein soll. Enthält ein Addon z.B. das Script myScript und soll dieses im Ordner /usr/bin plaziert werden, so ist es auch im Addon unter usr/bin/myScript zu finden. Addons sind also einfach dadurch zu erstellen, das man einen Ordner mit dem namen des Addons erstellt, alles so da drinn plaziert wie es später im root Filesystem plaziert werden soll, und anschließend diesen Ordner kompremiert.
+
Addons haben einen sehr einfachen Aufbau. Jede enthaltene Datei ist im Addon so platziert, wie sie nach der Installation auch im root Filesystem plaziert sein soll. Enthält ein Addon z.B. das Script myScript und soll dieses im Ordner /usr/bin plaziert werden, so ist es auch im Addon unter usr/bin/myScript zu finden. Addons sind also einfach dadurch zu erstellen, das man einen Ordner mit dem namen des Addons erstellt, alles so da drinn plaziert wie es später im root Filesystem plaziert werden soll, und anschließend diesen Ordner kompremiert.
  
 
Es gibt jedoch einige kleinigkeiten zu beachten:
 
Es gibt jedoch einige kleinigkeiten zu beachten:

Version vom 23. Juni 2006, 22:02 Uhr

Inhaltsverzeichnis

Aufbau

Addons haben einen sehr einfachen Aufbau. Jede enthaltene Datei ist im Addon so platziert, wie sie nach der Installation auch im root Filesystem plaziert sein soll. Enthält ein Addon z.B. das Script myScript und soll dieses im Ordner /usr/bin plaziert werden, so ist es auch im Addon unter usr/bin/myScript zu finden. Addons sind also einfach dadurch zu erstellen, das man einen Ordner mit dem namen des Addons erstellt, alles so da drinn plaziert wie es später im root Filesystem plaziert werden soll, und anschließend diesen Ordner kompremiert.

Es gibt jedoch einige kleinigkeiten zu beachten:

  • Nach dem Installieren des Addons wird das script tmp/install ausgeführt, sofern es im Addon enthalten ist.
    • mit 'register_setting' lässt sich eine Konfigurations Variable in rc.config anlegen
    • mit 'register_config' lässt sich eine Configurationsdatei so speichern, das diese dauerhaft editierbar ist (dies geht auch mit Ordnern)
  • vor dem deinstallieren eines Addons wird das Script tmp/uninstall ausgeführt
  • Konfigurationsdatein die dauerhaft editierbar sein sollen müssen im Ordner tmp abgelegt und mit 'register_config' installiert werden.
    • dadurch werden die Datein im Konfigurationsverzeichnis auf der Festplatte abgelegt und nach /etc verlinkt
  • Scripte die im Ordnet etc/rc.d abgelegt sind und vom Ordner etc/rc.d/boot.d verlinkt sind werden bei jedem Systemstart/Shutdown ausgeführt.
    • die Scripte in etc/rc.d haben den Namen des Addons
    • die Namen der Links in etc/rc.d/boot.d beginnen mit einem S wenn diese beim Systemstart, oder mit einem K wenn sie beim Shutdown ausgeführt werden sollen. Es folgt eine zweistellige Nummer welche die Reihenfolge regelt in der die Scripte ausgeführt werden sollen, und der Name des addons (Bsp.: S13addonname, K45addonname).
  • Abhängikeiten von anderen Addons werden in tmp/depend eingetragen, wobei jede Zeile den Namen eines Addons enthält
  • jedes Addon sollte eine Documentation enthalten die unter usr/share/doc abgelegt wird und dessen Name mit README beginnt und nach einem Punkt den Namen des Addons enthält (Bsp.: README.addonname).

MLD-0.4.x

  • Das Script INSTALL übernimmt die Aufgaben von tmp/install, tmp/uninstall und tmp/depend. Dafür wird es mit den Parametern 'install', 'uninstall' oder 'depend' aufgerufen.
  • Zusätzlich zur README Datei gibt es eine HISTORY Datei. Diese beschreibt alle am Addon vorgenommenen Änderungen.

Installation

Alle im Ordner /etc/addons liegenden Addons werden bei jedem Systemstart installiert, da das Filesystem bei jedem Systemstart neu eingerichtet wird. Eine Ausname ergibt sich wenn die FastBoot Option aktiviert ist. Nachdem alle Addons Installiert wurden, werden alle unter /etc/rc.d/boot.d liegenden Startscripte ausgeführt.

Mit dem apm Tool (addon packet manager) können Addons von Hand De-/Installiert werden. Hierbei wird nur das un-/install script aufgerufen, nicht aber die Startscripte.

FastBoot

Bei Aktiviertem FastBoot wird das Filesystem nur dann neu eingerichtet und die Addons installiert, wenn sich etwas an der Zusammenstellung der Addons geändert hat. Andernfalls wird mit einem Abbild des Filesystems gearbeitet das Direkt nach dem Installieren der Addons erstellt wurde.

So werden dann auch nicht die im Addon enthaltenen tmp/install Scripte ausgeführt, sondern lediglich die unter /etc/rc.d/boot.d liegenden Startscripte. Aus diesem Grund muss das Laden von Treibern und das Starten von Demons im Startscript erfolgen.