Mit den folgenden Schritten wird ein Registrierungspaket für eine bereits vorhandene, nicht desktop-fähige Anwendung mit dem Namen "BesterTextEditor" erstellt.
Im Beispiel werden die folgenden Daten zur Anwendung BesterTextEditor vorausgesetzt:
Die Anwendung wurde im Verzeichnis /usr/BTE installiert.
Die Sitzungssprache des Benutzers entspricht dem Standardwert C.
Die Befehlszeile zum Starten von BesterTextEditor lautet:
BTEd {dateiname]
dateiname ist der Name der Datendatei, die im neuen Fenster geöffnet werden soll. BesterTextEditor erstellt ein eigenes Fenster, wird also nicht in einem Terminalemulationsfenster ausgeführt.
BesterTextEditor erstellt und verwendet zwei Typen von Datendateien:
Dokumentationsdateien. Für diese Dateien gilt die Namenskonvention *.bte. BesterTextEditor stellt eine Befehlszeilenschnittstelle zum Drucken der .bte-Datendateien bereit. Die Syntax dieses Befehls lautet:
BTEPrint [-d ziel] [-s] dateiname
Es gilt:
-d ziel - gibt den Drucker an.
-s - der Ausdruck erfolgt, ohne daß zuvor das Dialogfenster "Drucken" angezeigt wird.
dateiname - gibt die zu druckende Datei an.
Schablonendateien. Für diese Dateien gilt die Namenskonvention *.tpl. Schablonendateien können nicht gedruckt werden.
Die bereits vorhandenen, nicht desktop-fähigen app-defaults-Dateien für "BesterTextEditor" enthalten Ressourcen für Schnittstellenschriftarten sowie Vordergrund- und Hintergrundfarben.
Ein Online-Hilfeband für 'BesterTextEditor' wurde mit dem Help Developer's Kit des Desktop erstellt. Für die Erstellung des Online-Hilfebands wurden folgende Quellendateien verwendet:
.../BTEHelp.htg .../graphics/BTE1.xwd .../graphics/BTE2.xwd
Die Datei .../BTEHelp.sdl wurde generiert.
Mit den folgenden Schritten wird BesterTextEditor registriert.
Ä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
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.
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
Erstellen Sie Aktionen und Datentypen für die Anwendung.
Erstellen Sie die Konfigurationsdatei für die Definitionen für Aktionen und Datentypen:
/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt
Die Aktionsdefinition für die Ausführung von "BesterTextEditor":
ACTION BTEditor { WINDOW_TYPE NO_STDIO ICON BTERun DESCRIPTION Klicken Sie doppelt auf dieses Symbol, oder legen \ Sie eine BTE-Datendatei ab, um \ BesterTextEditor auszuführen. EXEC_STRING /usr/BTE/BTEd %Arg_1% }
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 }
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 }
Erstellen Sie die Aktion "Öffnen" für *.bte-Dateien:
ACTION Open { ARG_TYPE BTEDataFile TYPE MAP MAP_ACTION BTEditor }
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
Erstellen Sie die Aktion "Öffnen" für *.tpl-Dateien:
ACTION Open { ARG_TYPE BTETemplateFile TYPE MAP MAP_ACTION BTEditor }
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.
Fügen Sie die Hilfedateien in das Registrierungspaket ein.
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
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. }
Erstellen Sie die Symbole für die Anwendung.
Verwenden Sie den Symboleditor, 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
Erstellen Sie die Anwendungsgruppe.
Erstellen Sie das Verzeichnis, wenn dies noch nicht geschehen ist.
/desktop_approots/BTE/dt/appconfig/appmanager/C/BesterTextEditor
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 }
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.
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.
Fügen Sie weitere Dateien in die Anwendungsgruppe ein, beispielsweise README-Dateien, Beispieldaten und Schablonendateien.
Registrieren Sie die Anwendung.
Führen Sie folgende Schritte in einem Terminalemulationsfenster durch: