Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:start [2023/01/26 22:15] – Michael Schlenstedtentwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:start [2024/04/22 09:26] (aktuell) – [Unterverzeichnis: dpkg    OPTIONAL] Michael Schlenstedt
Zeile 1: Zeile 1:
-====== Plugin für den Loxberry entwickeln (ab Version 1.x) ======+====== Plugin für den Loxberry entwickeln ======
  
 <do Prof.Mobilux>HELP-Link in der plugin.cfg ergänzen</do> <do Prof.Mobilux>HELP-Link in der plugin.cfg ergänzen</do>
- 
-<do Prof.Mobilux>Mögichkeit apt-Dateien abhängig von der LB Major-Version zu verwenden, ergänzen. Erst ab LB3.0</do> 
- 
-<do Prof.Mobilux>Neue Möglichkeiten für Skripte (verschiedene Dateiendungen, ohne Endung, mehrere Skripte pro Typ) ergänzen</do> 
- 
-<WRAP center round tip 100%> 
- 
-== Plugin-Interface V2 == 
- 
-Diese Beschreibung erklärt die Erstellung eines Plugins mit dem **Plugin-Interface V2**, welches erst ab //LoxBerry V1.x// zur Verfügung steht. Plugins mit **Plugin-Interface V2** sind //nicht// kompatibel mit //LoxBerry V0.2.x//. 
- 
-</WRAP> 
  
 Der LoxBerry kann über Plugins erweitert werden. Plugins bestehen aus einer Reihe von Dateien in einem Standard-ZIP-Archiv, die bei der Installation an die notwendigen Orte im Dateisystem des LoxBerry kopiert werden. Bei diesen Dateien kann es sich z. B. um PHP- oder CGI-Skriptdateien handeln. Des weiteren kann durch das Plugin Software aus dem Software-Repository der Linuxdistribution  auf dem LoxBerry nachinstalliert werden. Der LoxBerry kann über Plugins erweitert werden. Plugins bestehen aus einer Reihe von Dateien in einem Standard-ZIP-Archiv, die bei der Installation an die notwendigen Orte im Dateisystem des LoxBerry kopiert werden. Bei diesen Dateien kann es sich z. B. um PHP- oder CGI-Skriptdateien handeln. Des weiteren kann durch das Plugin Software aus dem Software-Repository der Linuxdistribution  auf dem LoxBerry nachinstalliert werden.
Zeile 71: Zeile 59:
   - Installation der Datei "sudoers/sudoers" nach LBHOMEDIR/system/sudoers   - Installation der Datei "sudoers/sudoers" nach LBHOMEDIR/system/sudoers
   - Installation zusätzlicher Pakete aus dem Distributions-Repository mit apt-get aus der Datei dpkg/apt   - Installation zusätzlicher Pakete aus dem Distributions-Repository mit apt-get aus der Datei dpkg/apt
-  - Nur Raspberry-Architektur: Installation zusätzlicher mitgelieferter DEB-Pakete aus dem Verzeichnis dpkg/raspberry +  - Installation zusätzlicher mitgelieferter DEB-Pakete aus dem Verzeichnis dpkg/<arch>
-  - Nur X86-Architektur: Installation zusätzlicher mitgelieferter DEB-Pakete aus dem Verzeichnis dpkg/x86 +
-  - Nur X64-Architektur: Installation zusätzlicher mitgelieferter DEB-Pakete aus dem Verzeichnis dpkg/x64+
   - Ausführen der Datei "postinstall.sh" mit Userrechten (loxberry)   - Ausführen der Datei "postinstall.sh" mit Userrechten (loxberry)
   - Nur bei Update: Ausführen der Datei "postupgrade.sh" mit Userrechten (loxberry)   - Nur bei Update: Ausführen der Datei "postupgrade.sh" mit Userrechten (loxberry)
Zeile 95: Zeile 81:
 </code> </code>
  
-|  | Key  | Value  |+|   | Key  | Value  |
 | 1 | NAME | Legt den Namen des Autors oder der Projektgruppe fest. | | 1 | NAME | Legt den Namen des Autors oder der Projektgruppe fest. |
 | 2 | EMAIL | Email-Adresse des Autors oder der Projektgruppe  | | 2 | EMAIL | Email-Adresse des Autors oder der Projektgruppe  |
Zeile 135: Zeile 121:
 </code> </code>
  
-|  | Key  | Value  |+|   | Key  | Value  |
 | 1 | VERSION | Version des Plugins. Kann verwendet werden um spezielle Aktionen bei einem Update auszuführen (siehe unten). Wird zudem in der Plugin-Verwatung des LoxBerry angezeigt.\\ \\ Die Version muss eine [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:versionsnummern_von_plugins|korrekte Versionssyntax]] verwenden, andernfalls wird das Plugin bei automatischen Plugin-Updates ausgelassen!  | | 1 | VERSION | Version des Plugins. Kann verwendet werden um spezielle Aktionen bei einem Update auszuführen (siehe unten). Wird zudem in der Plugin-Verwatung des LoxBerry angezeigt.\\ \\ Die Version muss eine [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:versionsnummern_von_plugins|korrekte Versionssyntax]] verwenden, andernfalls wird das Plugin bei automatischen Plugin-Updates ausgelassen!  |
 | 2 | NAME  | Kurzer Plugin-Name. Keine Leerzeichen, keine Sonderzeichen, nur Kleinbuchstaben! Dieser Name wird als Dateiname verwendet, wenn z. B. in zentralen Ordnern (Cron, Daemon, siehe unten) Skripte für das Plugin angelegt werden sollen. Dieser Name muss im System einzigartig sein. Wenn festgestellt wird, dass bereits ein Plugin installiert ist, welches den gleichen Namen verwendet, wird bei der Installation automatisch "01", "02" usw. angehängt. //Wir empfehlen, NAME und FOLDER gleich zu setzen.// | | 2 | NAME  | Kurzer Plugin-Name. Keine Leerzeichen, keine Sonderzeichen, nur Kleinbuchstaben! Dieser Name wird als Dateiname verwendet, wenn z. B. in zentralen Ordnern (Cron, Daemon, siehe unten) Skripte für das Plugin angelegt werden sollen. Dieser Name muss im System einzigartig sein. Wenn festgestellt wird, dass bereits ein Plugin installiert ist, welches den gleichen Namen verwendet, wird bei der Installation automatisch "01", "02" usw. angehängt. //Wir empfehlen, NAME und FOLDER gleich zu setzen.// |
Zeile 170: Zeile 156:
 # plugin do not use any special features of an architecture. # plugin do not use any special features of an architecture.
 # PUT in QUOTES ""!!! # PUT in QUOTES ""!!!
-# Please check http://www.loxwiki.eu:80/x/VoU_AQ section 5.1 for supported +ARCHITECTURE="aarch64,x86_64"
-# architectures and strings you should use here. +
-ARCHITECTURE="raspberry,x86"+
  
 # If you are using the LoxBerry::Log Modul in PHP or Perl and you would like to use User-defined loglevels, # If you are using the LoxBerry::Log Modul in PHP or Perl and you would like to use User-defined loglevels,
Zeile 183: Zeile 167:
 </code> </code>
  
-|  | Key  | Value  |  |+|   | Key  | Value  |   |
 | 1 | REBOOT  | Wenn true, wird nach der Plugin-Installation zum Reboot aufgefordert. Mögliche Werte: true | false  | | 1 | REBOOT  | Wenn true, wird nach der Plugin-Installation zum Reboot aufgefordert. Mögliche Werte: true | false  |
 | 2 | LB_MINIMUM  | Minimalversion des LoxBerry, ab der das Plugin lauffähig ist, z. B. 1.0.1. Mögliche Werte: Versionstring | false  | | 2 | LB_MINIMUM  | Minimalversion des LoxBerry, ab der das Plugin lauffähig ist, z. B. 1.0.1. Mögliche Werte: Versionstring | false  |
 | 3 | LB_MAXIMUM  | Maximalversion des LoxBerry, bis zu der das Plugin lauffähig ist, z. B. 1.0.1. Mögliche Werte: Versionstring | false  | | 3 | LB_MAXIMUM  | Maximalversion des LoxBerry, bis zu der das Plugin lauffähig ist, z. B. 1.0.1. Mögliche Werte: Versionstring | false  |
-| 4 | ARCHITECTURE  | Falls das Plugin nur auf bestimmten Hardware-Plattformen lauffähig ist (z. B. weil es die GPIOs des Raspberry voraussetzt), kann das hier angegeben werden. Mehrere Plattformen können durch Kommata getrennt werden. Aktuell unterstützt: raspberry, x86 und x64.  |  |+| 4 | ARCHITECTURE  | Falls das Plugin nur auf bestimmten Hardware-Plattformen lauffähig ist (z. B. weil es die GPIOs des Raspberry voraussetzt), kann das hier angegeben werden. Mehrere Plattformen können durch Kommata getrennt werden. Aktuell unterstützt: %%armv6l, armv7l, aarch64, x86_64, riscv64. Es wird das Kürzel erwartet, welches der Befehl "uname -m" zurückliefert. Siehe auch: %%[[https://github.com/MichaIng/DietPi/blob/master/dietpi/func/dietpi-obtain_hw_model|https://github.com/MichaIng/DietPi/blob/master/dietpi/func/dietpi-obtain_hw_model]]  |   |
 | 5 | CUSTOM_LOGLEVELS | Wenn true, wird im Plugin Management Widget dem User eine Auswahl an verschiedenen Loglevels angezeigt. Kann in Verbindung mit den LoxBerry Libraries LoxBerry::Log verwendet werden, siehe [[entwickler:perl_develop_plugins_with_perl:perl_loxberry_sdk_dokumentation:perlmodul_loxberrylog:start|Perl-Modul LoxBerry::Log]] bzw. [[entwickler:php_develop_plugins_with_php:php_loxberry_sdk_documentation:php_module_loxberry_logphp:start|PHP Module loxberry_log.php]]. Es kann auch als Ersatz einer eigenen Loglevel-Einstellung im Plugin verwendet werden, siehe [[entwickler:perl_develop_plugins_with_perl:perl_loxberry_sdk_dokumentation:perlmodul_loxberrysystem:loxberrysystempluginloglevel|LoxBerry::System::pluginloglevel]] bzw. [[entwickler:php_develop_plugins_with_php:php_loxberry_sdk_documentation:php_module_loxberry_systemphp:lbsystempluginloglevel|LBSystem::pluginloglevel]]. Mögliche Werte: true | false | | 5 | CUSTOM_LOGLEVELS | Wenn true, wird im Plugin Management Widget dem User eine Auswahl an verschiedenen Loglevels angezeigt. Kann in Verbindung mit den LoxBerry Libraries LoxBerry::Log verwendet werden, siehe [[entwickler:perl_develop_plugins_with_perl:perl_loxberry_sdk_dokumentation:perlmodul_loxberrylog:start|Perl-Modul LoxBerry::Log]] bzw. [[entwickler:php_develop_plugins_with_php:php_loxberry_sdk_documentation:php_module_loxberry_logphp:start|PHP Module loxberry_log.php]]. Es kann auch als Ersatz einer eigenen Loglevel-Einstellung im Plugin verwendet werden, siehe [[entwickler:perl_develop_plugins_with_perl:perl_loxberry_sdk_dokumentation:perlmodul_loxberrysystem:loxberrysystempluginloglevel|LoxBerry::System::pluginloglevel]] bzw. [[entwickler:php_develop_plugins_with_php:php_loxberry_sdk_documentation:php_module_loxberry_systemphp:lbsystempluginloglevel|LBSystem::pluginloglevel]]. Mögliche Werte: true | false |
-| 6 | INTERFACE  | Die Interface-Version, für die das Plugin entwickelt wurde. Wenn Du die Features aus dieser anleitung verwenden möchtest, muss hier 2.0 eingetragen werden.  |  |+| 6 | INTERFACE  | Die Interface-Version, für die das Plugin entwickelt wurde. Wenn Du die Features aus dieser anleitung verwenden möchtest, muss hier 2.0 eingetragen werden.  |   |
  
 **4. Block: AUTOUPDATE** **4. Block: AUTOUPDATE**
Zeile 214: Zeile 198:
 </code> </code>
  
-|  | Key  | Value  |  |+|   | Key  | Value  |   |
 | 1 | AUTOMATIC_UPDATES | Legt fest, ob das Plugin die AutoUpdate-Funktion zur Verfügung stellt oder nicht. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]] Mögliche Werte: true | false | | 1 | AUTOMATIC_UPDATES | Legt fest, ob das Plugin die AutoUpdate-Funktion zur Verfügung stellt oder nicht. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]] Mögliche Werte: true | false |
-| 2 | RELEASECFG  | Eine URL, unter der die Datei mit den Einstellungen zum Release vom System heruntergeladen werden kann. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]]  |  | +| 2 | RELEASECFG  | Eine URL, unter der die Datei mit den Einstellungen zum Release vom System heruntergeladen werden kann. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]]  |   | 
-| 3 | PRERELEASECFG  | Eine URL, unter der die Datei mit den Einstellungen zum PreRelease vom System heruntergeladen werden kann. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]]  |  |+| 3 | PRERELEASECFG  | Eine URL, unter der die Datei mit den Einstellungen zum PreRelease vom System heruntergeladen werden kann. Details hier: [[entwickler:plugin_fur_den_loxberry_entwickeln_ab_version_1x:plugin_autoupdate_function_for_plugins|AutoUpdate Funktion für Plugins]]  |   |
  
 ====== Rootverzeichnis - Datei: preroot.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: preroot.sh    OPTIONAL ======
  
-Bei der Datei //preroot.sh// handelt es sich um ein Shell-Skript, welches vor der Installation ausgeführt wird. Die Datei wird mit Root-Rechten ausgeführt, hat also umfangreiche Rechte im System. Sie sollte nur verwendet werden, wenn unbedingt Kommandos als User root ausgeführt werden müssen. Ansonsten sollte man das Skript "preinstall.sh" verwenden (siehe unten). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor der Installation als Benutzer "root" ausgeführt. Es kann verwendet werden um Dinge für die Installation vorzubereiten oder Kommandos auf dem System auszuführen.+Bei der Datei //preroot.sh// handelt es sich um ein Shell-Skript, welches vor der Installation ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein). Die Datei wird mit Root-Rechten ausgeführt, hat also umfangreiche Rechte im System. Sie sollte nur verwendet werden, wenn unbedingt Kommandos als User root ausgeführt werden müssen. Ansonsten sollte man das Skript "preinstall.sh" verwenden (siehe unten). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor der Installation als Benutzer "root" ausgeführt. Es kann verwendet werden um Dinge für die Installation vorzubereiten oder Kommandos auf dem System auszuführen.
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 345: Zeile 329:
 ====== Rootverzeichnis - Datei: preupgrade.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: preupgrade.sh    OPTIONAL ======
  
-Bei der Datei //preupgrade.sh// handelt es sich um ein Shell-Skript, welches vor der Installation und nur im Falle eines Plugin-Updates ausgeführt wird. D. h. das Plugin muss schon auf dem System existieren, damit dieses Skript bei der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor einem Update als Benutzer "loxberry" ausgeführt. Es kann verwendet werden, um im Falle eines Updates Konfigurationsdateien des Plugins zu sichern. +Bei der Datei //preupgrade.sh// handelt es sich um ein Shell-Skript, welches vor der Installation und nur im Falle eines Plugin-Updates ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein).  D. h. das Plugin muss schon auf dem System existieren, damit dieses Skript bei der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor einem Update als Benutzer "loxberry" ausgeführt. Es kann verwendet werden, um im Falle eines Updates Konfigurationsdateien des Plugins zu sichern. 
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 469: Zeile 453:
 ====== Rootverzeichnis - Datei: preinstall.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: preinstall.sh    OPTIONAL ======
  
-Bei der Datei //preinstall.sh// handelt es sich um ein Shell-Skript, welches vor der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor der Installation als Benutzer "loxberry" ausgeführt. Es kann verwendet werden um Dinge für die Installation vorzubereiten oder Kommandos auf dem System auszuführen.+Bei der Datei //preinstall.sh// handelt es sich um ein Shell-Skript, welches vor der Installation ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird vor der Installation als Benutzer "loxberry" ausgeführt. Es kann verwendet werden um Dinge für die Installation vorzubereiten oder Kommandos auf dem System auszuführen.
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 591: Zeile 575:
 ====== Rootverzeichnis - Datei: postinstall.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: postinstall.sh    OPTIONAL ======
  
-Bei der Datei //postinstall.sh// handelt es sich um ein Shell-Skript, welches nach der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach der Installation als Benutzer "loxberry" ausgeführt. Es kann verwendet werden um Dinge nach der Installation aufzubereiten oder Kommandos auf dem System auszuführen.+Bei der Datei //postinstall.sh// handelt es sich um ein Shell-Skript, welches nach der Installation ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach der Installation als Benutzer "loxberry" ausgeführt. Es kann verwendet werden um Dinge nach der Installation aufzubereiten oder Kommandos auf dem System auszuführen.
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 714: Zeile 698:
 ====== Rootverzeichnis - Datei: postupgrade.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: postupgrade.sh    OPTIONAL ======
  
-Bei der Datei //postupgrade.sh// handelt es sich um ein Shell-Skript, welches nach der Installation und nur im Falle eines Plugin-Updates ausgeführt wird. D. h. das Plugin muss schon auf dem System existieren, damit dieses Skript nach der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach einem Update als Benutzer "loxberry" ausgeführt. Es kann verwendet werden, um im Falle eines Updates Konfigurationsdateien des Plugins nach der Installation wieder zurückzuspielen. +Bei der Datei //postupgrade.sh// handelt es sich um ein Shell-Skript, welches nach der Installation und nur im Falle eines Plugin-Updates ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein). D. h. das Plugin muss schon auf dem System existieren, damit dieses Skript nach der Installation ausgeführt wird. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach einem Update als Benutzer "loxberry" ausgeführt. Es kann verwendet werden, um im Falle eines Updates Konfigurationsdateien des Plugins nach der Installation wieder zurückzuspielen. 
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 838: Zeile 822:
 ====== Rootverzeichnis - Datei: postroot.sh    OPTIONAL ====== ====== Rootverzeichnis - Datei: postroot.sh    OPTIONAL ======
  
-Bei der Datei //postroot.sh// handelt es sich um ein Shell-Skript, welches nach der Installation ausgeführt wird. Die Datei wird mit Root-Rechten ausgeführt, hat also umfangreiche Rechte im System. Sie sollte nur verwendet werden, wenn unbedingt Kommandos als User root ausgeführt werden müssen. Ansonsten sollte man das Skript "postinstall.sh" verwenden (siehe oben). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach der Installation als Benutzer "root" ausgeführt. Es kann verwendet werden um Dinge nach der Installation aufzubereiten oder Kommandos auf dem System auszuführen.+Bei der Datei //postroot.sh// handelt es sich um ein Shell-Skript, welches nach der Installation ausgeführt wird. Ab LoxBerry 3.0 sind auch andere Dateiendungen erlaubt (zum Beispiel .pl oder .py - in diesem Fall muss der Shebang im Skript korrekt gesetzt sein). Die Datei wird mit Root-Rechten ausgeführt, hat also umfangreiche Rechte im System. Sie sollte nur verwendet werden, wenn unbedingt Kommandos als User root ausgeführt werden müssen. Ansonsten sollte man das Skript "postinstall.sh" verwenden (siehe oben). Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Das Skript wird nach der Installation als Benutzer "root" ausgeführt. Es kann verwendet werden um Dinge nach der Installation aufzubereiten oder Kommandos auf dem System auszuführen.
  
 Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können: Dem Skript werden auf der Kommandozeile folgende Parameter übergeben, die innerhalb des Bashskripts verwendet werden können:
Zeile 1116: Zeile 1100:
 ====== Unterverzeichnis: dpkg    OPTIONAL ====== ====== Unterverzeichnis: dpkg    OPTIONAL ======
  
-Über dieses Unterverzeichnis können vom Plugin fehlende Softwarepakete nachinstalliert werden. Hierbei kann sowohl auf Stadardpakete aus dem Raspbian Repository zurückgegriffen werden (dringend empfohlen!) oder (im Notfall) auch direkt DEB-Pakete mitgeliefert werden.+Über dieses Unterverzeichnis können vom Plugin fehlende Softwarepakete nachinstalliert werden. Hierbei kann sowohl auf Standardpakete aus dem Raspbian Repository zurückgegriffen werden (dringend empfohlen!) oder (im Notfall) auch direkt DEB-Pakete mitgeliefert werden.
  
 **Software aus dem Standard Raspbian Repository:** **Software aus dem Standard Raspbian Repository:**
Zeile 1122: Zeile 1106:
 Hierzu muss im Verzeichnis die Datei "''%%apt%%''" existieren. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Kommentare werden durch eine vorangestellte Raute eingeleitet und bei der Interpretation der Datei ignoriert. Jedes zu installierende Paket muss in einer separaten Zeile eingetragen werden. Hierzu muss im Verzeichnis die Datei "''%%apt%%''" existieren. Es handelt sich um eine ASCII-Datei im Unix-Dateiformat (Zeilenende: Linefeed, LF). Kommentare werden durch eine vorangestellte Raute eingeleitet und bei der Interpretation der Datei ignoriert. Jedes zu installierende Paket muss in einer separaten Zeile eingetragen werden.
  
-Vor Installation der Pakete wird der Befehl  ''%%apt-get -q -y update%%'' sowie der Befehl dpkg --configure -a ausgeführt, um die Paketquellen zu aktualisieren. Dieses geschieht allerdings nur einmal täglich. Anschließend werden alle Pakete gemeinsam an den Befehl ''%%apt-get -q -y install%%'' weitergeleitet und somit die Pakete installiert.+Es ist auch möglich, abhängig von der **LoxBerry** Major-Versionsnummer unterschiedliche Pakete zu installieren. Dazu wird die Major Versionsnummer an den Dateinamen der apt-Datei angehängt, also z. B.  "''%%apt3%%''" für LoxBerry 3.x, "''%%apt2%%''" für LoxBerry 2.x usw. //Dieser Weg ist mittlerweile obsolete - siehe nächsten Abschnitt.//
  
-Wenn vom Plugin keine zusätzlichen Pakete benötigt werden, ist es ratsam die Datei //apt// zu löschen und nicht im Pluginarchiv zur Verfügung zu stellen. So wird die Installation des Plugins deutlich beschleunigt, da bei Existenz der Datei auf jeden Fall der Befehl zum Aktualisieren der Paketquellen ausgeführt wird (egal, ob anschließend ein Paket installiert werden soll oder nicht). Die Aktualisierung der Paketquellen dauert je nach Internetverbindung mehrere Sekunden bis Minuten, sodass es zu einer deutlichen Verzögerung während der Installation des Plugins kommt.+Zusätzlich ist es auch möglich, abhängig von der **Debian** Major-Versionsnummer unterschiedliche Pakete zu installieren. Diese Änderung war notwendig, weil nicht mehr zwingend anhand der LoxBerry Major-Versionsnummer auf die darunter liegende Debian-Versionsnummer geschlossen werden kann (seit DietPi kann z. B. LoxBerry 3.0 auf unterschiedlichen Distributionsversionen laufen). Dazu wird die Debian Major Versionsnummer an den Dateinamen der apt-Datei angehängt, also z. B.  "''%%apt11%%''" für Debian 11 (Bullseye), "''%%apt12%%''" für Debian 12 (Bookworm) usw. 
 + 
 +Vor Installation der Pakete wird der Befehl  ''%%apt-get -q -y update%%'' sowie der Befehl ''dpkg --configure -a'' ausgeführt, um die Paketquellen zu aktualisieren. Anschließend werden alle Pakete gemeinsam an den Befehl ''%%apt-get -q -y install%%'' weitergeleitet und somit die Pakete installiert. 
 + 
 +Wenn vom Plugin keine zusätzlichen Pakete benötigt werden, ist es ratsam die Datei ''apt'' zu löschen und nicht im Pluginarchiv zur Verfügung zu stellen. So wird die Installation des Plugins deutlich beschleunigt, da bei Existenz der Datei auf jeden Fall der Befehl zum Aktualisieren der Paketquellen ausgeführt wird (egal, ob anschließend ein Paket installiert werden soll oder nicht). Die Aktualisierung der Paketquellen dauert je nach Internetverbindung mehrere Sekunden bis Minuten, sodass es zu einer deutlichen Verzögerung während der Installation des Plugins kommt.
  
 **Beispiel: Datei apt** **Beispiel: Datei apt**
Zeile 1139: Zeile 1127:
 **Software aus selbst mitgelieferten DEB-Paketen:** **Software aus selbst mitgelieferten DEB-Paketen:**
  
-Möchte man direkt DEB-Pakete mitliefern, z. B. weil die benötigte Software im Standard-Repository nicht zur Verfügung steht, muss für jede Hardware-Architektur ein entsprechendes Unterverzeichnis angelegt werden:+Möchte man direkt DEB-Pakete mitliefern, z. B. weil die benötigte Software im Standard-Repository nicht zur Verfügung steht, muss für jede Hardware-Architektur ein entsprechendes Unterverzeichnis angelegt werden, in dem dann die DEB-Pakete liegen. Es werden dabei Verzeichnisse mit dem Architektur-Namen erwartet, die auch der Befehl uname -m zurückliefert. Mit DietPi wurden die unterstützten Architekturen erweitert (ab LoxBerry 3.0). Aktuell (Stand: 07.03.2023) sind das:
  
-| Architektur | Unterverzeichnis | +^ Architektur ^ Unterverzeichnis ^ Beispiel ^ 
-| Raspberry  | ''%%raspberry%%'' | +| %%Armv6l%%  | ''%%armv6l%%'' | Raspberry 1 oder Zero | 
-| X86  | ''%%x86%%''  | +| %%Armv7l%%  | ''%%armv7l%%''  | Raspberry 2 Rev. 1 | 
-| X64  | ''%%x64%%''  |+| %%Aarch64 bzw. Arm64%%  | ''%%aarch64%%''  | Raspberry 2-4 und Zero2 | 
 +| %%x86_64%% | ''%%x86_64%%'' | Virtual Box VM (u. a.) | 
 +| %%Riscv64%% | ''%%riscv64%%'' |   |
  
 In die Unterverzeichnisse werden dann die DEB-Pakete direkt abgelegt. Diese werden auf der jeweiligen Hardware-Plattform in alphabetischer Reihenfolge per ''%%dpkg -i%%'' installiert. In die Unterverzeichnisse werden dann die DEB-Pakete direkt abgelegt. Diese werden auf der jeweiligen Hardware-Plattform in alphabetischer Reihenfolge per ''%%dpkg -i%%'' installiert.
 +
  
 ====== Besonderheiten / Hinweise ====== ====== Besonderheiten / Hinweise ======