Aufbau der Datei 'INFO'

Einleitung

Die Datei 'INFO' ist ein wichtiger Bestandteil des Synology Paketes (SPK). Mit dieser Datei legt man den Paketnamen und weitere Einstellungen für das Paket-Zentrum fest.

Aufbau

Im folgenden Beispiel sind die minimal notwendigen Parameter mit Beispieldaten aufgeführt.

package="Test"
version="1.0"
description="Test App zum Testen"
maintainer="Nobody"
arch="noarch"

Erklärung der Schlüsselwörter

Jede Zeile enthält ein Parameter mit dem entsprechenden Inhalt.

Parameter	Beschreibnung	Wert/Typ/Beispiel
package	Paketname, wird für die Erstellung des Verzeichnisses in /var/packages verwendet.	alphanumerisch
version	Version des Paketes. Buchstaben sind zwar erlaubt, verhindern aber die Erkennung von Updates (höheren Versionen) durch das Paketzentrum.	alphanumerisch / 1.0-001
description	ausführliche Beschreibung (default Eintrag für alle Sprachen, falls sprachabhängige Beschreibung nicht verfügbar).	alphanumerisch
description_xxx	ausführliche Beschreibung in der jeweiligen Sprache xxx (siehe #Sprachkürzeltabelle).	alphanumerisch
maintainer	Name des Entwicklers	alphanumerisch / Nobody
admin_url	URL der externen Administrationsoberfläche	URL
admin_port	Port der externen Administrationsoberfläche	numerisch
admin_protocol	Protokoll für den Aufruf der externen Administrationsoberfläche. ohne Angabe wird http verwendet.	http und/oder https mit Leerzeichen getrennt
arch	Einschränkung auf eine bestimmte Architektur oder "noarch" (siehe Welchen_Prozessortyp_besitzt_mein_System?).	Architekturen mit Leerzeichen getrennt / 88f6281 88f6282
reloadui	Neuladen/Aktualisierung des Paket-Zentrums nach der Installation.	yes/no
firmware	minimale Firmwarewareversion die für die Installation benötigt wird.	numerisch inkl. - und . / 3.0-1593
*** Neu ab DSM 3.2.1869 beta ***
displayname	erweiterter Name für die Anzeige im Paketzentrum. Ist dieser Parameter nicht vorhanden, wird "package" verwendet.	alphanumerisch
displayname_xxx	erweiterter Name für die Anzeige im Paketzentrum in der jeweiligen Sprache xxx (siehe #Sprachkürzeltabelle).	alphanumerisch
checksum	Wenn vorhanden, wird die Checksumme der package.tgz mit dieser verglichen	MD5-String
checkport	Überprüft, ob ein Konflikt zwischen dem Adminport und einer der vom DSM verwendeten Ports existiert.	yes/no
helpurl	URL zur Homepage/Forum des Entwicklers für Informationen	URL
report_url	URL zur Homepage/Forum des Entwicklers für Pakete mit Beta-Status, aktiviert automatisch den Text "beta" neben dem Namen im Paket-Zentrum und unterhalb des Paketicons der Link "Feedback". Ab DSM 5: Ist support_center="yes", wird dieser Link nicht beachtet (siehe DSM 5 - support_center)	URL
install_reboot	Neustart der DS nach Installation/Aktualisierung eines Paketes. Wenn durch "yes" aktiviert, wird der Parameter "instuninst_restart_services" ignoriert.	yes/no
instuninst_restart_services	Startet die angegeben Dienste nach einer Installation/Aktualisierung oder Deinstallation eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "install_reboot" mit "yes" aktiviert, wird dieser Parameter ignoriert.	Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(z.B. Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
startstop_restart_services	Startet die angegeben Dienste nach dem Ausführen/Stopps eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "startable" mit "no" deaktiviert, wird dieser Parameter ignoriert.	Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
dsmappname	Vor einer Aktualisierung/Deinstallation des Paketes wird das Anwendungsfenster mit dem eindeutigem Namen aus der config geschlossen	alphanumerisch
dsmuidir	Hier wird das Verzeichnis für die WebUI angegeben. Nützlich wenn im App-Verzeichnis sich weitere Dateien befinden, welche für den Webnutzer nicht erreichbar sein sollen. Nützlicher Nebeneffekt: Bei Apps die erst mit Start im Paketzentrum aktiviert werden, erscheint/verschwindet das Icon je nach Ausführungsstatus im Appmenü. Der symbolische Link, welcher sonst durch das postinst Skript angelegt wird, wird automatisch erstellt	alphanumerisch
startable	Bestimmt, ob ein Paket gestartet werden darf. Das "start-stop-status"-Script wird bei einem Wert "no" für die Anzeige des/der Status/Logdatei trotzdem benötigt und darf nicht fehlen! Der Ausführen- und Stopp-Link wird nicht angezeigt.	yes/no
install_dep_services	abhängige Dienste für die Installation	Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
start_dep_services	abhängige Dienste für den Start	Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
install_dep_packages	abhängige Pakete für die Installation. Es ist auch ein Vergleich zu einer bestimmten Version möglich. Hierfür hinter den Paketnamen eines der folgenden Zeichen "< > =" gefolgt von einer Versionsnummer eintragen.	Paketnamen mit Doppelpunkt getrennt, < > = für die Versionsabfrage / Init_3rdparty=1.5:Init_3rdpartyHelp>1.00
package_icon	72x72 Pixel grosses PNG base64-codiert, als Dateiname oder als PACKAGE_ICON.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben. Wichtig: Bei Verwendung der Datei "PACKAGE_ICON.PNG" in der letzten Zeile muss in INFO unbedingt eine neue Zeile folgen, da sonst der Parameter "package_icon" direkt hinter dem letzten Parameter (in der gleichen Zeile) eingetragen und somit ungültig wird.	base64-codierter Text, Dateiname oder Datei im Format PNG
*** Neu ab DSM 4.2.3160 beta ***
maintainer_url	Url des Entwicklers, wenn vorhanden wird der Maintainer als Link dargestellt	Url
distributor	Name des Vertreibers	alphanumerisch
distributor_url	Url des Vertreibers, wenn vorhanden wird der Vertreibers als Link dargestellt (Parameter distributur muss vorhanden sein)	Url
support_url	Url der Supportseite für Unterstützung	Url
install_conflict_packages	Liste der Pakete, welche mit diesem Paket in Konflikt stehen	Paketnamen mit Doppelpunkt getrennt
package_icon_120	120x120 Pixel grosses PNG base64-codiert, als Dateiname oder als PACKAGE_ICON_120.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben. Wichtig: Bei Verwendung der Datei "PACKAGE_ICON_120.PNG" in der letzten Zeile muss in INFO unbedingt eine neue Zeile folgen, da sonst der Parameter "package_icon_120" direkt hinter dem letzten Parameter (in der gleichen Zeile) eingetragen und somit ungültig wird.	base64-codierter Text oder Datei im Format PNG
*** Neu ab DSM 5.0.4418 beta ***
support_center	Mit aktivierter Option erscheint unterhalb des Paketicons der Link "Feedback", der direkt den Support-Center im DSM aufruft. (gilt auch für nicht-beta Pakete)	yes/no
silent_install	Stille Installation des Paketes	yes/no
silent_upgrade	Stilles Upgrade des Paketes, ermöglicht die Funktion "Automatische Updates" im Paket-Zentrum	yes/no
silent_uninstall	Stille Deinstallation des Paketes	yes/no
package_icon_256	256x256 Pixel grosses PNG base64-codiert (Synology nennt es 'Retina'-Auflösung), als Dateiname oder als PACKAGE_ICON_256.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben. Wichtig: Bei Verwendung der Datei "PACKAGE_ICON_256.PNG" in der letzten Zeile muss in INFO unbedingt eine neue Zeile folgen, da sonst der Parameter "package_icon_256" direkt hinter dem letzten Parameter (in der gleichen Zeile) eingetragen und somit ungültig wird.	base64-codierter Text oder Datei im Format PNG
*** Neu ab DSM 5.2.5532 beta ***
support_aaprofile	Mit aktivierter Option wird ein im Paket vorhandenes Application Armor (AppArmor) Profil in das System integriert.	yes/no

Sprachkürzeltabelle

ger = german
enu = english US
chs = chinese simplified
cht = chinese traditional
csy = czech
jpn = japanese
krn = korean
dan = danish
fre = french
ita = italian
nld = dutch
nor = norwegian
plk = polish
rus = russian
spn = spanish
sve = swedish
hun = hungarian
trk = turkish
ptg = portuguese european
ptb = portuguese brazilian

Links

3rd-Party Apps Developer Guide