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:

Pasos para el registro de "MejorEditorDeTextos"

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

  1. 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

  2. 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.

  3. 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
  4. Cree las acciones y tipos de datos de la aplicación.

    1. 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
    2. 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%
       }
    3. 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
       }
    4. 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
       }
    5. Cree la acción Open para los archivos *.bte.

      		ACTION Open
       {
          ARG_TYPE			BTEDataFile
          TYPE				   MAP
          MAP_ACTION		   BTEditor
       }
    6. 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
    7. Cree la acción Open para los archivos *.tpl.

      		ACTION Open
       {
         ARG_TYPE			BTETemplateFile
         TYPE				MAP
         MAP_ACTION		BTEditor
       }
    8. 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.

  5. Inclusión de los archivos de ayuda en el paquete de registro.

    1. 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
    2. 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.
       }
  6. 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

  7. 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.

  8. 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.