Table of Contents

Einführung in den Bau der MLD 5.4

1 Vorwort

Da wir immer nach neuen Mitstreitern suchen und einige sicher von der MLD angetan sind, aber nicht wissen wie die Entwicklung von Paketen abläuft, möchte wir hiermit ein Step-by-Step How-to build for MLD-5.x zusammenstellen. Dieser Teil richtet sich nicht nur an Entwickler neuer Pakete, sondern kann von jedem User Schritt für Schritt nachgestellt werden, um selbst die bereitge­stellten Pakete zu bauen.

2 Vorbereitung

Im Folgenden gehen wir auf den 5.4 MLD-Entwicklungszweig ein, bei dem wir als Basis Debian 9 (Stretch) in einem Docker Container einsetzen.

WICHTIG Das Bauen von MLD Paketen kann viel Platz brauchen, was zu Problemen führt wenn die Entwicklungsumgebung unter MLD eingerichtet wird. Wer plant umfangreichere Arbeiten durchzuführen, sollte den Ordner /var/lib/docker auf eine große btrfs Partition verlegen.

2.1 Docker unter MLD installieren

Auf dem MLD System muss das Paket “docker” installiert werden.

apt install docker

2.2 MLD-Devel Docker Image erstellen

Jetzt wird der Ordner /root/devel und das folgende Dockerfile /root/devel/Dockerfile erstellt:

mkdir /root/devel
cd /root/devel
nano Dockerfile

Das unten stehende in das Dockerfile einfügen und speichern:

FROM debian:stretch
MAINTAINER MLD Team <team@minidvblinux.de>

ARG DEBIAN_FRONTEND=noninteractive

# update und core Pakete installieren
RUN apt-get update \
 && apt-get dist-upgrade -y \
 && apt-get install -y \
    make git-core software-properties-common locales locales-all

# MLD Pakete holen
RUN git clone http://minidvblinux.de/git-5/MLD.git MLD \
 && cd MLD \
 && make checkout_base

# MLD Paket Abhängigkeiten installieren
RUN cd MLD \
 && apt-get install -y $(make deps)
TIPP Wer nicht die testing Version sondern z.B. eine Entwicklungsumgebung für die MLD-5.3 Stable haben möchte, fügt im Dockerfile nach der Zeile && cd MLD \ diese Zeilen ein: && git checkout 5.3 && echo ”.SILENT:\nCLASS = stable” > Makefile.config \
TIPP Wer nicht eine Entwicklungsumgebung für die MLD-5.4 sondern eine für die MLD-5.5 haben möchte, ersetzt im Dockerfile in der ersten Zeile das 'stretch' durch ein 'buster' und fügt nach der Zeile && cd MLD \ diese Zeilen ein: && echo ”.SILENT:\nDISTRI_VER = 5.5” > Makefile.config \

Auf ARM Systemen (z.B. dem RPI 2) muss die erste Zeile des Dockerfile geändert werden:

uname -m | grep -q armv7l && sed "s|FROM .*|FROM arm32v7/debian:stretch|" -i Dockerfile

Anschließend das MLD Devel Docker Image erstellen:

docker build -t mld/devel:5.4 /root/devel

2.3 Docker Container erstellen

Jetzt wird ein Docker Container auf Basis des mld/devel Images erstellt:

docker create -it --name MLD mld/devel:5.4

2.4 Docker Container starten

Um den erstellten Container benutzen zu können muss dieser gestartet werden:

docker start MLD

2.5 Docker Container verwenden

Zuerst wird der Container betreten:

docker exec -it MLD bash

Damit befindet man sich im Docker Container. Hier wird in den Ordner /MLD gewechselt und in diesem z.B. das MLD netinstall ISO Image erstellt:

cd /MLD
make

Nach getaner Arbeit wird der Container verlassen und gestoppt:

exit
docker stop MLD

3 Entwicklungsumgebung nutzen

3.1 Pakete bauen

Hinweis Beim ersten “make” wird nach dem Namen und der E-Mail-Adresse gefragt. Dies wird insbesondere benötigt, wenn man Änderungen einchecken möchte. Dann werden diese Informationen ins Logfile geschrieben.

Einzelnes Paket bauen (Beispiel hier nun apt):

cd apt
make

Sämtliche verfügbaren Pakete werden so erstellt:

make all

So werden die vordefinierten ISOs erstellt:

make
Tipp Um gezielt nur ein bestimmtes ISO zu bauen, geht das so:
cd ISO
make collection=NAME_DES_ISO #(z. B. netinstall)

3.2 Aktualisieren der Entwicklungsumgebung

Alles auf den aktuellen Stand bringen lässt sich per:

make update_all
make all

Alles neu bauen lässt sich so:

make clean_all
make all

Abfragen welche Abhängigkeiten für die ausgecheckten MLD Pakete benötigt werden:

make deps

Wenn die benötigten Abhängigkeiten installiert werden sollen geht das so:

sudo apt install $(make deps)
Hinweis Leider funktionieren einige Debian Bibliotheken nicht korrekt auf dem RPI. Daher ist es erforderlich zusätzlich eine Raspbian Paketquelle hinzuzufügen: echo 'deb http://raspbian.raspberrypi.org/raspbian/ stretch main' » /etc/apt/sources.list und anschließend ein apt update; apt upgrade auszuführen.

Ein Paket neu kompilieren und bauen lassen (Beispiel dvb):

cd dvb
make clean

Ein Paket neu bauen ohne dass es neu kompiliert wird (Beispiel dvb):

cd dvb
make _clean
Tipp Beim Paket vdr und kernel ist es möglich, die vom vdr oder kernel abhängigen Pakete (z. B. beim vdr die plugins) neu bauen zu lassen, ohne dass diese neu kompiliert werden müssen (Beispiel vdr):
cd vdr
make all_depends

4 Einzelne Pakete erstellen

Ein einzelnes Paket lässt sich so auschecken:

make checkout name=PACKAGENAME

Es lassen sich auch alte MLD Addon auschecken und für die Verwendung unter der MLD-5 vorbereiten:

make checkout_old name=PACKAGENAME

Einzelne Pakete werden erstellt, indem in dem Ordner des Paketes ein make aufgerufen wird:

cd PACKAGENAME
make

Ein lokales Repository für ein neues Paket anlegen, nachdem es vorbereitet wurde, geht per:

make import name=PACKAGENAME

Ein neues Paket (für das zuvor ein locales Repository angelegt wurde) auf den Server stellen geht so (nur für registrierte Entwickler möglich):

make export name=PACKAGENAME

Zugangsdaten für Upload von Änderungen auf den MLD Server konfigurieren (nur für registrierte Entwickler möglich):

make auth

5 Tipps

5.1 Eigene Config in der MLD

Eigene Anpassungen der Konfiguration werden in der Datei Makefile.config vorgenommen.

5.2 GIT

Ein kleines Tutorial findest du hier

5.3 Nicht als root arbeiten

Wer nicht als root arbeiten möchte, egal ob im Docker Container oder einer vollwertigen Debian Installation, muss sicher stellen, dass der PATH auch auf die sbin Verzeichnisse verweist. Das geht z.B. mit diesem Befehl: <code bash>echo 'export PATH=/usr/local/sbin:/usr/sbin:/sbin:$PATH' > /etc/profile.d/sbin.sh

6 Änderungen und Neuerungen bei der MLD-5

6.1 Der Ordner control

Die Datei INSTALL gibt es nicht mehr und wird durch den Ordner control ersetzt. In diesem Ordner befindet sich eine Datei control in der einige Informationen zum Paket enthalten sind:

Package:⇒ Paketname
Version: ⇒ Paketversion (wird normalerweise automatisch ermittelt)
Section:⇒ Paketgruppe
Priority:⇒ ???
Maintainer:⇒ Name des Paketerstellers
Architecture:⇒ auf welcher Umgebung das Paket laufen kann (z. B. i386)
Depends:⇒ Abhängikkeiten (z. B. vdr)
Description:⇒ Kurze Beschreibung des Paketes
⇒ Ausführliche Beschreibung, die über mehrere Zeilen gehen darf

Des Weiteren findet man (wenn gebraucht) die Dateien postinst. Diese enthält das, was sich vorher in der INSTALL unter install) befand.

Dann findet man (wenn gebraucht) die Dateien prerm. Diese enthält das, was sich vorher in der INSTALL unter uninstall) befand.

WICHTIG Sofern im Paket ein init script existiert (/etc/init.d/NAME), muss dieses im controls/postinst Script per “start NAME” (z. B. start alsa) aufgerufen werden. Wenn auch ein stop erforderlich ist, wird der im controls/prerm Script aufgerufen (z. B. stop alsa). Das ist notwendig, damit Dienste nach dem Installieren sofort gestartet werden, und nicht erst beim nächsten Reboot. Dies ist natürlich nur für die Pakete notwendig, bei denen ein Aufruf des init Scripts erforderlich ist, z. B. alsa, wobei hier zwar das Starten erforderlich ist, das Stoppen aber nicht.

Zu guter Letzt gibt es noch (wenn gebraucht) die Datei conffiles. Darin werden alle Datein eingetragen (z. B. /etc/vdr/setup.conf), die im Paket enthalten und Konfigurations-Dateien sind. Die werden dann bei einem Deinstallieren und vor allem beim Updaten besonders behandelt.

Tipp Im control Ordner werden beim checkout_old gerne einige prerm und postinst Dateien angelegt, die fast leer sind (11 Byte groß). Die können bedenkenlos gelöscht werden, bevor das neue Paket eingecheckt wird.

6.2 Der Ordner .packages

Dieser Ordner enthält die gebauten Pakete und Images. Im Ordner .packages/isos/ befinden sich die erstellten ISOs.

Tipp Je nach Einstellung eures Systems kann es passieren, dass ihr Ihn nicht seht. Dazu einfach im Dateimanager alle Dateien anzeigen einstellen und schon seht ihr ihn.