Solaris Common Desktop Environment: 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 MejorEditorDeTextos.

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

En el ejemplo se dan por supuestos los siguientes hechos acerca de la aplicación MejorEditorDeTextos:

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 MejorEditorDeTextos es:
```
	BTEd {nombre_archivo]
```
donde nombre_archivo es el nombre del archivo de datos que se debe abrir en la nueva ventana. MejorEditorDeTextos crea su propia ventana, es decir, no se ejecuta en una ventana de emulador de terminal.

MejorEditorDeTextos crea y utiliza archivos de datos de dos tipos:
- Archivos de documentación. Utilizan el convenio de nombrado *.bte. MejorEditorDeTextos 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 el convenio de nombrado *.tpl. Los archivos de plantilla no se pueden imprimir.

Los archivos app-defaults existentes de MejorEditorDeTextos, que no son de escritorio, contienen recursos para las fuentes de la interfaz y los colores de primer plano y fondo.

Se ha creado un volumen de ayuda en línea para MejorEditorDeTextos mediante el Kit de desarrollador de ayuda 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 el registro de "MejorEditorDeTextos"

Para registrar MejorEditorDeTextos se deberá seguir paso a paso el siguiente proceso:

Modifique los recursos de fuentes y colores.

En el archivo app-defaults de MejorEditorDeTextos, 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/MejorEditorDeTextos

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 MejorEditorDeTextos:

		ACTION BTEditor
 {
    WINDOW_TYPE			NO_STDIO
    ICON						BTERun
    DESCRIPTION			Haga doble clic en este icono o suelte \ 
                       en él un archivo de datos de BTE para ejecutar \ 
                       MejorEditorDeTextos.
    EXEC_STRING			/usr/BTE/BTEd %Arg_1%
 }

Cree el tipo de datos para los archivos *.bte:

		DATA_ATTRIBUTES BTEDataFile
 {
    DESCRIPTION			Archivo de datos de MejorEditorDeTextos.
    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 MejorEditorDeTextos.
    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.

Inclusión de 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 
    				MejorEditorDeTextos.
 }

Creación de iconos para la aplicación

Utilice el Editor de iconos para crear los iconos. Tabla 5–3 muestra las directrices de tamaño que deben utilizarse.
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/MejorEditorDeTextos
```
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 las siguientes 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 utilizar el grupo de aplicaciones de MejorEditorDeTextos. Las acciones se comportan de igual manera que las acciones Open y Print de los grupos de aplicaciones incorporados.
```
		DATA_ATTRIBUTES MejorEditorDeTextosAppGroup
 {
    ACTIONS		OpenInPlace,OpenNewView
    ICON			BTEApp
 {
```
```
		DATA_CRITERIA MejorEditorDeTextosrAppGroupCriterial
 {
    DATA_ATTRIBUTES_NAME	MejorEditorDeTextosAppGroup
    MODE							d
    PATH_PATTERN				*/appmanager/*/MejorEditorDeTextos
 }
```
```
		ACTION Open
 {
    ARG_TYPE			MejorEditorDeTextosAppGroup
    TYPE					MAP
    MAP_ACTION			OpenAppGroup
 }
```
```
		ACTION Print
 {
    ARG_TYPE			MejorEditorDeTextosrAppGroup
    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 \ 
				/MejorEditorDeTextos/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 \ 
				/MejorEditorDeTextos/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. Inicie la sesión 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