Mediante los siguientes pasos se crea un paquete de registro para una aplicación existente no preparada para el escritorio, llamada BestTextEditor.
En el ejemplo se dan por supuestos los siguientes hechos acerca de la aplicación BestTextEditor:
Se ha instalado en el directorio /usr/BTE.
El idioma de sesión del usuario es el valor predeterminado, C.
La línea de comandos para iniciar BestTextEditor es:
BTEd {nombre_archivo]
donde nombre_archivo es el nombre del archivo de datos que se debe abrir en la nueva ventana. BestTextEditor crea su propia ventana, es decir, no se ejecuta en una ventana de emulador de terminal.
BestTextEditor crea y utiliza archivos de datos de dos tipos:
Archivos de documentación. Utilizan la convención de nombrado *.bte. BestTextEditor proporciona una línea de comandos para imprimir los archivos de datos de tipo .bte. La sintaxis del comando es:
BTEPrint [-d destino] [-s] nombre_archivo
donde:
-d destino: especifica la impresora de destino.
-s: especifica impresión silenciosa. No se muestra el cuadro de diálogo Imprimir de la aplicación.
nombre_archivo: especifica el archivo que se va a imprimir.
Archivos de plantilla. Utilizan la convención de nombrado *.tpl. Los archivos de plantilla no se pueden imprimir.
Los archivos app-defaults existentes de BestTextEditor, que no son de escritorio, contienen recursos para las fuentes de la interfaz y los colores de primer plano y fondo.
Se creó un volumen de ayuda en línea para BestTextEditor mediante el Help Developer's Kit del escritorio. Cuando se construyó el volumen de ayuda en línea, se utilizaron los siguientes archivos fuente:
.../BTEHelp.htg .../graphics/BTE1.xwd .../graphics/BTE2.xwd
y se generó el archivo .../BTEHelp.sdl.
Para registrar BestTextEditor se deberá seguir paso a paso el siguiente proceso:
Modifique los recursos de fuentes y colores.
En el archivo app-defaults de BestTextEditor, elimine los recursos que establecen:
Las fuentes para el texto
Los colores de primer plano y de fondo
Cree el directorio raíz de la aplicación.
Cree el directorio:
/desktop_approots/BTE
Si está integrando una aplicación existente, deberá crear el directorio raíz de la aplicación en un lugar distinto de la ubicación de instalación de la aplicación; de lo contrario, es posible que los archivos de configuración creados se eliminen al actualizar la aplicación.
Cree los directorios del paquete de registro.
Cree estos directorios:
/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/BestTextEditor
Cree las acciones y tipos de datos de la aplicación.
Cree el archivo de configuración para las definiciones de las acciones y tipos de datos:
/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt
Cree la definición de la acción que ejecuta BestTextEditor:
ACTION BTEditor { WINDOW_TYPE NO_STDIO ICON BTERun DESCRIPTION Haga doble clic en este icono o suelte \ en él un archivo de datos BTE \ para ejecutar BestTextEditor. EXEC_STRING /usr/BTE/BTEd Arg_1% }
Cree el tipo de datos para los archivos *.bte:
DATA_ATTRIBUTES BTEDataFile { DESCRIPTION Archivo de datos de BestTextEditor. ICON BTEData ACTIONS Open,Print } DATA_CRITERIA BTEDataFileCriteria1 { DATA_ATTRIBUTES_NAME BTEDataFile NAME_PATTERN *.bte MODE f }
Cree el tipo de datos para los archivos *.tpl:
DATA_ATTRIBUTES BTETemplateFile { DESCRIPTION Archivo de plantilla de BestTextEditor. ICON BTETempl ACTIONS Open } DATA_CRITERIAL BTETemplateFileCriteria1 { DATA_ATTRIBUTES_NAME BTETemplateFile NAME_PATTERN *.tpl MODE f }
Cree la acción Open para los archivos *.bte.
ACTION Open { ARG_TYPE BTEDataFile TYPE MAP MAP_ACTION BTEditor }
Cree la acción Print para los archivos *.bte.
He aquí unas acciones Print sencillas para imprimir los archivos de datos. Estas acciones necesitan que la variable de entorno LPDEST tenga asignado un valor, y no tienen en cuenta la opción de impresión -s. (Si LPDEST no tiene asignado ningún valor, es posible que la acción falle.)
ACTION Print { ARG_TYPE BTEDataFile TYPE MAP MAP_ACTION BTEPrintData }
ACTION BTEPrintData { WINDOW_TYPE NO_STDIO EXEC_STRING BTEPrint -d $LPDEST %Arg_1% }
He aquí otra versión de la acción BTEPrintData y una secuencia de comandos que la acompaña. Juntos manejan las situaciones en las que no se ha establecido el valor de LPDEST o se ha solicitado impresión silenciosa.
ACTION BTEPrintData { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/BTE/bin/BTEenvprint \ %(File)Arg_1% }
El contenido de la secuencia de comandos /usr/BTE/bin/BTEenvprint es:
# BTEenvprint #!/bin/sh DEST="" SILENT="" if [ $LPDEST ] ; then DEST="-d $LPDEST" fi BTEPrint $DEST SILENT $1
Cree la acción Open para los archivos *.tpl.
ACTION Open { ARG_TYPE BTETemplateFile TYPE MAP MAP_ACTION BTEditor }
Cree la acción Print para los archivos *.tpl.
ACTION Print { ARG_TYPES BTETemplateFile ç TYPE MAP MAP_ACTION NoPrint }
NoPrint es una acción incorporada que muestra un cuadro de diálogo que advierte al usuario que el archivo no puede imprimirse.
Ponga los archivos de ayuda en el paquete de registro.
Ponga los archivos de ayuda en las siguientes ubicaciones:
/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
Cree el archivo:
/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt.
Ponga en el archivo la siguiente definición de acción:
ACTION BTEHelp { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/dt/bin/dthelpview -helpVolume \ BTEHelp.sdl DESCRIPTION Abre el volumen de ayuda de BestTextEditor. }
Creación de iconos para la aplicación
Use el Editor de iconos para crear los iconos. La tabla Tabla 5-3 muestra las directrices de tamaño que se deben usar.
Tabla 5-3 Directrices para el tamaño de los iconos
Nombre |
Tamaño |
---|---|
nombre_base.t.pm |
16 por 16 |
nombre_base.m.pm |
32 por 32 |
nombre_base.l.pm |
48 por 48 |
Cree estos archivos de iconos en el directorio /desktop_approots/BTE/dt/appconfig/icons/C:
Iconos que representan la acción que ejecuta la aplicación: BTERun.t.pm, BTERun.m.pm, BTERun.l.pm
Iconos que representan los archivos *.bte: BTEData.t.pm, BTEData.m.pm,
Iconos que representan los archivos *.tpl: BTETempl.t.pm, BTETempl.m.pm
Iconos que representan el grupo de aplicaciones (utilizados en el Paso 7): BTEApp.t.pm, BTEApp.m.pm
Creación del grupo de aplicaciones.
Cree el directorio del grupo de aplicaciones, si aún no lo ha hecho.
/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor
Este paso es opcional. Proporciona un icono exclusivo para el grupo de aplicaciones mediante la creación de un tipo de datos y las acciones asociadas para el grupo de aplicaciones. Si se omite este paso, el grupo de aplicaciones utilizará el icono predeterminado.
Agregue estas definiciones de acciones y tipos de datos al archivo /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt. El tipo de datos especifica el icono que ha de usar el grupo de aplicaciones de BestTextEditor. Las acciones se comportan igual que las acciones Open y Print de los grupos de aplicación incorporados.
DATA_ATTRIBUTES BestTextEditorAppGroup { ACTIONS OpenInPlace,OpenNewView ICON BTEApp {
DATA_CRITERIA BestTextEditorAppGroupCriterial { DATA_ATTRIBUTES_NAME BestTextEditorAppGroup MODE d PATH_PATTERN */appmanager/*/BestTextEditor }
ACTION Open { ARG_TYPE BestTextEditorAppGroup TYPE MAP MAP_ACTION OpenAppGroup }
ACTION Print { ARG_TYPE BestTextEditorAppGroup TYPE MAP MAP_ACTION PrintAppGroup }
Cree un icono en el grupo de aplicaciones para iniciar la aplicación. Para ello, cree el archivo:
/desktop_approots/BTE/dt/appconfig/appmanager/C \ /BestTextEditor/BTEditor
y haga que el archivo sea ejecutable.
Cree en el grupo de aplicaciones el archivo de acción para abrir el volumen de ayuda. Para ello, cree el archivo:
/desktop_approots/BTE/dt/appconfig/appmanager/C \ /BestTextEditor/BTEHelp
y haga que el archivo sea ejecutable.
Coloque en el grupo de aplicaciones los demás archivos que deba contener; por ejemplo, archivos "'léame'", archivos de datos de ejemplo y archivos de plantillas.
Registre la aplicación.
En una ventana de emulador de terminal: