Solaris CDE: Guía avanzada del usuario y del administrador del sistema

Ejemplo de creación de un paquete de registro

Mediante los siguientes pasos se crea un paquete de registro para una aplicación existente no preparada para el escritorio, llamada BestTextEditor.

Información sobre ``BestTextEditor'' que necesita conocer

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.

Pasos para registrar 'BestTextEditor'

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.
1. Cree el directorio del grupo de aplicaciones, si aún no lo ha hecho.
```
	/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor
```
2. 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 
 }
```
3. 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.
4. 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.
5. 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:
1. Entre en el sistema como usuario root.
2. Ejecute el comando:
```
		/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE
```
3. Abra el grupo de aplicaciones Herramientas_Escritorio y haga doble clic en Recargar aplicaciones

Nombre	Tamaño
`nombre_base.t.pm`	16 por 16
`nombre_base.m.pm`	32 por 32
`nombre_base.l.pm`	48 por 48