# Integration vorhandener Software in GNOME

Handbuch für unabhängige Software-Anbieter

Handbuch für unabhängige Software-Anbieter

Rosanna
Yuen

    	    zana@gnome.org

Federico
Mena-Quintero

    	    federico@gnu.org

Mike
Hearn

    	    mike@navi.cx

2005, 2006
Rosanna Yuen, Federico Mena-Quintero, Mike Hearn
2009
Mario Blättermann (mariobl@gnome.org)
0.6
19. September 2006

Erweiterung der Symbol-Empfehlungen.

0.5
18. September 2006

Einfügen des Inhalts von Rosanna Yuens erstem Artikel über die Freedesktop.org-Standards.

0.0
Juni 2005

Erste Version dieses Dokuments.

Das vorliegende Dokument kann gemäß den Bedingungen der GNU Free Documentation License (GFDL), Version 1.1 oder jeder späteren, von der Free Software Foundation veröffentlichten Version ohne unveränderbare Abschnitte sowie ohne Texte auf dem vorderen und hinteren Buchdeckel kopiert, verteilt und/oder modifiziert werden. Eine Kopie der GFDL finden Sie unter diesem Link oder in der mit diesem Handbuch gelieferten Datei COPYING-DOCS.

Dieses Handbuch ist Teil einer Sammlung von GNOME-Handbüchern, die unter der GFDL veröffentlicht werden. Wenn Sie dieses Handbuch getrennt von der Sammlung weiterverbreiten möchten, können Sie das tun, indem Sie eine Kopie der Lizenz zum Handbuch hinzufügen, wie es in Abschnitt 6 der Lizenz beschrieben ist.

Viele der Namen, die von Unternehmen verwendet werden, um ihre Produkte und Dienstleistungen von anderen zu unterscheiden, sind eingetragene Warenzeichen. An den Stellen, an denen diese Namen in einer GNOME-Dokumentation erscheinen, werden die Namen in Großbuchstaben oder mit einem großen Anfangsbuchstaben geschrieben, wenn das GNOME-Dokumentationsprojekt auf diese Warenzeichen hingewiesen wird.

DAS DOKUMENT UND VERÄNDERTE FASSUNGEN DES DOKUMENTS WERDEN UNTER DEN BEDINGUNGEN DER GNU FREE DOCUMENTATION LICENSE ZUR VERFÜGUNG GESTELLT MIT DEM WEITERGEHENDEN VERSTÄNDNIS, DASS:

1. DIESES DOKUMENT WIRD »WIE VORLIEGEND« GELIEFERT, OHNE GARANTIEN IRGENDEINER ART, SOWOHL AUSDRÜCKLICH GENANNTE ALS AUCH ANGEDEUTETE. DIES BEZIEHT SICH AUCH OHNE EINSCHRÄNKUNG AUF GARANTIEN, DASS DIESES DOKUMENT ODER VERÄNDERTE FASSUNGEN DIESES DOKUMENTS FREI VON HANDELSDEFEKTEN, FÜR EINEN BESTIMMTEN ZWECK GEEIGNET IST ODER DASS ES KEINE RECHTE DRITTER VERLETZT. DAS VOLLE RISIKO WAS QUALITÄT, GENAUIGKEIT UND LEISTUNG DES DOKUMENTS ODER VERÄNDERTE FASSUNGEN DES DOKUMENTS LIEGT BEI IHNEN. SOLLTE EIN DOKUMENT ODER EINE VERÄNDERTE FASSUNG DAVON FEHLER IRGENDEINER ART BEINHALTEN, TRAGEN SIE (NICHT DER URSPRUNGSAUTOR, DER AUTOR ODER EIN MITWIRKENDER) DIE KOSTEN FÜR NOTWENDIGE DIENSTLEISTUNGEN, REPARATUREN ODER FEHLERKORREKTUREN. DIESER HAFTUNGSAUSSCHLUSS IST EIN ESSENZIELLER TEIL DIESER LIZENZ. DIE VERWENDUNG EINES DOKUMENTS ODER EINER VERÄNDERTEN VERSION DES DOKUMENTS IST NICHT GESTATTET AUßER UNTER BEACHTUNG DIESES HAFTUNGSAUSSCHLUSSES UND

2. UNTER KEINEN UMSTÄNDEN UND AUF BASIS KEINER RECHTSGRUNDLAGE, EGAL OB DURCH UNERLAUBTEN HANDLUNGEN (EINSCHLIEßLICH FAHRLÄSSIGKEIT), VERTRAG ODER ANDERWEITIG KANN DER AUTOR, URSPRUNGSAUTOR, EIN MITWIRKENDER ODER EIN VERTRIEBSPARTNER DIESES DOKUMENTS ODER EINER VERÄNDERTEN FASSUNG DES DOKUMENTS ODER EIN ZULIEFERER EINER DIESER PARTEIEN, HAFTBAR GEMACHT WERDEN FÜR DIREKTE, INDIREKTE, SPEZIELLE, VERSEHENTLICHE ODER FOLGESCHÄDEN JEGLICHER ART, EINSCHLIEßLICH UND OHNE EINSCHRÄNKUNGEN SCHÄDEN DURCH VERLUST VON KULANZ, ARBEITSAUSFALL, COMPUTERVERSAGEN ODER COMPUTERFEHLFUNKTIONEN ODER ALLE ANDEREN SCHÄDEN ODER VERLUSTE, DIE SICH AUS ODER IN VERBINDUNG MIT DER VERWENDUNG DES DOKUMENTS UND VERÄNDERTER FASSUNGEN DES DOKUMENTS ERGEBEN, AUCH WENN DIE OBEN GENANNTEN PARTEIEN ÜBER DIE MÖGLICHKEIT SOLCHER SCHÄDEN INFORMIERT WAREN.

## Vorbetrachtung

GNOME ist ein Projekt zur Erstellung einer vollständigen Arbeits- und Entwicklungsumgebung, das vollständig auf freier Software basiert. Viele Unternehmen, Regierungen, Schulen, Institutionen und auch Einzelpersonen setzen den GNOME-Desktop auf ihren Systemen ein. Falls Sie ein Entwickler von Drittanbieter-Software sind (ein »Unabhängiger Softwareanbieter oder ISV) oder ein »Unabhängiger Softwareentwickler« (ISD, falls Sie dies auf nichtkommerzieller Basis tun), möchten Sie gern sicherstellen, dass Ihre Software sauber unter GNOME funktioniert. Dieses Handbuch erklärt, wie Sie vorhandene Software in GNOME integrieren können, ohne die Software unter Verwendung der Bibliotheken der GNOME-Plattform und deren Entwicklungswerkzeugen neu schreiben zu müssen.

Dieses Handbuch könnte in den folgenden Situationen nützlich sein:

- Sie verfügen als Software-Entwickler oder -Anbieter über eine Anwendung, die nicht speziell für die Zusammenarbeit mit GNOME entworfen wurde. Sie möchten dennoch sicherstellen, dass diese Anwendung komfortabel im GNOME-Desktop läuft.

- Sie sind ein Systemverwalter einer Institution, die GNOME auf ihren Arbeitsplätzen einsetzt. Sie verfügen über ältere oder spezielle für Sie entworfene Software und möchten sicherstellen, dass die GNOME-Benutzer diese Software komfortabel benutzen können.

- Sie schreiben eine saubere GNOME-Anwendung und benötigen eine Checkliste einiger grundlegenden Dinge, um die Integration Ihrer Anwendung in den übrigen Desktop sicherzustellen.

Im Allgemeinen beschäftigt sich dieses Handbuch mit der Integration vorhandener Software in den GNOME-Desktop. Falls Sie jedoch erwägen, neue Software zu schreiben, dann möchten wir Sie ermuntern, diese Software vollständig mit GNOME als Zielplattform zu entwickeln. Weitere Informationen finden Sie auf der Webseite der GNOME-Entwickler

Eines der Hauptanliegen von GNOME ist die Benutzerfreundlichkeit. Die Benutzer sollten eine komfortable Arbeitsumgebung haben. Das bedeutet, über einen kompletten Desktop und eine Reihe von Anwendungen zu verfügen, die in ineinander greifender Art und Weise zusammenarbeiten. Mit relativ wenig Aufwand können Anwendungen, die nicht speziell mit einem GNOME-Hintergrund geschrieben worden sind, für eine komfortable Zusammenarbeit mit dem GNOME-Desktop angepasst werden.

### Struktur dieses Handbuchs

Dieses Handbuch ist als Aufgabenliste strukturiert, die Sie zur Integration vorhandener Software in GNOME auszuführen haben. Diese Aufgaben werden in lockerer Folge nach ihrer Bedeutsamkeit dargestellt. Beispielsweise erscheint das Hinzufügen einer Anwendung zu den Desktop-Menüs von GNOME vor dem Hinzufügen der Unterstützung für Ziehen und Ablegen. Außerdem verfügt dieses Handbuch über eine Checkliste, um Sie bei der Planung Ihrer Integrationsaufgaben zu unterstützen.

### Standards und freedesktop.org

Viele der in diesem Handbuch beschriebenen Integrationsaufgaben beziehen sich auf mehr als nur auf GNOME. Weitere Desktop-Projekte, wie das K Desktop Environment, verwenden diese Standards ebenfalls. Das bedeutet, dass durch die Integration in GNOME nur wenig oder keine weitere Arbeit nötig ist, um Ihre Anwendung auch in diese anderen Umgebungen einzupassen.

Das Entwerfen einer perfekten Anwendung ist ein wundervolles Gefühl. Ob groß oder klein, muss der Desktop die Anwendung gebührend berücksichtigen und angemessen mit ihr interagieren. Durch die Verfügbarkeit mehrerer Umgebungen, ist es das Beste für Ihre Anwendung, sich in möglichst viele von ihnen zu integrieren. Zwar sind noch keine offiziellen Regeln anerkannt worden, aber es gibt eine Reihe von Spezifikationen bei freedesktop.org.

Obwohl es sich nicht um formelle Standardisierungen handelt, verwaltet freedesktop.org eine Reihe von unverbindlichen, wiewohl weithin akzeptierten Empfehlungen. Wenn Sie diesen folgen, ermöglichen die Empfehlungen die Integration in die konformen Umgebungen.

## Grundlegende Integration

Dieser Abschnitt führt Sie in die grundlegenden Schritte ein, die Sie zur Integration eines Programms in den GNOME-Desktop ausführen sollten. Diese Schritte umfassen Folgendes:

- Lassen Sie den Benutzer Ihre Anwendung starten, indem Sie sie in den Panel-Menüs des Desktops erscheinen lassen, oder in jedem anderen Startmechanismus des Desktops.

- Machen Sie den Desktop mit den Arten der vom Benutzer erzeugten Dateien bekannt, die durch Ihre Anwendung geöffnet werden können.

- Stellen Sie für den Desktop passende Anwendungssymbole sowie Symbole für die von Ihrer Anwendung erzeugten Dateien bereit.

### Desktop-Dateien: Ihre Anwendung innerhalb der Desktop-Menüs

Um Anwendungen in GNOME auszuführen, klicken Anwender auf Symbole auf ihren Desktops oder wählen die zu startenden Anwendungen in einem Menü aus. Daher sollte der erste Schritt für die Integration eines vorhandenen Programms in GNOME die Registrierung in einer Reihe von Anwendungen sein, die Benutzer ausführen können.

Im Gegensatz zu Windows oder MacOS werden in GNOME die Benutzermenüs automatisch aus der Liste der registrierten Anwendungen erstellt. Jede verfügbare Anwendung stellt eine Reihe von Kategorien bereit, auf die sie sich bezieht. Die Konfiguration des Systemmenüs sortiert diese und ordnet sie richtig zu. Dieser Mechanismus folgt den Freedesktop.org-Standards für Desktop-Einträge und Menüs.

Obwohl in anderen Desktopumgebungen üblich, wird die Erzeugung eines eigenen, anwendungsspezifischen Untermenüs nicht empfohlen. Stellen Sie stattdessen einen Menüeintrag für jede Ihrer Anwendungen bereit. Zusätzliche Einträge wie Hilfedateien, READMEs oder Verknüpfungen sollten in die Anwendung selbst eingebettet werden.

In GNOME und auch in anderen Freedesktop.org-kompatiblen Desktops wird eine Anwendung in den DEsktop-Menüs anhand eines Desktop-Eintrags registriert. Dies ist eine Textdatei mit der Erweiterung `.desktop`. Diese Desktop-Datei enthält eine Liste von Konfigurationen für Ihre Anwendung. Der Desktop liest die Informationen in dieser Datei aus und verwendet sie zum:

- Eintragen der Anwendung in das Hauptmenü.

- Auflisten der Anwendung im Dialog Anwendung ausführen ….

- Erzeugen entsprechender Anwendungsstarter im Menü oder auf dem Desktop.

- Zuordnen des Namens und der Beschreibung einer Anwendung.

- Zuordnen des richtigen Symbols.

- Zuordnen der MIME-Typen, deren Dateien diese Anwendung öffnen kann.

Um einen Menüeintrag für Ihre Anwendung hinzuzufügen, erstellen Sie eine Desktop-Datei. Diese sollte einen eindeutigen Dateinamen haben. Für die Länge dieses Namens gibt es keinerlei Beschränkungen, Sie dürfen hier auch Markennamen verwenden. So können Sie Überschneidungen mit anderen Anwendungen zuvorkommen. Vermeiden Sie jedoch Leerzeichen oder internationale Zeichen im Dateinamen. Beispielsweise wäre »foocorp-painter-pro.desktop« ein guter Dateiname, »fcpp.desktop« dagegen nicht, ebenso wie »FooCorp Painter Pro.desktop«. Die Datei sollte in UTF-8 kodiert sein und nach folgender Vorlage gestaltet werden:

    	[Desktop Entry]
    	Encoding=UTF-8
    	Name=FooCorp Painter Pro
    	Exec=foocorp-painter-pro
    	Icon=foocorp-painter-pro
    	Type=Application
    	Categories=Application;

Diese Desktop-Dateien enthalten Metadaten zu Ihrer Anwendungen und spielen eine zentrale Rolle bei der Integration des Programms in GNOME und auch in andere standardkonforme Desktops. Die hier vorgestellte Vorlage ist das absolute Minimum. Die Datei kann in verschiedene Sprachen übersetzt werden, so dass der Name der Anwendung in der jeweiligen Sprache des Benutzers erscheint.

Speichern Sie diese Datei im Ordner `/usr/share/applications`, so dass sie für jeden verfügbar wird, oder in `~/.local/share/applications`, falls nur ein einzelner Benutzer darauf zugreifen können soll. Welcher Ort verwendet wird, ist davon abhängig, ob Ihre Anwendung systemweit oder im persönlichen Ordner eines Benutzers installiert wird. GNOME überprüft diese Ordner regelmäßig auf Änderungen, einfaches Kopieren der Datei an den richtigen Ort genügt, um sie im Desktop zu registrieren. Beachten Sie, dass der Ort `~/.local/share/applications` von Gnome-Versionen vor 2.10 oder auf Fedora-Systemen vor GNOME 2.8 nicht berücksichtigt wird. Diese GNOME-Versionen folgen dem nicht mehr gültigen vfolder-Standard, daher müssen Desktop-Dateien in `~/.gnome2/vfolders/applications` installiert werden. Dieser Ort wird weder von GNOME 2.8 auf Fedora noch von GNOME 2.10 unterstützt. Setzen Sie daher die Datei an beide Orte, um eine höchstmögliche Kompatibilität zu gewährleisten. Beachten Sie, dass der KDE-Desktop die Ausführung des Befehls `kbuildsycoca` erfordert, um eine Aktualisierung der Menüs zu erzwingen.

Jede funktionierende Desktop-Datei muss dem gleichen Format folgen. Ein Beispiel einer minimalen Desktop-Datei wird in gezeigt. Die Datei ist in Abschnitte unterteilt, wovon jeder mit einer Abschnittsbeschreibung in eckigen Klammern beginnt. In diesem Beispiel wird nur ein Abschnitt gezeigt, der für die Integration Ihrer Anwendung in den Desktop von grundlegender Bedeutung ist. In jedem Abschnitt ist der Teil jeder Zeile vor dem Gleichheitszeichen der key, wobei die zweite Hälfte der Zeile den Wert angibt. Eine Erklärung der einzelnen Zeilen finden Sie in .

Abgesehen von der ersten Zeile zur Identifizierung der Desktop-Datei ist die Reihenfolge der weiteren Zeilen nicht von Bedeutung. In könnte die Zeile `Type=Application` an zweiter, fünfter oder letzter Stelle stehen, das Ergebnis wäre das Gleiche.

Die Schlüssel erkennen Groß- und Kleinschreibung. `Type=Application` ist nicht dasselbe wie `type=Application` oder `TYPE=Application`.

#### Beispiel für eine Desktop-Datei

    [Desktop Entry]
    Type=Application
    Encoding=UTF-8
    Name=Sample Application Name
    Comment=A sample application
    Exec=application
    Icon=application.png
    Terminal=false

#### Zeilenweise Erklärung

Zeile | Beschreibung
--- | ---
`[Desktop Entry]` | Die erste Zeile jeder Desktop-Datei und der Abschnitts-Kopfzeile, um den Block aus mit dem Desktop verknüpften Schlüssel-Wert-Paaren zu identifizieren. Dies ist für die korrekte Erkennung der Datei durch den Desktop notwendig.
`Type=Application` | Weist den Desktop darauf hin, dass diese Desktop-Datei zu einer Anwendung gehört. Weitere mögliche Werte für diesen Schlüssel sind `Link` und `Directory`.
`Encoding=UTF-8` | Beschreibt die Zeichenkodierung der Einträge in dieser Desktop-Datei.
`Name=Name der Beispielanwendung` | Name der Anwendung für das Hauptmenü und Anwendungsstarter.
`Comment=Eine Beispielanwendung` | Beschreibt die Anwendung. Wird als Minihilfe angezeigt.
`Exec=application` | Der Befehl, der die Anwendung in einer Befehlszeile startet. Die Angabe von Argumenten ist möglich.
`Icon=application.png` | Der Name des mit dieser Anwendung verknüpften Symbols.
`Terminal=false` | Gibt an, ob die Anwendung in einem Terminal ausgeführt werden sollte oder nicht.

#### Starten Ihrer Anwendung

Falls Ihre Anwendung Befehlszeilenargumente akzeptiert, können Sie das unter Verwendung der in gezeigten Felder anzeigen.

##### Ausführungsvariablen

Fügt hinzu … | Akzeptiert …
--- | ---
`%f` | einen einzelnen Dateinamen.
`%F` | mehrere Dateinamen.
`%u` | eine einzelne Adresse.
`%U` | mehrere Adressen.
`%d` | einen einzelnen Ordner. Wird in Verbindung mit `%f` verwendet, um eine Datei anzugeben.
`%D` | mehrere Ordner. Wird in Verbindung mit `%F` verwendet, um Dateien anzugeben.
`%n` | einen einzelnen Dateinamen ohne Pfad.
`%N` | mehrere Dateinamen ohne Pfade.
`%k` | eine Adresse oder einen lokalen Dateinamen eines Ortes in der Desktop-Datei.
`%v` | den Namen des Geräteeintrags.

#### Lokalisierung

Zum Erzeugen von Namen und Kommentaren in weiteren Sprachen müssen Sie zusätzliche Zeilen hinzufügen. Um beispielsweise eine schwedische Version des Kommentars hinzuzufügen, ist folgende Zeile nötig:

`Comment[sv]=Exempelprogramnamn`

Die Anzahl der Übersetzungen in der Datei ist nicht begrenzt.

Weil die Verwaltung einer langen Liste von Übersetzungen in einer Datei eher lästig ist, sollten Sie für deren Erzeugung besser das intltool-Paket verwenden. In den Handbuchseiten von intltool-extract und intltool-merge finden Sie weitere Informationen.

#### Referenzen

Desktop Entry Specification — Spezifikationen zur Erstellung einer Desktop-Datei.

### Installieren von Symbolen

In wurde das Symbol für die Anwendung als `application.png` festgelegt. Damit dies funktioniert, ist es notwendig, die Symboldatei in den richtigen Ordner zu setzen.

Der Desktop sucht nach Symbolen im ausgewählten Themen-Ordner von `/usr/share/icons/`. Anwendungssymbole sollten mindestens in einer Ausflösung von 48x48 Pixeln bereitstehen. Setzen Sie das Symbol in `/usr/share/icons/hicolor/48x48/apps/`. Dies ist der Ordner, in dem der Desktop sucht, falls für Ihre Anwendung kein Symbol im ausgewählten Thema zur Verfügung steht. Falls Sie themenbasierte Symbole erstellt haben, setzen Sie diese in die entsprechenden Ordner.

Um bessere visuelle Integration in den GNOME-Desktop zu erreichen und doch auch unter KDE, Windows oder MacOS X ein bekanntes Erscheinungsbild zu wahren, sollten Sie den Tango Style guidelines folgen, wenn Sie Symbole erstellen. Das Dokument erklärt die verschiedenen Aspekte beim Entwerfen von Symbolen, einschließlich Farben, Lichteinfall und Größen. Einige typische Arbeitsschritte hierzu und Video-Anleitungen stehen ebenfalls bereit.

#### Referenzen

Icon Theme Specification — Beschreibt die themenbasierte Installation von und Suche nach Symbolen.

Icon Naming Specification — Stellt ein grundlegendes Benennungsschema für Symboldateien bereit.

Tango Style Guidelines — Hier finden Sie eine Beschreibung, wie Sie saubere und plattformübergreifend verwendbare Symbolsätze erstellen können.

### Hinzufügen von MIME-Typen

Falls Ihre Anwendung spezifische MIME-Typen öffnen kann, sollte der Desktop in der Dasktop-Datei darüber in Kenntnis gesetzt werden. Wenn Ihre Anwendung beispielsweise PNG-Dateien akzeptiert, fügen Sie die folgende Zeile zur Desktop-Datei hinzu:

    MimeType=image/png

Zusätzliche MIME-Typen können Sie einbinden, indem Sie die verschiedenen Typen mit Semikola voneinander trennen.

Das System kennt bereits eine große Anzahl von MIME-Typen. Falls Sie einen eigenen MIME-Typ erstellen wollen, müssen Sie diesen in der MIME-Datenbank registrieren. Erstellen Sie im Ordner `/usr/share/mime/packages/` eine XML-Datei in dem in gezeigten Format.

#### Beispieldatei für die Registrierung eines neuen MIME-Typs

    <?xml version="1.0" encoding="UTF-8"?>
    <mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
       <mime-type type="application/x-Beispiel">
         <comment>Example file type </comment>
         <magic priority="50">
           <match value="Suchstring" type="string" offset="10:140"/>
         </magic>
         <glob pattern="*.Neue_Erweiterung"/>
       </mime-type>
    </mime-info>

Ersetzen Sie in diesem Beispiel den vorgegebenen MIME-Typ durch Ihren eigenen MIME-Typ. Der Abschnitt magic sucht Dateien anhand des Suchstrings zur Identifizierung. Die Zeile glob verwendet die Erweiterung des Dateinamens zur Identifizierung.

Weil der Befehl `magic` den Rechner dazu zwingt, die Dateien zur Suche nach dem String zu öffnen, sollte der Befehl `glob` bevorzugt werden.

Sobald Ihr neuer MIME-Typ angemessen in der Datei beschrieben ist, führen Sie Folgendes in einer Befehlszeile aus:

    update-mime-database /usr/share/mime

Weitere Informationen über die Auswahl eines passenden MIME-Typ-Erweiterung und deren Registrierung erhalten Sie auf der IANA-Webseite.

#### Referenzen

Shared MIME Info Specification — Beschreibt das MIME-Registrierungssystem im Detail.

## Tiefere Integration in den Desktop

Dieser Abschnitt enthält eine Liste, was Sie tun können, um Ihre Anwendung besser in GNOME zu integrieren, über das absolute Minimum hinaus. Beispielsweise ist GNOME fähig, beim Laden einer Anwendung eine Rückmeldung anzuzeigen. Wie Sie dieses Funktionsmerkmal aktivieren können, sehen Sie in . Und falls Ihre Anwendung Dokumente oder andere »druckbare« Daten anlegt, können Sie ein Vorschaubilder-Werkzeug installieren, mit Hilfe dessen der Dateimanager dann Vorschaubilder spezifisch zu Ihrem Programm erzeugen kann.

### Start-Rückmeldungen

Obwohl die in gezeigten Felder genug Informationen für die Berücksichtigung Ihrer Anwendung durch den Desktop bereitstellen, gibt es für bestimmte Fälle einige weitere nützliche Felder. Eines davon ist startup notification.

Wenn die Start-Rückmeldung eingeschaltet ist, dann weisen das Panel und der Mauszeiger den Benutzer auf den Start hin. Sobald die Anwendung auf dem Bildschirm erscheint, werden Panel und Mauszeiger in den normalen Zustand zurück versetzt.

Um in den Anwendungsstarter die Information einzufügen, dass Ihre Anwendung Start-Rückmeldung unterstützt, fügen Sie die folgende Zeile zu Ihrer Desktop-Datei hinzu:

`StartupNotify=true`

Dieser Befehl in der Desktop-Datei aktiviert eine Form der Start-Rückmeldung in Ihrem Desktop, die entweder durch Ihre Anwendung oder die Entwicklungsumgebung bereitgestellt wird. Die meisten modernen Entwicklungsumgebungen arbeiten nachvollziehbar mit dem Rückmeldungssystem. Wenn Sie eine solche Entwicklungsumgebung verwenden, dann hilft Ihnen die Startup Notification Spec bei dessen Implementation.

Unabhängig von der eingesetzten Entwicklungsumgebung gibt es einen Anwendungstyp, bei dem Sie manuell für die Anzeige von Rückmeldungen sorgen müssen. Anwendungen, bei denen ein neues Anwendungsfenster geöffnet wird, ohne einen neuen Prozess zu starten, können auf diesen Mechanismus nicht zurückgreifen. Der Wert der Variablen DESKTOP_LAUNCH_ID muss an Ihrer Anwendung vorbeigeleitet werden, so dass das Rückmeldungssystem des neuen Fensters funktioniert. Falls Sie GTK+ verwenden, finden Sie in der Dokumentation von `gdk_notify_startup_complete()` etwas mehr Information.

#### Referenzen

Startup Notification Protocol — Beschreibt grundlegende Details der Implementation von Start-Rückmeldungen im X-Window-System.

### Installation eines Vorschaubilder-Programms

Der GNOME-Dateimanager Nautilus kann kleine Vorschaubilder für Dateien anstelle von allgemeinen Symbolen in seinen Dateilisten anzeigen. Beispielsweise kann das Dokument einer Textverarbeitung eine verkleinerte Version der ersten Seite dieses Dokuments anzeigen. Das ist nützlich, weil Benutzer dadurch eine kleine Vorschau der sichtbaren Daten in ihren Dateien sehen, was sie bei der Suche nach Dateien unterstützt. Mit einigen wenigen Schritten statten Sie Ihre Anwendung mit dieser Funktionalität aus.

Ein Thumbnailer ist ein Programm ohne Benutzerschnittstelle, das anhand einer Datei und eines Pixelwerts als Eingabe eine Vorschau für diese Datei erstellt. GNOME stellt anhand des MIME-Typs der Datei fest, welches Vorschaubilder-Programm für die Erzeugung in Frage kommt. Die Zuordnung von MIME-Typen zu den Vorschaubilder-Programmen geschieht mit einer Reihe von GConf-Schlüsseln.

Für jeden zu verarbeitenden MIME-Typ müssen sie ein GConf-Schlüsselpaar erstellen:

`/desktop/gnome/thumbnailers/application@x-foo/enable`

  Typ: boolean. Legt fest, ob dieser Thumbnailer ausgeführt wird. Sie können jeden individuellen Thumbnailer aktivieren oder deaktivieren. Wenn Sie einen neuen Thumbnailer installieren, müssen Sie den Wert dieses Schlüssels natürlich auf »WAHR« setzen.

`/desktop/gnome/thumbnailers/application@x-foo/command`

  Typ: string. Der Befehl, den GNOME verwendet, wenn die Erzeugung eines Vorschaubildes für eine Datei des Typs application@x-foo notwendig ist. Beispielsweise könnte der Wert »`application-x-foo-thumbnailer %i %o %s`« sein. Nachfolgend finden Sie eine Erklärung der Prozentzeichen.

Jeder MIME-Typ benötigt zwei Schlüssel (`enable` und `command`) im gleichen Pfad. Der Pfadname kann aus dem MIME-Typ selbst durch Ersetzung von »`/`« durch »`@`« erstellt werden. Beispielsweise benötigt ein Thumbnailer für `image/x-my-format` zwei Schlüssel: `/desktop/gnome/thumbnailers/image@x-my-format/enable` und `/desktop/gnome/thumbnailers/image@x-my-format/command`.

Im Schlüssel `command` sucht GNOME nach Prozentzeichen und ersetzt diese durch die aktuellen Werte.

`%i` | Name der Eingabedatei. Dies ist die Datei, die durch den Thumbnailer gelesen wird.
`%u` | Eingabeadresse. Falls Ihr Thumbnailer mit Adressen anstelle von gewöhnlichen Dateinamen umgehen kann, verwenden Sie `%u` anstelle von `%i`.
`%o` | Name der Ausgabedatei. In diese Datei schreibt der Thumbnailer das Vorschaubild im PNG-Format.
`%s` | Größe des Vorschaubildes als einzelner Integer. Wenn dies beispielsweise durch `128` ersetzt wird, dann gibt der Thumbnailer ein Bild aus, das nicht größer als 128x128 Pixel ist.

Entweder `%i` oder `%u` müssen in Ihrem Befehl erscheinen, und `%o` ist ebenfalls obligatorisch. Die `%s`-Ersetzung ist optional, aber wir empfehlen, dass Ihr Thumbnailer auch dies berücksichtigen sollte.

#### Zusätzliche Information

Als weiteren Konfigurationsparameter können Sie den Boole'schen Schlüssel `/desktop/gnome/thumbnailers/disable_all` einschalten, um die Erzeugung aller Vorschaubilder zu deaktivieren.

## Integrations-Checkliste

Dieser Anhang stellt eine Checkliste für die verschiedenen Aufgaben bereit, die in diesem Handbuch behandelt werden. Sie können mit dieser Checkliste sicherstellen, dass Ihre Software zumindest grundlegend in GNOME integriert ist. Außerdem ist diese Liste als Ressource für die Planung weiterer Integrationsaufgaben verwendbar.

1. Erscheint Ihre Anwendung in den Menüs des GNOME-Panels?

2. Hat Ihre Anwendung ein Symbol für die Panel-Menüs oder den Desktop? Falls ja, stehen die Symbole in verschiedenen Größen und auch eine skalierbare SVG-Version bereit?

3. Falls Ihre Anwendung Dateien öffnen oder speichern kann, werden die MIME-Typen registriert, mit denen sie umgehen kann?

4. Stellt Ihre Anwendung MIME-Symbole für den Dateimanager bereit?

5. Unterstützt Ihre Anwendung Benachrichtigungen beim Start, so dass GNOME Rückmeldungen an den Benutzer anzeigen kann, wenn die Anwendung geladen wird?

6. Falls Ihre Anwendung »druckbare« Dokumente erzeugt, wird dann ein Vorschaubild für die Verwendung im Dateimanager installiert?

## Danksagungen

Vielen Dank an Jakub Steiner für die Bereitstellung einer schönen CSS-Stilvorlage für die HTML-Version dieses Handbuchs!