WIKI

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 bereitgestellten 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.
<code bash>apt install docker</code>


==== 2.2 MLD-Devel Docker Image erstellen ====

Jetzt wird der Ordner /root/devel und das folgende Dockerfile /root/devel/Dockerfile erstellt:
<code bash>mkdir /root/devel
cd /root/devel</code>
<code bash>nano Dockerfile</code>
Das unten stehende in das Dockerfile einfügen und speichern:
<code>
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)
</code>

|^  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 \'' |

Auf ARM Systemen (z.B. dem RPI) muss die erste Zeile des Dockerfile geändert werden:
<code bash>uname -m | grep -q armv7l && sed "s|FROM .*|FROM arm32v7/debian:stretch|" -i Dockerfile</code>

Anschließend das MLD Devel Docker Image erstellen:
<code bash>docker build -t mld/devel:5.4 /root/devel</code>

==== 2.3 Docker Container erstellen ====

Jetzt wird ein Docker Container auf Basis des mld/devel Images erstellt:
<code bash>docker create -it --name MLD mld/devel:5.4</code>

==== 2.4 Docker Container starten ====
Um den erstellten Container benutzen zu können muss dieser gestartet werden:
<code bash>docker start MLD</code>

==== 2.5 Docker Container verwenden ====

Zuerst wird der Container betreten:
<code bash>docker exec -it MLD bash</code>

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:
<code bash>cd /MLD
make</code>

Nach getaner Arbeit wird der Container verlassen und gestoppt:
<code bash>exit
docker stop MLD</code>

===== 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):
<code bash>cd apt
make</code>

Sämtliche verfügbaren Pakete werden so erstellt:
<code bash>make all</code>


So werden die vordefinierten ISOs erstellt:
<code bash>make</code>

|^  Tipp  |Um gezielt nur ein bestimmtes ISO zu bauen, geht das so:|
<code bash>cd ISO
make collection=NAME_DES_ISO #(z. B. netinstall)</code>

==== 3.2 Aktualisieren der Entwicklungsumgebung ====

Alles auf den aktuellen Stand bringen lässt sich per:
<code bash>make update_all
make all</code>

Alles neu bauen lässt sich so:
<code bash>make clean_all
make all</code>

Abfragen welche Abhängigkeiten für die ausgecheckten MLD Pakete benötigt werden:
<code bash>make deps</code>

Wenn die benötigten Abhängigkeiten installiert werden sollen geht das so:
<code bash>sudo apt-get install $(make deps)</code>

|^  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):
<code bash>cd dvb
make clean</code>

Ein Paket neu bauen ohne dass es neu kompiliert wird (Beispiel dvb):
<code bash>cd dvb
make _clean</code>

|^  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):|
<code bash>cd vdr
make all_depends</code>

===== 4 Einzelne Pakete erstellen =====

Ein einzelnes Paket lässt sich so auschecken:
<code bash>make checkout name=PACKAGENAME</code>

Es lassen sich auch alte MLD Addon auschecken und für die Verwendung unter der MLD-5 vorbereiten:
<code bash>make checkout_old name=PACKAGENAME</code>

Einzelne Pakete werden erstellt, indem in dem Ordner des Paketes ein make aufgerufen wird:
<code bash>cd PACKAGENAME
make</code>

Ein lokales Repository für ein neues Paket anlegen, nachdem es vorbereitet wurde, geht per:
<code bash>make import name=PACKAGENAME</code>

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):
<code bash>make export name=PACKAGENAME</code>

Zugangsdaten für Upload von Änderungen auf den MLD Server konfigurieren 
(nur für registrierte Entwickler möglich):
<code bash>make auth</code>

===== 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 [[mld:tutorials:git|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.|
WIKI

User Tools

Site Tools

Page Tools
