====== Erstellen von Debian-Paketen und Aufsetzen eines Repositorys ======

===== Praxis =====
  * Ordner erstellen, hier **<namedesprogramms-version>**
  * Als erstes erstellen wir einen Ordner mit der folgenden Ordnerstruktur:<code>
PROGRAMM
\
 |opt
 |  \
 |  PROGRAMM
 |    \
 |    DATEIEN
 \   
 DEBIAN
    \
    control
    |
    postinst
</code>
  * Dateien im Ordner **debian** anlegen
    * control -- Datei<file bash control>
Package: <PROGRAMM_NAME>
Version: <VERSION>
Section: <'admin', 'devel' (development), 'doc', 'editors', 'games', 'graphics', 'math', 'misc', 'science', 'utils'>
Priority: extra
Architecture: <'all', 'amd64', 'i386'>
Depends: <ABHÄNGIGKEITEN>
Installed-Size: <DATEIGRÖSSE IN KB>
Maintainer: Max Mustermann <muster@mann.de>
Homepage: <HOMEPAGE>
Description: Eine kurze Beschreibung
 Eine lange Beschreibung...
</file>
    * postinst -- Datei<file bash postinst>
// Befehle, welche nach der Installation ausgeführt werden...
</file>
  * Unterordner von **opt** erstellen\\ Das Programm liegt nachher in diesem Verzeichnis. Beispiel:
    * **<DIR>/opt/rktools/rkObjectHasher/** entspricht **/opt/rktools/rkHasher/** im Dateisystem<file bash rkobjecthasher>
#!/bin/bash

java -jar /opt/rktools/rkObjectHasher/rkObjectHasher.jar
</file>
    * Folgende Datei unter **<DIR>/usr/share/apllications/** anlegen:<file bash rkobjecthasher.desktop>
[Desktop Entry]
Encoding=UTF-8
Name=rkObjectHasher   
Comment=Dies ist ein Kommentar welcher beim Ueberfahren mit der Maus angezeigt $
Exec=rkobjecthasher  
Icon=rkobjecthasher.png 
Terminal=false
Type=Application
Categories=GNOME;GTK;System;rkTools;
</file>
    * Folgende Datei unter **<DIR>usr/share/pixmaps/** ablegen
      * rkobjecthasher.png
  * Anschließend das Paket bauen:<code bash>
dpkg -b rkobjecthasher-1.1 rkobjecthasher-1.1-all.deb
</code>

===== Theorie (und offizieller Debian Repository) =====
<FIXME>
  - Quellcode-Archiv herunterladen und entpacken
  - Das Quellcode-Archiv sollte "''<packetname>_<packetversion>.orig.tar.gz''" heißen
  - In dem entpackten Code ein Verzeichnis "debian" anlegen
  - In dem Verzeichniss werden nun folgende Dateien angelegt:
    * debian/changelog - **Changelog**
    * debian/control - **Metainformationen** (Abhängigkeiten, Beschreibungen)
    * debian/copyright - **Copyright & Lizenz-Informationen**
    * debian/watch - **URL** um automatisch auf neue Versionen zu prüfen
    * debian/rules - **Informationen**, wie der Quellcode gebaut werden soll
  - Paket kann gebaut werden
    * <code>dpkg-buildpackage</code>
    * <code>dpkg-buildpackage -b</code> | Nur **binary**
    * <code>dpkg-buildpackage -S</code> | Nur **source**
  - Ergebniss überprüfen
    * Paketinhalt - wenn leer blöd <code>dpkg -c file.deb</code>
    * Metadaten <code>dpkg --info file.deb</code>
    * <code>lintian --display-info --pendantic file.changes</code>
  - Signieren und hochladen (Nur Debian Mainainer relevant)
    * <code>debsign file.changes</code>
    * <code>dput file.changes</code>
==== Programme ====
=== dh_make ===
Templates der debian/* Dateien
=== pbuilder ===
**pbuilder** wird eingesetzt um zu garantieren, dass sämtliche build-dependes aufgelöst werden. Im Prinzip ist es ein komplett eigenständiges Debian-System aber ohne irgendwelche vorinstallierten Programme.

  * <code>pbuilder --create</code>
  * <code>pbuilder --update</code>
  * <code>pbuilder --build file.dsc ((file.dsc wird erstellt nach dpkg-buildpackage -S))</code>


==== Dateien ====
=== debian/changelog ===
<file batch changelog>
<programmname> (<VERSION) <ETCH/JESSIE/STABLE/UNSTABLE...>; urgency=low

  * initial release
  * Kommentare

 -- <MAINTAINER> <maxmustermann@rkcsd.com>  Fri, 20 Jun 2008 10:21:18 +0200 
</file>

=== debian/control ===
<file batch control>
Source:
Section: misc
Priority: extra
Maintainer: Max Mustermann <maxmustermann@rkcsd.com>
Standards-Version: 3,9,4
Build-Depends: <programm(paketname)> (>= <VERSION>),
               <...>
Homepage: http://www.rkcsd.com/<PFAD/ZUM/PROGRAMM>

....

Package: <PROGRAMMNAME>
Architecture: all
Multi-Arch: foreign
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: <KURZBESCHREIBUNG>
 BLAAAAABLLAAAAAAA
 . 
 ABSATZ!!!
 .
 Textetxtext

</file>

=== debian/copyright ===
<file bash copyright>
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Source: <http://mein.projekt/>

Files: *
Copyright: 2007-2012 <NAME> <sag@ich.net>
           2012 <NAME> <sag@ich.net>
License: GPL-3*
 LICENSE TEXT

Files: debian/*
Copyright: 2007-2012 <NAME> <sag@ich.net>
           2012 <NAME> <sag@ich.net>
License: ISC
 LICENSE TEXT
</file>
=== debian/watch ===
FIXME
<file bash watch>

</file>
=== debian/rules ===
<file bash rules>
#!/usr/bin/make -f

%:
  dh $0
  
override_dh_auto_install:
  dh_auto_install -- PREFIX=/usr
</file>
  * http://manpages.debian.org/cgi-bin/man.cgi?query=debhelper

=== Weitere Dateien ===
Sind nicht nötig, können aber gesetzt werden.
debian/{preinst,postinst,prerm,postrem}

===== Das Repository =====

===== Quellen =====
  * https://wiki.debian.org/HowToPackageForDebian
  * https://www.linuxmaker.com/tutorials/debian-pakete-erstellen.html
  * http://debian-handbook.info/browse/de-DE/stable/debian-packaging.html
  * https://www.youtube.com/watch?v=uCE8FyruXvM
  * http://www.tomprogs.at/tutorials/linux/debian-paket-tutorials-01-ein-erstes-paket.xhtml
  * https://blog.pregos.info/2011/05/07/eigene-debian-pakete-und-repository-erstellen/