test

CDE Handbuch für fortgeschrittene Benutzer und Systemverwalter

Kapitel 5 Anwendungen registrieren

In diesem Kapitel wird beschrieben, wie ein Registrierungspaket für eine Anwendung erstellt wird und wie die Anwendung auf dem Desktop registriert wird.

Wenn eine Anwendung vollständig auf dem Desktop registriert ist, besitzt sie folgende Komponenten:

Bei der Anwendungsregistrierung handelt es sich um eine Operation, die die Anwendung nicht beeinflußt:

In folgenden Fällen wird ein Registrierungspaket erstellt:

Übersicht zur Anwendungsregistrierung

Dieser Abschnitt erläutert folgende Themen:

Hinweis –

Ein detailliertes Beispiel zur Registrierung einer vorhandenen Anwendung finden Sie im Abschnitt Beispiel zur Erstellung eines Registrierungspakets.

Durch die Anwendungsregistrierung bereitgestellte Funktionen

Die Anwendungsregistrierung bietet folgende grafische Darstellungsfunktionen für den Benutzer:

Abbildung 5–1 Anwendungsgruppen in der obersten Ebene des Anwendungsmanagers

Graphic

Abbildung 5–2 Anwendungsgruppe mit einem Symbol zum Starten der Anwendung

Graphic

Abbildung 5–3 Pop-Up-Menü einer Datendatei mit den Optionen 'Öffnen' und 'Drucken'

Graphic

Zweck der Anwendungsregistrierung

Eine registrierte Desktop-Anwendung verfügt über verschiedene Konfigurationsdateien, die das Desktop verwendet, um die Benutzerschnittstelle der Anwendung zur Verfügung zu stellen:

Damit diese Dateien vom Desktop erkannt und verwendet werden können, müssen sie sich in Verzeichnissen befinden, die in den Suchpfaden des Desktops angegeben sind.

Die Verwaltung einer Anwendung wird erschwert, wenn ihre Konfigurationsdateien auf viele verschiedene Verzeichnisse verteilt sind. Daher kann eine Anwendung alle Desktop-Konfigurationsdateien in einem Verzeichnis speichern. Diese Dateigruppierung wird als Registrierungspaket bezeichnet.

Ist die Anwendung Desktop-fähig, stellt sie ein Registrierungspaket als Bestandteil des Installationspakets zur Verfügung. Erstellt der Systemverwalter die Konfigurationsdateien selbst, kann er auch das Registrierungspaket erstellen.

Die Konfigurationsdateien im Registrierungspaket sind für das Desktop nicht verfügbar, weil sie sich nicht in den Verzeichnissen im Suchpfad befinden. Das Kopieren dieser Dateien an die richtige Position wird alsRegistrierung oder Integration der Anwendung bezeichnet.

Das Desktop stellt das Werkzeug dtappintegrate zur Verfügung, das die Registrierung durchführt, indem es symbolisch verknüpfte Repräsentationen der Dateien in den richtigen Verzeichnissen im Suchpfad erstellt.

Viele Desktop-fähige Anwendungen führen dtappintegrate während des Installationsprozesses automatisch aus. Integriert ein Systemverwalter eine bereits vorhandene Anwendung, kann er das Dienstprogramm ausführen, nachdem das Registrierungspaket erstellt wurde.

Sobald eine Anwendung auf dem Desktop eines Systems registriert ist, steht die Anwendung allen Benutzern des Systems zur Verfügung. Ist das System als Desktop-Anwendungs-Server konfiguriert, steht die Anwendung außerdem allen anderen Systemen im Netzwerk zur Verfügung.

Das Werkzeug dtappintegrate verfügt über eine Befehlszeilenoption, die den Prozeß rückgängig macht, indem sie die Verknüpfungen löst. Es ist daher kein Problem, die Anwendung aus dem Anwendungsmanager zu entfernen, um sie einem anderen Anwendungs-Server hinzuzufügen oder sie zu aktualisieren.

Allgemeine Schritte zur Registrierung einer Anwendung

Hinweis –

Ein ausführliches Beispiel, bei dem anhand dieser Schritte ein Anwendungpaket erstellt wird, finden Si im Abschnitt Beispiel zur Erstellung eines Registrierungspakets.

  1. Ändern Sie alle Anwendungsressourcen, die Schriftarten und Farben festlegen. Andernfalls arbeiten die dynamischen Schriftarten und Farben des Desktops nicht richtig.

    Weitere Informationen finden Sie im Abschnitt Schritt 1: Schriftarten- und Farbressourcen ändern.

  2. Erstellen Sie ein Anwendungsstammverzeichnis.

    Weitere Informationen finden Sie im Abschnitt Schritt 2: Desktop-Anwendungsstammverzeichnis erstellen.

  3. Erstellen Sie die Verzeichnisstruktur unter dem Stammverzeichnis der Anwendung.

    Weitere Informationen finden Sie im Abschnitt Schritt 3: Registrierungspaketverzeichnisse erstellen.

  4. Erstellen Sie Aktionen und Datentypen für die Anwendung.

    Weitere Informationen finden Sie im Abschnitt Schritt 4: Aktionen und Datentypen für die Anwendung erstellen.

  5. Kopieren Sie die Hilfedateien in ein geeignetes Verzeichnis.

    Weitere Informationen finden Sie im Abschnitt Schritt 5: Hilfedateien in das Registrierungspaket einfügen.

  6. Erstellen Sie Symbole für die Anwendung.

    Weitere Informationen finden Sie im Abschnitt Schritt 6: Symbole für die Anwendung erstellen.

  7. Erstellen Sie die Anwendungsgruppe für die Anwendung.

    Weitere Informationen finden Sie im Abschnitt Schritt 7: Die Anwendungsgruppe erstellen.

  8. Registrieren Sie die Anwendung mit dtappintegrate.

    Weitere Informationen finden Sie im Abschnitt Schritt 8: Anwendungen mit dtappintegrate registrieren.

Schritt 1: Schriftarten- und Farbressourcen ändern

Hinweis –

Ein Beispiel zur Änderung der Ressourcen für eine Anwendung finden Sie in Schritt 1 im Abschnitt Beispiel zur Erstellung eines Registrierungspakets.

Das Desktop stellt Mechanismen für das Festlegen und Bearbeiten von Schnittstellen-Schriftarten und Fensterfarben zur Verfügung. Damit eine Anwendung diese Mechanismen ohne Probleme verwenden kann, muß möglicherweise die Datei app-defaults der Anwendung geändert werden.

Schriftartenressourcen ändern

Hinweis –

Dieser Abschnitt bezieht sich auf Anwendungen, die mit OSF/Motif 1.2™ (oder neueren Versionen) erstellt wurden. Der Style Manager kann keine Schnittstellen-Schriftarten für Anwendungen festlegen, die mit älteren Versionen von OSF/Motif geschrieben wurden.

Der Style Manager des Desktop setzt Schnittstellen-Schriftarten für Anwendungen, die mit OSF/Motif 1.2 (oder neueren Versionen) erstellt wurden, sofern die Anwendung keine anwendungsspezifische Schnittstellen-Schriftarten verwendet.

Der Style Manager stellt zwei Schriftarten zur Verfügung:

Systemschriftart — wird vom System für Beschriftungen, Menüs und Tasten verwendet.

Benutzerschriftart — wird für bearbeitbare Bereiche wie Textfelder verwendet.

Jede Schriftart steht in sieben Größen, die im Dialogfenster 'Schrift' mit 1 bis 7 bezeichnet sind, zur Verfügung. Die Schriftarten des Style Manager werden durch die Style Manager-Ressourcen, die in /usr/dt/app-defaults/sprache/Dtstyle festgelegt werden, den tatsächlichen Schriftarten des Systems zugeordnet.

Soll die Anwendung Schriftarten des Style Manager verwenden, müssen alle Anwendungsressourcen, die Schnittstellen-Schriftarten angeben, entfernt werden. Das Desktop legt die Ressourcen für die Anwendung automatisch fest:

FontList — Systemschriftart

XmText*FontList — Benutzerschriftart

XmTextField*FontList — Benutzerschriftart

Farbressourcen ändern

Der Style Manager kann Anwendungsfarben dynamisch ändern. Die Anwendung muß ein OSF/Motif 1.1– oder 1.2–Client sein. Clients, die mit anderen Toolkits geschrieben wurden, können Farben nicht dynamisch ändern. In diesen Fällen muß der Client neu gestartet werden.

Der einfachste Weg zur Verwendung der dynamischen Farben des Desktops ist das Löschen aller Farbressourcen der Anwendung für die Hintergrund- und die Vordergrundfarbe.

Schritt 2: Desktop-Anwendungsstammverzeichnis erstellen

Hinweis –

Ein Beispiel zur Erstellung des Desktop-Anwendungsstammverzeichnisses für eine Anwendung finden Sie in Schritt 2 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Die Dateien des Registrierungspakets werden im Anwendungsstammverzeichnis app_root gruppiert. Das Verzeichnis app_root für die Desktop-Konfigurationsdateien kann mit dem Installationsverzeichnis app_root der Anwendung identisch sein oder sich an einer anderen Position befinden.

Ein Beispiel: Eine Anwendung ist im Verzeichnis /usr/BTE installiert. Dieses Verzeichnis kann gleichzeitig als app_root für die Desktop-Konfigurationsdateien verwendet werden. Wenn Sie jedoch eine Anwendung integrieren, die nicht Desktop-fähig ist, sollten Sie ein eigenes Desktop-Verzeichnis app_root erstellen. Dieses Vorgehen verhindert das Überschreiben der von Ihnen erstellten Konfigurationsdateien, wenn die Anwendung aktualisiert wird.

Ein Systemadministrator kann also beispielsweise das Verzeichnis /etc/desktop_approots/BTE als Desktop-Verzeichnis app_root erstellen.

Schritt 3: Registrierungspaketverzeichnisse erstellen

Hinweis –

Ein Beispiel zum Erstellen von Registrierungspaketverzeichnissen für eine Anwendung finden Sie in Schritt 3 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Das Registrierungspaket ist die Gruppe von Desktop-Konfigurationsdateien, die vom Desktop zur Bereitstellung der grafischen Benutzeroberfläche für die Anwendung verwendet werden.

Inhalt des Registrierungspakets

Zu den Desktop-Konfigurationsdateien gehören:

Abbildung 5–4 Ein Registrierungspaket unter einem Anwendungsstammverzeichnis

Graphic

Die wichtigsten Kategorien der Konfigurationsdateien unter dem Verzeichnis app_root/dt/appconfig sind in Tabelle 5–1dargestellt.

Tabelle 5–1 Wichtige Konfigurationsfeldkategorien

Unterverzeichnis 

Inhalt 

types

Definitionsdateien für Aktionen und Datentypen 

help

Desktop-Hilfedateien  

icons

Bitmap- und Pixmap-Dateien, die von den Aktionen und Datentypen der Anwendung verwendet werden 

appmanager

Verzeichnis und Inhalte, die die Anwendungsgruppe bilden 

Jede dieser Kategorien verfügt über Unterverzeichnisse für sprachabhängige Dateien. Standardsprachdateien befinden sich im Verzeichnis C.

Registrierungspaket erstellen

    Erstellen Sie die folgenden Verzeichnisse. Wenn Sie sprachabhängige Konfigurationsdateien bereitstellen, erstellen Sie ein separates Verzeichnis für jede Sprache. Stellen Sie die Dateien nur für eine Sprache bereit, sollten Sie diese in das Verzeichnis C kopieren.

Abbildung 5–5 Anwendungsgruppe auf der obersten Ebene des Anwendungsmanagers

Graphic

Das Werkzeug dtappintegrate kann nur für die Desktop-Konfigurationsdateien in den Verzeichnissen types, help, icons und appmanager verwendet werden. Die ausführbare Binärdatei der Anwendung, app-defaults, und die Meldungskatalogdateien werden separat verwaltet.

Schritt 4: Aktionen und Datentypen für die Anwendung erstellen

Hinweis –

Ein Beispiel für die Erstellung der Aktionen und Datentypen für eine Anwendung finden Sie in Schritt 4 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Aktionen und Datentypen stellen eine Benutzerschnittstelle für die Anwendung zur Verfügung.

Für eine Anwendung erforderliche Aktionen und Datentypen

Für typische Anwendungen sind folgende Definitionen für Aktionen und Datentypen erforderlich:

Position der Konfigurationsdateien mit den Definitionen für Aktionen und Datentypen

Aktionen und Datentypen werden in Konfigurationsdateien definiert. Bei der Benennung der Dateien muß das Suffix .dt verwendet werden. Per Konvention erhält die Datei den Namen aktionsname.dt oder anwendungsname.dt.

Dateien mit Aktionen und Datentypen sollten unter dem Anwendungsstammverzeichnis im Verzeichnis app_root/dt/appconfig/types/sprache gespeichert werden. Der Standardwet für sprache ist C.

Abbildung 5–6 Definitionsdateien für Aktionen und Datentypen

Graphic

Möglichkeiten zum Erstellen von Aktionen und Datentypen

Definitionen für Aktionen und Datentypen für eine Anwendung können auf zwei verschiedene Weisen erstellt werden:

Aktionen und Datentypen mit 'Aktion erstellen' erstellen

Bei dieser Prozedur wird das Dienstprogramm 'Aktion erstellen' verwendet, um eine Aktion und Datentypen für die Anwendung zu erstellen.

Weitere Informationen zu 'Aktion erstellen' finden Sie in der zugehörigen Online-Hilfe oder im Abschnitt Kapitel 11.

  1. Öffnen Sie die Anwendungsgruppe 'Desktop_Apps', und doppelklicken Sie auf 'Aktion erstellen'.

  2. Verwenden Sie 'Aktion erstellen', um die Definitionen für Aktionen und Datentypen für die Anwendung und deren Datentyp zu erstellen.

    Die mit 'Aktion erstellen' angelegte Konfigurationsdatei wird in das Verzeichnis HomeVerzeichnis/.dt/type/aktionsname.dt geschrieben. Die Aktionsdatei (die ausführbare Datei mit dem Namen der Aktion) wird im Home-Verzeichnis erstellt.

  3. Testen Sie die Aktion mit der im Home-Verzeichnis erstellten Aktionsdatei.

  4. Kopieren Sie die Definitionsdatei der Aktion (HomeVerzeichnis/.dt/type/aktionsname.dt) in das Verzeichnis anwendungstammverzeichnis/dt/appconfig/types/sprache.

  5. Nachdem das Verzeichnis für die Anwendungsgruppe erstellt wurde (siehe Schritt 7: Die Anwendungsgruppe erstellen), kopieren Sie die Aktionsdatei HomeVerzeichnis/aktionsname in das Verzeichnis anwendungstammverzeichnis/dt/appconfig/appmanager/sprache/anwendungsgruppenname.

Aktionen und Datentypen manuell erstellen

    Erstellen Sie eine Konfigurationsdatei mit den Definitionen für Aktionen und Datentypen für die Anwendung.

Definitionsdateien für Aktionen und Datentypen müssen der Namenskonvention name.dt entsprechen.

Sie können alle Definitionen für Aktionen und Datentypen in eine Datei einfügen oder mehrere Dateien verwenden. Jede Datei sollte einen Dateinamen erhalten, dem Systemverwalter die zugehörige Anwendung zuordnen können.

Die Namen für Aktionen und Datentypen müssen aus einem Wort bestehen (keine Leerzeichen). Unterstriche dürfen verwendet werden. Per Konvention wird der erste Buchstabe des Aktions- oder Datentypnamens als Großbuchstabe geschrieben. Es darf kein bereits vorhandener Aktions- oder Dateiname verwendet werden. Es sollte ein Name verwendet werden, dem fortgeschrittene Benutzer und Systemverwalter die zugehörige Anwendung zuordnen können.

Soll das Anwendungssymbol mit einem anderen Namen als dem der Aktion beschriftet werden, geben Sie das Feld LABEL in der Definition der Aktion an.

Weitere Informationen zur Erstellung von Aktionen und Datentypen können folgenden Kapiteln entnommen werden:

Schritt 5: Hilfedateien in das Registrierungspaket einfügen

Hinweis –

Ein Beispiel zum Einfügen von Hilfedateien in ein Registrierungspaket finden Sie in Schritt 5 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Verfügt die Anwendung über einen Desktop-Hilfeband (einen Hilfeband, der mit dem Help Developer's Kit des Desktop erstellt wurde), sollte die Master-Datei für den Hilfeband (*.sdl) in das Verzeichnis app_root/appconfig/help/sprache kopiert werden.

Grafiken für Hilfedateien werden normalerweise in das Unterverzeichnis graphics kopiert. Dieses Unterverzeichnis muß sich relativ zur Master-Datei für den Hilfeband (*.sdl) in demselben Unterverzeichnis wie zum Zeitpunkt der Erstellung des Hilfebands befinden.

Besitzt die Anwendung keinen Hilfeband, können Sie gegebenenfalls mit Help Developer's Kit einen eigenen Band erstellen.

Es gibt zwei Integrationsstufen für einen Hilfeband:

Schritt 6: Symbole für die Anwendung erstellen

Hinweis –

Ein Beispiel zur Erstellung der Symboldateien für eine Anwendung finden Sie in Schritt 6 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Das Desktop stellt Standardsymbole für Aktionen, Datentypen und Anwendungsgruppen zur Verfügung. Sie können aber auch eigene Symbole für die Anwendung erstellen.

Symbole befinden sich im Verzeichnis app_root/dt/appconfig/icons/sprache.

Für das Desktop erforderliche Symbole

Die Anwendung verwendet folgende Symbole auf dem Desktop:

Tabelle 5–2 Namenskonventionen für Symboldateien

Größe 

Maße in Pixel  

Bitmap-Name 

Pixmap-Name 

Winzig 

16 x 16 

basisname.t.bm

basisname.t.pm

Mittel 

32 x 32 

basisname.m.bm

basisname.m.pm

Groß 

48 x 48 

basisname.l.bm

basisname.l.pm

Werden keine Bitmap-Dateien zur Verfügung gestellt, ordnet das Desktop den Farbwerten Schwarz- und Weißwerte zu. Dabei kommt es möglicherweise zu Abweichungen vom gewünschten Erscheinungsbild.

Weitere Informationen zu Symbolen finden Sie im Abschnitt Symbolbilddateien.

Schritt 7: Die Anwendungsgruppe erstellen

Hinweis –

Ein Beispiel zur Erstellung einer Anwendungsgruppe finden Sie in Schritt 7 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Nachdem die Definitionen für Aktionen und Datentypen für die Anwendung erstellt wurden, müssen die Konfigurationsdateien für die Bildschirmanzeige, also die Anwendungsgruppe und deren Inhalt erstellt werden.

Die Anwendungsgruppe ist ein Verzeichnis in der obersten Ebene des Anwendungsmanagers (siehe Abbildung 5–1).

Anwendungsgruppen werden in drei Schritten erstellt:

Das Anwendungsgruppenverzeichnis erstellen

Um eine Anwendungsgruppe zu erstellen, legen Sie die Verzeichnisse im Registrierungspaket unter appmanager an siehe Abbildung 5–7.

Abbildung 5–7 Das Verzeichnis appmanager

Graphic

Name der Anwendungsgruppe

Der <anwendungsgruppenname> in Abbildung 5–7 ist der Name der Anwendungsgruppe.

Abbildung 5–8 Der Anwendungsgruppenname (<anwendungsgruppenname>)

Graphic

Bei dem Namen kann es sich um jeden zulässigen Dateinamen bzw. Verzeichnisnamen handeln. Der Name sollte die Anwendung beschreiben.

Eindeutige Symbole für Anwendungsgruppen konfigurieren

Das Desktop stellt ein Standardsymbol für Anwendungsgruppen zur Verfügung. Sie können jedoch ein eigenes Symbol erstellen.

Möchten Sie ein eindeutiges Symbol für die Anwendungsgruppe erstellen, müssen Sie folgende Komponenten erstellen:

Abbildung 5–9 Einer Anwendungsgruppe ein eindeutiges Symbol zuweisen

Graphic

Sie sollten außerdem die Aktionen 'Öffnen' und 'Drucken' für den Datentyp der Anwendungsgruppe erstellen: 

ACTION Open
 {
 	ARG_TYPE			Media_ToolsAppGroup
 	TYPE				MAP
 	MAP_ACTION		OpenAppGroup
 }
ACTION Print
 {
 	ARG_TYPE			Media_ToolsAppGroup
 	TYPE				MAP
 	MAP_ACTION		PrintAppGroup
 }

Die Aktionen 'OpenAppGroup' und 'PrintAppGroup' sind integrierte Aktionen, deren Definition sich in /usr/dt/appconfig/types/sprache/dtappman.dt befindet.

Inhalt der Anwendungsgruppe erstellen

Das wichtigste Element in einer Anwendungsgruppe ist ein Symbol, mit dem die Anwendung gestartet wird (ein Aktionssymbol). Enthält die Anwendungsgruppe mehrere Anwendungen, gibt es normalerweise ein Symbol für jede Anwendung.

Zusätzlich zu einem oder mehreren Aktionssymbolen kann die Anwendungsgruppe folgendes enthalten:

Die Aktionsdatei (Anwendungssymbol) erstellen

Die Anwendungsgruppe sollte ein Symbol enthalten, das die Anwendung startet. Enthält die Gruppe mehrere Anwendungen, sollte für jede Anwendung ein Symbol vorhanden sein. Diese Symbole werden Anwendungssymbole oder Aktionssymbole genannt, da sie die zugrundeliegende Aktion repräsentieren.

Eine Aktionsdatei ist eine ausführbare Datei mit dem Namen der auszuführenden Aktion:

app_root/dt/appconfig/appmanager/anwendungsgruppennname/aktionsname

Diese Datei wird Aktionsdatei genannt, da sie eine visuelle Repräsentation der zugrundeliegenden Aktion erstellt.

Haben Sie beispielsweise eine Aktion namens 'BesterTextEditor' für das Ausführen der Anwendung 'BesterTextEditor' erstellt, wird eine ausführbare Datei mit dem Namen 'BesterTextEditor' benötigt. Im Dateimanager und im Anwendungsmanager verwendet die Aktionsdatei die in der Aktionsdefinition angegebene Symboldatei.

Abbildung 5–10 illustriert die Beziehung zwischen der Aktionsdefinition, der Aktionsdatei und dem sichtbaren Eintrag im Fenster des Anwendungsmanagers.

Abbildung 5–10 Das Anwendungssymbol ist eine Datei in der Anwendungsgruppe

Graphic

Readme-Dateien

Das Desktop stellt den Datentyp README für die README-Dateien von Anwendungen zur Verfügung. Verwenden Sie die folgenden Namenskonventionen:

Ein spezialisiertes Bedienelement im Bedienfeld erstellen

In den meisten Fällen ist es nicht notwendig, eine Definition für das Bedienelement im Bedienfeld bereitzustellen. Der Benutzer kann die Anwendung dem Bedienfeld hinzufügen, indem er das Aktionssymbol auf dem Bedienelement 'Symbol installieren' eines untergeordneten Bedienfeldes ablegt.

Sie können eine Konfigurationsdatei für ein Bedienfeld mit einer Elementdefinition für die Anwendung erstellen, damit Benutzer ein Bedienelement installieren können, das andere Eigenschaften als das Aktionssymbol aufweist - beispielsweise ein Bedienelement zur Überwachung einer Datei, dessen Erscheinungsbild sich ändert, wenn die betreffende Datei geändert wird.

Die Konfigurationsdateien für Bedienfelder werden im Verzeichnis app_root/dt/appconfig/types/sprache gespeichert. Die Namenskonvention lautet name.fp.

Wenn Sie eine Konfigurationsdatei mit einem Bedienelement bereitstellen, kann der Benutzer das Bedienelement in ein untergeordnetes Bedienfeld einfügen, indem er die *.fp-Datei auf dem Bedienelement 'Symbol installieren' des untergeordneten Bedienfeldes ablegt.

Beispielsweise kann die folgende Definition in eine Bedienfeldkonfigurationsdatei in der Anwendungsgruppe eingefügt werden. Übergibt der Benutzer diese Datei dem Bedienelement 'Symbol installieren' eines untergeordneten Bedienfeldes, wird im Bedienfeld ein Bedienelement erstellt, das eine Instanz der Anwendung 'BesterTextEditor' ausführt. Wurde 'BesterTextEditor' bereits gestartet, wird das Fenster im aktuellen Arbeitsbereich in den Vordergrund gebracht.

CONTROL BesterTextEditorControl
 {
 	TYPE						icon
 	ICON						BTEFPanel	
 	PUSH_RECALL				True
 	CLIENT_NAME				BTEd
 	PUSH_ACTION				BTEditor
 	DROP_ACTION				BTEditor
 	HELP_STRING				Startet die Anwendung BesterTextEditor.
 }

Weitere Informationen zum Erstellen von Bedienfeldkonfigurationsdateien finden Sie in:

Schritt 8: Anwendungen mit dtappintegrate registrieren

Hinweis –

Ein Beispiel zur Registrierung einer Anwendung finden Sie in Schritt 8 des Abschnitts Beispiel zur Erstellung eines Registrierungspakets.

Sobald ein Registrierungspaket in einem Anwendungsstammverzeichnis erstellt wurde, kann die Anwendungsregistrierung durchgeführt werden.

Bei der Anwendungsregistrierung werden Verweise zwischen dem Registrierungspaket und den Verzeichnissen im Suchpfad des Desktop eingerichtet (siehe Wie dtappintegrate Anwendungen integriert).

So registrieren Sie Anwendungen mit dtappintegrate

Ist die Anwendung Desktop-fähig, wird dtappintegrate als letzter Schritt des Installationsprozesses automatisch ausgeführt. Erfolgt die Ausführung nicht automatisch, oder haben Sie Konfigurationsdateien zur Integration einer nicht Desktop-fähigen Anwendung erstellt, können Sie dtappintegrate manuell ausführen.

  1. Melden Sie sich als Benutzer "root“ an.

  2. Führen Sie den folgenden Befehl aus:

    	/usr/dt/bin/dtappintegrate -s app_root

    app_root ist das Desktop-Anwendungsstammverzeichnis. Weitere Informationen finden Sie auf der Hilfeseite dtappintegrate(1).

  3. Öffnen Sie die Anwendungsgruppe 'Desktop-Anwendungen', und doppelklicken Sie auf 'ErneutLaden'.

  4. Prüfen Sie, ob die Anwendung richtig registriert wurde:

    1. Zeigen Sie die oberste Ebene des Anwendungsmanagers an. Die neue Anwendungsgruppe sollte im Anwendungsmanager sichtbar sein.

    2. Öffnen Sie die Anwendungsgruppe, und doppelklicken Sie auf das Aktionssymbol.

Syntax und Optionen für dtappintegrate 

dtappintegrate -s  app_root [-t zielpfad ] [-l sprache ] [-u]

-s app_root

Erforderlicher Parameter, der das Anwendungsstammverzeichnis angibt, in dem die Anwendung installiert wurde. 

-t zielpfad

Optionaler Parameter mit dem Systemverzeichnis /etc/dt/appconfig als Standardwert. Bestimmt die Position, auf die die Desktop-Konfigurationdateien einen Verweise erstellen. Sie müssen eines der Verzeichnisse im Anwendungssuchpfad verwenden.

-l sprache

Optionaler Parameter, der standardmäßig alle Sprachen berücksichtigt. Gibt die zu integrierenden sprachabhängigen Konfigurationsdateien an. 

-u

Optionaler Parameter, der die Integration einer Anwendung rückgängig macht und alle während der Integration eingerichteten Verknüpfungen entfernt. 

Wie dtappintegrate Anwendungen integriert

dtappintegrate richtet Verweise zwischen den installierten Dateien und den Verzeichnissen ein, in denen das Desktop die Konfigurationsdateien sucht.

Aktionen und Datentypen

dtappintegrate erstellt symbolische Verweise zwischen den Definitionsdateien für Aktionen und Datentypen im Registrierungspaket und dem für das System definierten Verzeichnis im Suchpfad der Aktionsdatenbankhilfe. Hierzu werden Verweise erstellt zwischen

app_root/dt/appconfig/types/sprache/*.dt

auf

/etc/dt/appconfig/types/sprache/*.dt

Hilfeinformationsdateien

dtappintegrate erstellt symbolische Verweise zwischen den Hilfedateien im Registrierungspaket und dem für das System definierten Verzeichnis im Hilfesuchpfad. Hierzu werden Verweise erstellt zwischen 

app_root/dt/appconfig/help/sprache/hilfedatei.sdl

auf

/etc/dt/appconfig/help/sprache/hilfedatei.sdl

Symboldateien

dtappintegrate erstellt symbolische Verweise zwischen den Symboldateien im Registrierungspaket und dem für das System definierten Verzeichnis im Symbolsuchpfad. Hierzu werden Verweise erstellt zwischen

app_root/dt/appconfig/icons/sprache/symboldateien

auf

/etc/dt/appconfig/icons/sprache/symboldateien

Anwendungsgruppe

Um die Anwendungsgruppe für die Anwendung in die oberste Ebene des Anwendungsmanagers einzufügen, erstellt dtappintegrate einen Verweis vom Anwendungsgruppenverzeichnis im Registrierungspaket auf das für das System definierte Verzeichnis im Anwendungssuchpfad. Dies erfolgt durch Erstellung von Verweisen zwischen

app_root/dt/appconfig/appmanager/sprache/anwendungsgruppenname

auf

/etc/dt/appconfig/appmanager/sprache/anwendungsgruppenname

Beispiel zur Erstellung eines Registrierungspakets

Mit den folgenden Schritten wird ein Registrierungspaket für eine bereits vorhandene, nicht Desktop-fähige Anwendung mit dem Namen 'BesterTextEditor' erstellt.

Erforderliche Informationen zu 'BesterTextEditor'

Im Beispiel werden die folgenden Daten zur Anwendung 'BesterTextEditor' vorausgesetzt:

Schritte zum Registrieren von 'BesterTextEditor'

Mit den folgenden Schritten wird BesterTextEditor registriert.

  1. Ändern Sie die Schriftarten- und Farbressourcen.

    In der Datei app-defaults von BesterTextEditor müssen Ressourcen mit folgenden Einstellungen entfernt werden:

    • Schriftarten für Text

    • Farben für Vorder- und Hintergrund

  2. Erstellen Sie das Anwendungsstammverzeichnis.

    Erstellen Sie das folgende Verzeichnis:

    	/desktop_approots/BTE

    Wird eine bereits vorhandene Anwendung integriert, sollte das Anwendungsstammverzeichnis nicht im Installationsverzeichnis eingerichtet werden, da andernfalls die erstellten Konfigurationsdateien bei einer Aktualisierung der Anwendung möglicherweise gelöscht werden.

  3. Erstellen Sie die Registrierungspaketverzeichnisse.

    Erstellen Sie die folgenden Verzeichnisse:

    	/desktop_approots/BTE/dt/appconfig/types/C
 	/desktop_approots/BTE/dt/appconfig/help/C
 	/desktop_approots/BTE/dt/appconfig/icons/C
 	/desktop_approots/BTE/dt/appconfig/appmanager/C/BesterTextEditor

  4. Erstellen Sie Aktionen und Datentypen für die Anwendung.

    1. Erstellen Sie die Konfigurationsdatei für die Definitionen für Aktionen und Datentypen:

      		/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt

    2. Die Aktionsdefinition für die Ausführung von BesterTextEditor:

      		ACTION BTEditor
 		{
 				WINDOW_TYPE				NO_STDIO
 				ICON						BTERun
 				DESCRIPTION			Doppelklicken Sie auf dieses Symbol,
										oder legen \
 										Sie eine BTE-Datendatei ab, 
 										um \ BesterTextEditor 
 										auszuführen.
 				EXEC_STRING				/usr/BTE/BTEd %Arg_1%
 		}

    3. Erstellen Sie den Datentyp für *.bte-Dateien:

      		DATA_ATTRIBUTES BTEDataFile
 		{
 				DESCRIPTION				BesterTextEditor-Datendatei.
 				ICON						BTEData
 				ACTIONS					Open,Print
 		}

 		DATA_CRITERIA BTEDataFileCriteria1
 		{
 				DATA_ATTRIBUTES_NAME			BTEDataFile
 				NAME_PATTERN						*.bte
 				MODE									f
 		}

    4. Erstellen Sie den Datentyp für *.tpl-Dateien:

      		DATA_ATTRIBUTES BTETemplateFile
 		{
 				DESCRIPTION			BesterTextEditor-Schablonendatei.
 				ICON					BTETempl
 				ACTIONS				Open
 		}

 		DATA_CRITERIAL BTETemplateFileCriteria1
 		{
 				DATA_ATTRIBUTES_NAME			BTETemplateFile
 				NAME_PATTERN						*.tpl
 				MODE									f
 		}

    5. Erstellen Sie die Aktion 'Öffnen' für *.bte-Dateien:

      		ACTION Open
 		{
 				ARG_TYPE			BTEDataFile
 				TYPE				MAP
 				MAP_ACTION		BTEditor
 		}

    6. Erstellen Sie die Aktion 'Drucken' für *.bte-Dateien:

      Nachstehend finden Sie einfache 'Drucken'-Aktionen, die Datendateien drucken. Diese Aktionen setzen voraus, daß die Umgebungsvariable LPDEST einen Wert enthält. Die Druckoption -s wird ignoriert. (Ist LPDEST nicht gesetzt, kann die Aktion fehlschlagen.)

      		ACTION Print
 		{
 				ARG_TYPE				BTEDataFile
 				TYPE					MAP
 				MAP_ACTION			BTEPrintData
 		}
      		ACTION BTEPrintData
 		{ 		WINDOW_TYPE				NO_STDIO
 				EXEC_STRING				BTEPrint -d $LPDEST %Arg_1%
 		}

      Nachstehend finden Sie eine andere Version der Aktion 'BTEPrintData' und das zugehörige Skript. Diese werden verwendet, wenn LPDEST nicht gesetzt ist oder das Dialogfenster 'Drucken' nicht angezeigt werden soll.

      		ACTION BTEPrintData
 		{
 				WINDOW_TYPE				NO_STDIO
 				EXEC_STRING				/usr/BTE/bin/BTEenvprint \
 											%(File)Arg_1%
 		}

      Das Skript /usr/BTE/bin/BTEenvprint hat folgenden Inhalt:

      		# BTEenvprint
 		#!/bin/sh
 		DEST=““
 		SILENT=““
 		if [ $LPDEST ] ; then
 			DEST=“-d $LPDEST“
 		fi
 		BTEPrint $DEST SILENT $1

    7. Erstellen Sie die Aktion 'Öffnen' für *.tpl-Dateien:

      		ACTION Open
 		{
 				ARG_TYPE			BTETemplateFile
 				TYPE				MAP
 				MAP_ACTION		BTEditor
 		}

    8. Erstellen Sie die Aktion 'Drucken' für *.tpl-Dateien:

      		ACTION Print
 		{
 				ARG_TYPES		BTETemplateFile
 				TYPE				MAP
 				MAP_ACTION		NoPrint
 		}

      NoPrint ist eine integrierte Aktion, die ein Dialogfenster mit dem Hinweis anzeigt, daß die Datei nicht gedruckt werden kann.

  5. Fügen Sie die Hilfedateien in das Registrierungspaket ein.

    1. Kopieren Sie die Hilfedateien in die folgenden Verzeichnisse:

      		/desktop_approots/BTE/dt/appconfig/help/C/BTEHelp.sdl
 		/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE1.xwd
 		/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE2.xwd

    2. Erstellen Sie die folgende Datei:

      		/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt.

      Fügen Sie die folgende Aktionsdefinition in die Datei ein:

      		ACTION BTEHelp
 		{
 				WINDOW_TYPE				NO_STDIO
 				EXEC_STRING				/usr/dt/bin/dthelpview 
 											-helpVolume \
 											BTEHelp.sdl
 				DESCRIPTION				Öffnet den Hilfeband 
 									BesterTextEditor.
 		}

  6. Erstellen Sie die Symbole für die Anwendung.

    Verwenden Sie den Symbol-Editor, um die Symbole zu erstellen. Tabelle 5–3 enthält Hinweise zu den möglichen Größen.

    Tabelle 5–3 Richtlinien zu Symbolgrößen

    Name 

    Größe 

    basisname.t.pm

    16 x 16 

    basisname.m.pm

    32 x 32 

    basisname.l.pm

    48 x 48 

    Erstellen Sie die folgenden Symboldateien im Verzeichnis /desktop_approots/BTE/dt/appconfig/icons/C:

    • Symbole zur Repräsentation der Aktion, die die Anwendung startet: BTERun.t.pm, BTERun.m.pm, BTERun.l.pm

    • Symbole zur Repräsentation der *.bte-Dateien: BTEData.t.pm, BTEData.m.pm,

    • Symbole zur Repräsentation der *.tpl-Dateien: BTETempl.t.pm, BTETempl.m.pm

    • Symbole zur Repräsentation der Anwendungsgruppe (vgl. Schritt 7): BTEApp.t.pm, BTEApp.m.pm

  7. Erstellen Sie die Anwendungsgruppe.

    1. Erstellen Sie das Verzeichnis, wenn dies noch nicht geschehen ist.

      	/desktop_approots/BTE/dt/appconfig/appmanager/C/BesterTextEditor

    2. Dieser Schritt ist optional. Er stellt ein eindeutiges Symbol für die Anwendungsgruppe zur Verfügung, indem ein Datentyp und zugehörige Aktionen für die Anwendungsgruppe erstellt werden. Wird dieser Schritt nicht ausgeführt, verwendet die Anwendungsgruppe das Standardsymbol.

      Fügen Sie die folgenden Definitionen von Datentypen und Aktionen in die Datei /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt ein. Der Datentyp gibt das von der Anwendungsgruppe 'BesterTextEditor' zu verwendende Symbol an. Die Aktionen 'Öffnen' und 'Drucken' entsprechen in ihrer Funktionalität den Aktionen der Anwendungsgruppe.

      		DATA_ATTRIBUTES BesterTextEditorAppGroup
 		{
 				ACTIONS		OpenInPlace,OpenNewView
 				ICON			BTEApp
 		{
      		DATA_CRITERIA BesterTextEditorAppGroupCriterial
 		{
 				DATA_ATTRIBUTES_NAME	BesterTextEditorAppGroup
 				MODE							d
 				PATH_PATTERN				*/appmanager/*/BesterTextEditor
 		}
      		ACTION Open
 		{
 				ARG_TYPE				BesterTextEditorAppGroup
 				TYPE					MAP
 				MAP_ACTION			OpenAppGroup
 		}
      		ACTION Print
 		{
 				ARG_TYPE				BesterTextEditorAppGroup
 				TYPE					MAP
 				MAP_ACTION			PrintAppGroup
 		}

    3. Erstellen Sie in der Anwendungsgruppe ein Symbol zum Starten der Anwendung. Erstellen Sie zu diesem Zweck die Datei:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
 		/BesterTextEditor/BTEditor

      als ausführbare Datei.

    4. Erstellen Sie in der Anwendungsgruppe die Aktionsdatei, mit der der Hilfeband geöffnet wird. Erstellen Sie zu diesem Zweck die Datei:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
 		/BesterTextEditor/BTEHelp

      als ausführbare Datei.

    5. Fügen Sie weitere Dateien in die Anwendungsgruppe ein, beispielsweise README-Dateien, Beispieldaten und Schablonendateien.

  8. Registrieren Sie die Anwendung.

    Führen Sie folgende Schritte in einem Terminal-Emulationsfenster durch:

    1. Melden Sie sich als Benutzer "root“ an.

    2. Führen Sie den folgenden Befehl aus:

      		/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE

    3. Öffnen Sie die Anwendungsgruppe 'Desktop-Anwendungen', und doppelklicken Sie auf 'ErneutLaden'.