Exempel på hur du kan skapa ett registreringspaket

Följande steg skapar ett registreringspaket för ett befintligt, icke skrivbordsanpassat program som heter BraTextredigerare.

Information om "BraTextredigerare"

I exemplet görs följande antaganden om programmet BraTextredigerare:

• Det har installerats i katalogen /usr/BTE.

• Användarens sessionsspråk är standardspråket, C.

• Kommandoraden som startar BraTextredigerare är:

  	BTEd {filnamn]

  där filnamn är namnet på datafilen som ska öppnas i det nya fönstret. BraTextredigerare skapar ett eget fönster, d v s det körs inte i ett terminalemuleringsfönster.

• BraTextredigerare skapar och använder två typer av datafiler:

  • Dokumentationsfiler. Namnkonventionen *.bte används. BraTextredigerare tillhandahåller en kommandorad för utskrift av .bte-datafiler. Syntax för det här kommandot är:

    		BTEPrint [-d mål] [-s] filnamn
    

    där:

    -d mål - anger målskrivaren.

    -s - anger tyst utskrift. Programmets dialogruta för utskrift visas inte.

    filnamn - anger den fil som ska skrivas ut.

  • Mallfiler. Namnkonventionen *.tpl används. Mallfiler kan inte skrivas ut.

• De befintliga standardfilerna som inte är desktopprogram för BraTextredigerare innehåller resurser för gränssnittsteckensnitt samt förgrunds- och bakgrundsfärger.

• En hjälpvolym för BraTextredigerare skapades med skrivbordets Help Developer's Kit. När hjälpvolymen skapades användes följande källfiler:

  	.../BTEHelp.htg
   	.../graphics/BTE1.xwd
   	.../graphics/BTE2.xwd

  och skapade filen .../BTEHelp.sdl.

Steg för att registrera "BraTextredigerare"

Följande stegvisa procedur registrerar BraTextredigerare.

1. Ändra teckensnitt- och färgresurser.

   I BraTextredigerares app-defaults-fil tar du bort resurser som anger:

   • Teckensnitt för text

   • Färger för förgrund och bakgrund

2. Skapa programroten.

   Skapa katalogen:

   	/desktop_approots/BTE

   Om du integrerar ett befintligt program bör du skapa programrotskatalogen någon annanstans än på installationsplatsen för programmet. Annars kan konfigurationsfilerna som du skapar tas bort när du uppdaterar programmet.

3. Skapa registreringspaketets kataloger.

   Skapa följande kataloger:

   	/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/BraTextredigerare

4. Skapa åtgärderna och datatyperna för programmet.

   1. Skapa konfigurationsfilen för åtgärds- och datatypsdefinitionerna:

      		/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt

   2. Skapa åtgärdsdefinitionen för att köra BraTextredigerare:

      		ACTION BTEditor
       		{
       				WINDOW_TYPE				NO_STDIO
       				ICON						BTERun
       				DESCRIPTION				Dubbelklicka på ikonen eller släpp \
       											en BTE-datafil på den för att starta \
       											BraTextredigeraren.
       				EXEC_STRING				/usr/BTE/BTEd %Arg_1%
       		}

   3. Skapa datatypen för *.bte-filer:

      		DATA_ATTRIBUTES BTEDataFile
       		{
       				DESCRIPTION				Datafil för BraTextredigeraren.
       				ICON						BTEData
       				ACTIONS					Open,Print
       		}
      
       		DATA_CRITERIA BTEDataFileCriteria1
       		{
       				DATA_ATTRIBUTES_NAME			BTEDataFile
       				NAME_PATTERN						*.bte
       				MODE									f
       		}

   4. Skapa datatypen för *.tpl-filer:

      		DATA_ATTRIBUTES BTETemplateFile
       		{
       				DESCRIPTION			Mallfil för BraTextredigeraren.
       				ICON					BTETempl
       				ACTIONS				Open
       		}
      
       		DATA_CRITERIAL BTETemplateFileCriteria1
       		{
       				DATA_ATTRIBUTES_NAME			BTETemplateFile
       				NAME_PATTERN						*.tpl
       				MODE									f
       		}

   5. Skapa Öppna-åtgärden för *.bte-filer.

      		ACTION Open
       		{
       				ARG_TYPE			BTEDataFile
       				TYPE				MAP
       				MAP_ACTION		BTEditor
       		}

   6. Skapa SkrivUt-åtgärden för *.bte-filer.

      Här följer enkla SkrivUt-åtgärder som skriver ut datafiler. De här åtgärderna kräver ett värde för miljövariabeln LPDEST och ignorerar utskriftsalternativet -s. (Om LPDEST inte anges kan åtgärden misslyckas.)

      		ACTION Print
       		{
       				ARG_TYPE				BTEDataFile
       				TYPE					MAP
       				MAP_ACTION			BTEPrintData
       		}

      		ACTION BTEPrintData
       		{ 		WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				BTEPrint -d $LPDEST %Arg_1%
       		}

      Här följer en annan version av åtgärden BTEPrintData och ett medföljande skript. Tillsammans hanterar de situationer där LPDEST inte anges eller tyst utskrift begärs.

      		ACTION BTEPrintData
       		{
       				WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				/usr/BTE/bin/BTEenvprint \
       											%(File)Arg_1%
       		}

      Innehållet i kommandofilen /usr/BTE/bin/BTEenvprint är:

      		# BTEenvprint
       		#!/bin/sh
       		DEST=""
       		SILENT=""
       		if [ $LPDEST ] ; then
       			DEST="-d $LPDEST"
       		fi
       		BTEPrint $DEST SILENT $1

   7. Skapa Öppna-åtgärden för *.tpl-filer.

      		ACTION Open
       		{
       				ARG_TYPE			BTETemplateFile
       				TYPE				MAP
       				MAP_ACTION		BTEditor
       		}

   8. Skapa SkrivUt-åtgärden för *.tpl-filer.

      		ACTION Print
       		{
       				ARG_TYPES		BTETemplateFile
       				TYPE				MAP
       				MAP_ACTION		NoPrint
       		}

      NoPrint är en inbyggd åtgärd som visar en dialogruta där det står att filen inte går att skriva ut.

5. Placera hjälpfilerna i registreringspaketet.

   1. Placera hjälpfilerna på följande adresser:

      		/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. Skapa filen

      		/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt. 

      Placera följande åtgärdsdefinition i filen:

      		ACTION BTEHelp
       		{
       				WINDOW_TYPE				NO_STDIO
       				EXEC_STRING				/usr/dt/bin/dthelpview -helpVolume \
       											BTEHelp.sdl
       				DESCRIPTION				Öppnar hjälpen för BraTextredigerare.
       		}

6. Skapa ikoner för programmet.

   Använd Ikonredigeraren för att skapa ikonerna. Tabell 5-3 visar vilken storlek på rutnät som ska användas.

   Tabell 5-3 Rutnät för olika storlekar på ikoner

   Namn	Storlek
   Storlek, Sidformat, Grad grundnamn.t.pm	16 gånger 16
   grundnamn.m.pm	32 gånger 32
   grundnamn.l.pm	48 gånger 48

   Skapa de här ikonfilerna i katalogen /desktop_approots/BTE/dt/appconfig/icons/C:

   • Ikoner som representerar den åtgärd som kör programmet: BTERun.t.pm, BTERun.m.pm, BTERun.l.pm

   • Ikoner som representerar *.bte-filer: BTEData.t.pm, BTEData.m.pm,

   • Ikoner som representerar *.tpl-filer: BTETempl.t.pm, BTETempl.m.pm

   • Ikoner som representerar programgruppen (används i steg 7): BTEApp.t.pm, BTEApp.m.pm

7. Skapa programgruppen.

   1. Skapa katalogen om du inte redan har gjort det.

      	/desktop_approots/BTE/dt/appconfig/appmanager/C/BraTextredigerare

   2. Det här steget är valfritt. Det skapar en unik ikon för programgruppen genom att skapa en datatyp och associerade åtgärder för programgruppen. Om du utelämnar det här steget använder programgruppen standardikonen.

      Lägg till följande datatyps- och åtgärdsdefinitioner i filen /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt. Datatypen anger vilken ikon som ska användas av programgruppen BraTextredigerare. Åtgärderna ger samma Öppna- och SkrivUt-beteende som hos de inbyggda programgrupperna.

      		DATA_ATTRIBUTES BestTextEditorAppGroup
       		{
       				ACTIONS		OpenInPlace,OpenNewView
       				ICON			BTEApp
       		{

      		DATA_CRITERIA BestTextEditorAppGroupCriterial
       		{
       				DATA_ATTRIBUTES_NAME	BestTextEditorAppGroup
       				MODE							d
       				PATH_PATTERN				*/appmanager/*/BraTextredigerare
       		}

      		ACTION Open
       		{
       				ARG_TYPE				BestTextEditorAppGroup
       				TYPE					MAP
       				MAP_ACTION			OpenAppGroup
       		}

      		ACTION Print
       		{
       				ARG_TYPE				BestTextEditorAppGroup
       				TYPE					MAP
       				MAP_ACTION			PrintAppGroup
       		}

   3. Skapa en ikon i programgruppen som ska starta programmet. För att göra det skapar du filen:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
       		/BraTextredigerare/BTEditor

      och gör filen körbar.

   4. Skapa åtgärdsfilen i programgruppen som ska öppna hjälpvolymen. För att göra det skapar du filen:

      		/desktop_approots/BTE/dt/appconfig/appmanager/C \
       		/BraTextredigerare/BTEHelp

      och gör filen körbar.

   5. Placera andra filer i programgruppen, t ex "Readme"-filer, exempeldata och mallfiler.

8. Registrera programmet.

   I ett terminalemuleringsfönster:

   1. Logga in som root.

   2. Kör kommandot:

      		/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE

   3. Öppna programgruppen Skrivbordsverktyg och dubbelklicka på Ladda om åtgärder.