Quellcode¶

Es ist empfehlenswert, sich den Artikel Grundlagen der Paketerstellung anzuschauen. Analog zu diesem Artikel werden dem Beispielordner ~/PPA-PROJEKT/test_0.0.1/ im Homeverzeichnis die Quelldateien des Projekts hinzugefügt. Der Ordnername test_0.0.1 setzt sich aus dem Programmnamen und der Version zusammen.

Dateien im Verzeichnis /debian¶

Im Ordner ~/PPA-PROJEKT/test_0.0.1 muss zusätzlich ein Unterordner debian/ mit folgenden Dateien angelegt werden: changelog, compat, control, copyright und rules. Nun fehlt nur noch ein Ordner debian/source/ mit der Datei format. Im Wesentlichen kann man sich bei diesen Dateien am oben erwähnten Artikel orientieren.

Damit das Beispielprojekt z.B. für Ubuntu 14.04 gebaut und veröffentlicht werden kann, sind folgende Änderungen vorzunehmen:

• In der Datei debian/changelog wird die erste Zeile so korrigiert:

  test (0.0.1-1~trusty) trusty; urgency=low

• Die Datei source/format sollte diesen Inhalt haben:

  3.0 (quilt)

  Ist eine Datei mit diesem Inhalt vorhanden, wird später die Datei ~/PPA-PROJEKT/test_0.0.1-1~trusty.debian.tar.gz erzeugt. Ohne die genannte Datei wird die Datei test_0.0.1-1~trusty.diff.tar.gz erzeugt, die Fehlermeldungen hervorrufen kann.

Nachdem im Ordner ~/PPA-PROJEKT/test_0.0.1/ alle erforderlichen Dateien vorhanden sind, muss im übergeordneten Ordner ~/PPA-PROJEKT/ eine komprimierte Archivdatei des Ordners ~/PPA-PROJEKT/test_0.0.1/ erstellt werden. Der Name muss dieser Konvention entsprechen: PROGRAMMNAME_VERSIONSNUMMER.orig.tar.gz. In dem Beispiel somit test_0-0-1.orig.tar.gz.

Dateien erzeugen, die zum Hochladen benötigt werden¶

Nachdem alle erforderlichen Dateien vorhanden sind, werden die benötigten Dateien mit debuild erzeugt:

cd ~/PPA-PROJEKT/test_0.0.1/
debuild -S -sa 

Dieses Hilfsprogramm kümmert sich gleich um drei Punkte:

1. es ruft dpkg-buildpackage zur Paketerstellung auf

2. dann wird der Paketbau mit lintian kontrolliert

3. Zum Schluss erfolgt die Signierung mit debsign

Dabei werden mehrere Dateien im Ordner ~/PPA-PROJEKT/ erzeugt, u.a. test_0.0.1-1~trusty.dsc und test_0.0.1-1~trusty_source.changes. War die Erstellung des Projekts nicht erfolgreich, müssen mit den Hinweisen von lintian die Fehler ermittelt und korrigiert werden.

Erstmaliges Hochladen des Projekts¶

cd ~/PPA-PROJEKT
dput ppa:LAUNCHPAD-ID/PPA-NAME PROGRAMMNAME_VERSION_source.changes 

Die Werte für LAUNCHPAD-ID/PPA-NAME und PROGRAMMNAME_VERSION müssen entsprechend angepasst werden. Praktisch also, um beim Beispiel zu bleiben:

dput ppa:BENUTZERNAME/ppa  test_0.0.1-1~trusty_source.changes 

Man bekommt dann eine E-Mail, ob das Paket akzeptiert wurde und falls nicht, warum. Wurde das Quellpaket akzeptiert, wird nun versucht, Debianpakete für die Architekturen i386, amd64 und lpia (nur bis Ubuntu 10.04) zu erstellen. Das kann je nach Auslastung der Build-Server etwas dauern. In eigenen Launchpad-Profil unter "Actions -> Personal Package Archive -> View build records" kann man den Fortschritt kontrollieren und, falls das Erstellen scheitert, das Build-Log mit den Fehlern beim Paketerstellen einsehen. Nur im Fehlerfall erhält man eine E-Mail mit einem Link auf die Build-Log-Datei.

Sind die Pakete erfolgreich erstellt worden, sieht man dies im Profil unter "Actions -> Personal Package Archive". Hier findet man dann auch die Direktlinks zu den Debian-Paketen und die Adresse der eigenen Paketquelle. Im Beispielprojekt findet man die Pakete als LAUNCHPAD-ID/PPA-NAME/test_0.0.1~trusty.SYSTEMARCHITEKTUR.deb.

Erneutes Hochladen des Projekts¶

Wurden am Quelltext Änderungen vorgenommen, muss in der Datei debian/changelog die Versionsnummer erhöht werden (z.B. von test_0.0.1-1 auf test_0.0.1-2). Dann werden, wie oben beschrieben, die zum Hochladen erforderlichen Dateien erzeugt, signiert und hochgeladen.

Eine weitere Möglichkeit ist die Erstellung von Patch-Dateien. Der Artikel Grundlagen der Paketerstellung gibt hierzu weitere Hinweise.

Hochladen des Projekts für verschiedene Ubuntu-Versionen¶

Durch das Ersetzen von trusty im Dateinamen kann das Projekt problemlos für weitere Ubuntu-Versionen gebaut und veröffentlicht werden. Die folgenden Änderungen sind erforderlich, wenn das Projekt beispielsweise (zusätzlich) für Ubuntu 12.04 veröffentlicht werden soll:

1. Die erste Zeile in der Datei debian/changelog muss angepasst werden, indem zweimal das vorhandene trusty durch precise ersetzt wird.

2. Im Ordner ~/PPA-PROJEKT/ wird nur der Unterordner test_0.0.1-1/ mit dem Quelltext und die Archivdatei test_0.0.1.orig.tar.gz benötigt. Alle weiteren vorhandenen Dateien müssen gelöscht werden.

Nun folgt die Erstellung und Signierung die erforderlichen Dateien. Entweder benutzt man wie oben den Befehl "debuild -S -sa" oder den folgenden, wenn ein bestimmter Schlüssel verwendet werden soll:

cd ~/PPA-PROJEKT/test_0.0.1/
debuild -S -sd -k"0xABCD1234" 

Das Hochladen erfolgt mit dem bereits oben erläuterten Befehl:

cd ..
dput ppa:LAUNCHPAD-ID/PPA-NAME  test_0.0.1-1~precise_source.changes 

Die Dateien test_0.0.1-1~precise_source.changes, test_0.0.1-1~precise.dsc und test_0.0.1-1~precise.debian.tar.gz werden hochgeladen, nicht aber die Datei test_0.0.1.orig.tar.gz. Auch hier bekommt man eine E-Mail, ob das Paket akzeptiert wurde oder nicht.