test

Solaris Common Desktop Environment: Handbok för avancerade användare och systemadministratörer

Kapitel 5 Registrera ett program

Det här kapitlet beskriver hur du skapar ett registreringspaket för ett program och hur du registrerar programmet.

När ett program är helt registrerat på skrivbordet har det:

Programregistrering är en icke inträngande åtgärd i programmet:

Du kan behöva skapa ett registreringspaket om du är:

Programregistrering: översikt

I det här avsnittet beskrivs följande:

Obs!  

Ett utförligt exempel som visar hur du registrerar ett befintligt program finns i Exempel på hur du kan skapa ett registreringspaket.

Funktioner som medföljer programregistrering

Programregistrering ger användarna möjligt att utföra följande i ett grafiskt gränssnitt:

Figur 5–1 Programgrupper på översta nivån i programhanteraren

Graphic

Figur 5–2 En programgrupp som innehåller en ikon som startar programmet

Graphic

Figur 5–3 En datafils snabbmeny med ”Öppna” och ”Skriv ut”

Graphic

Syftet med programregistrering

Ett registrerat skrivbordsprogram innehåller vissa konfigurationsfiler som används av skrivbordet för att visa programmets användargränssnitt:

För att dessa filer ska kännas igen och användas av skrivbordet måste de finnas i vissa kataloger som anges i skrivbordets sökvägar.

Det kan vara svårt att administrera ett program om dess konfigurationsfiler är utspridda i flera kataloger. Därför kan ett program lagra alla skrivbordskonfigurationsfiler i en och samma katalog. Denna filgruppering kallas för registreringspaket.

Om programmet är skrivbordsanpassat innehåller det ett registreringspaket som en del av installationspaketet. Om du är systemadministratör och skapar konfigurationsfilerna själv kan du skapa registreringspaketet själv.

Konfigurationsfilerna i registreringspaketet är inte tillgängliga på skrivbordet eftersom de inte finns i lämpliga sökvägskataloger. Processen att placera de här filerna på lämpliga platser kallas registrering eller integrering av programmet.

I skrivbordssystemet finns ett verktyg, dtappintegrate, som utför registreringen genom att skapa symboliskt länkade representationer av filerna i de korrekta sökvägskatalogerna.

Många skrivbordsanpassade program kör dtappintegrate automatiskt under installationen. Om du är systemadministratör och integrerar ett befintligt program kan du köra det själv när du har skapat registreringspaketet.

När ett program är registrerat på ett systems skrivbord är programmet tillgängligt för alla användare i systemet. Om systemet är konfigurerat som en skrivbordsprogramserver blir programmet också tillgängligt i andra system i nätverket.

Verktyget dtappintegrate har ett kommandoradsalternativ som upphäver processen genom att bryta länkarna. Detta gör det enkelt att ta bort programmet från programhanteraren så att det kan flyttas till en annan programserver eller uppdateras.

Generella steg för registrering av program

Obs!  

Ett utförligt exempel på hur du kan använda de här stegen för att skapa ett programpaket finns i Exempel på hur du kan skapa ett registreringspaket.

  1. Ändra alla programresurser som anger teckensnitt och färger. Annars kommer inte skrivbordets dynamiska teckensnitt och färger att fungera korrekt.

    Se Steg 1: Ändra teckensnitts- och färgresurser.

  2. Skapa en rotadress för programmet.

    Se Steg 2: Skapa skrivbordsprogrammets rot.

  3. Skapa katalogstrukturen under programroten.

    Se Steg 3: Skapa registreringspaketets kataloger registreringspaket.

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

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

  5. Placera hjälpfilerna i lämplig katalog.

    Se Steg 5: Placera hjälpfiler i registreringspaketet.

  6. Skapa ikonerna för programmet

    Se Steg 6: Skapa ikoner för programmet.

  7. Skapa programgruppen för programmen.

    Se Steg 7: Skapa programgruppen registrering.

  8. Registrera programmet med hjälp av dtappintegrate.

    Se Steg 8: Registrera programmet med hjälp av dtappintegrate.

Steg 1: Ändra teckensnitts- och färgresurser

Obs!  

Ett exempel på hur du ändrar resurser för ett program finns i Steg 1 i Exempel på hur du kan skapa ett registreringspaket.

Skrivbordet tillhandahåller mekanismer för att ange och ändra gränssnittsteckensnitt och fönsterfärger. För att ett program ska kunna använda de här mekanismerna korrekt kan du behöva ändra programmets app-defaults-fil.

Ändra teckensnittsresurser

Obs!  

Det här avsnittet gäller för program som är skapade med OSF/Motif 1.2™ (eller senare versioner). Inställningar kan inte ange gränssnittsteckensnitt för program som är skrivna med tidigare versioner av OSF/Motif.

Inställningar på skrivbordet anger gränssnittsteckensnitt för program som är skrivna med OSF/Motif 1.2 (eller senare versioner) om programmet inte anger programspecifika gränssnittsteckensnitt.

Inställningar tillhandahåller två teckensnitt:

systemteckensnitt – används i systemområden som etiketter, menyer och knappar

användarteckensnitt – används i redigerbara områden, t ex textfält

Varje teckensnitt finns i sju storlekar, med etiketten 1 t o m 7 i dialogrutan Teckensnitt. Teckensnitten i Inställningar är kopplade till faktiska teckensnitt i systemet via resurser för Inställningar som anges i /usr/dt/app-defaults/språk/Dtstyle.

Om du vill att programmet ska använda teckensnitten i Inställningar, bör du ta bort alla programresurser som anger teckensnitt för gränssnittet. Skrivbordet anger automatiskt korrekta programresurser:

FontList – ange som systemteckensnitt

XmText*FontList – ange som användarteckensnitt

XmTextField*FontList – ange som användarteckensnitt

Ändra färgresurser

Inställningar erbjuder möjlighet att ändra programfärger dynamiskt. Programmet måste vara en OSF/Motif 1.1- eller 1.2-klient. Klienter som skrivs med andra verktygslådor kan inte ändra färg dynamiskt. Färgändringarna träder i kraft när klienten startas om.

Det enklaste sättet att använda de dynamiska färger som tillhandahålls av skrivbordet är att ta bort alla programfärgresurser för bakgrunds- och förgrundsfärg.

Steg 2: Skapa skrivbordsprogrammets rot

Obs!  

Ett exempel på hur du kan skapa en rotkatalog för ett skrivbordsprogram finns i Steg 2 i Exempel på hur du kan skapa ett registreringspaket.

Registreringspaketets filer för programmet är grupperade under en katalog som kallas programrot eller prgm_rot. Katalogen prgm_rot som används för skrivbordskonfigurationsfilerna kan vara samma katalog som programmets prgm_rot-installationskatalog eller en annan katalog.

Anta till exempel att ett program är installerat i katalogen /usr/BTE. Samma katalog kan användas som prgm_rot för skrivbordskonfigurationsfilerna. Om du däremot integrerar ett befintligt program som inte är skrivbordsanpassat, skapar du en annan prgm_rot-katalog för skrivbordssystemet. Det här förhindrar att konfigurationsfilerna som du skapar blir överskrivna när du uppdaterar programmet.

En systemadministratör kan t ex vilja skapa en katalog som heter /etc/desktop_approots/BTE som skrivbordssystemets prgm_rot-katalog.

Steg 3: Skapa registreringspaketets kataloger registreringspaket

Obs!  

Ett exempel på hur du kan skapa registreringspaketkataloger för ett program finns i Steg 3 i Exempel på hur du kan skapa ett registreringspaket.

Registreringspaketet är den grupp med skrivbordskonfigurationsfiler som används av skrivbordet för att tillhandahålla ett grafiskt gränssnitt för programmet.

Registreringspaketet – innehåll

Skrivbordskonfigurationsfilerna innehåller:

Figur 5–4 Ett registreringspaket under en programrotskatalog

Graphic

Huvudkategorierna av konfigurationsfält under katalogen prgm_rot/dt/appconfig visas i Tabell 5–1.

Tabell 5–1 Konfigurationsfält – huvudkategorier

Underkatalog 

Innehåll 

types

Filer med åtgärds- och datatypsdefinitioner 

help

Skrivbordshjälpfiler 

icons

Bitmapp- och bildpunktsbeskrivningsfiler som används av programmets åtgärder och datatyper 

appmanager

Katalogen och innehållet som skapar programgruppen 

Var och en av huvudkategorierna har underkataloger för språkberoende filer. Standardspråksfiler placeras i katalogen C. Skapa registreringspaketet

Skapa de här katalogerna.

    Skapa de här katalogerna. Om du tillhandahåller språkberoende konfigurationsfiler skapar du en separat katalog för varje språk. Om du bara använder ett språk placerar du filerna i katalogen C.

Figur 5–5 Programgrupp på högsta nivån i programhanteraren

Graphic

Verktyget dtappintegrate fungerar bara för skrivbordskonfigurationsfilerna i katalogerna types, help, icons och appmanager. Programmets binära körbara app-defaults och meddelandekatalogfiler administreras separat.

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

Obs!  

Ett exempel på hur du kan skapa åtgärderna och datatyperna för ett program finns i Steg 4 i Exempel på hur du kan skapa ett registreringspaket.

Åtgärder och datatyper tillhandahåller ett användargränssnitt för programmet.

Nödvändiga åtgärder och datatyper för ett program

Ett typiskt program kan kräva följande åtgärds- och datatypsdefinitioner:

Adress för konfigurationsfiler för åtgärds- och datatypsdefinitioner

Åtgärder och datatyper definieras i konfigurationsfiler. Det enda namnkravet för filer som innehåller åtgärds- och datatypsdefinitioner är att de måste ha filnamnstillägget .dt. Du kanske vill att filen ska heta åtgärdsnamn.dt eller programnamn.dt.

Placera filer som innehåller åtgärder och datatyper under programroten i katalogen prgm_rot/dt/appconfig/types/språk. Standardalternativet för språk är C.

Figur 5–6 Filer med åtgärds- och datatypsdefinitioner

Graphic

Olika sätt att skapa åtgärder och datatyper

Du kan skapa åtgärds- och datatypsdefinitioner för ett program på två sätt:

Skapa åtgärder och datatyper med hjälp av Skapa åtgärd

Den här proceduren använder hjälpmedlet Skapa åtgärd för att skapa åtgärder och datatyper för programmet.

Mer information om Skapa åtgärd finns i direkthjälpen och i Kapitel 11.

  1. Öppna programgruppen Skrivbords_prog och dubbelklicka på Skapa åtgärd.

  2. Använd Skapa åtgärd för att skapa åtgärds- och datatypsdefinitioner för programmet och dess datatyp.

    Konfigurationsfilen som skapas av Skapa åtgärd sparas i Hemkatalog/.dt/type/åtgärdsnamn.dt. Åtgärdsfilen (den körbara filen med samma namn som åtgärden) placeras i din hemkatalog.

  3. Testa åtgärden med hjälp av åtgärdsfilen som har skapats i din hemkatalog.

  4. Kopiera åtgärdsdefinitionsfilen Hemkatalog/.dt/type/åtgärdsnamn.dt till katalogen prgm_rot/dt/appconfig/types/språk.

  5. När programgruppskatalogen har skapats (se Steg 7: Skapa programgruppen registrering), kopierar du åtgärdsfilen Hemkatalog/åtgärdsnamn till katalogen prgm_rot/dt/appconfig/appmanager/språk/programgruppsnamn.

Skapa åtgärder och datatyper manuellt

    Skapa en konfigurationsfil som innehåller åtgärds- och datatypsdefinitioner för programmet.

Åtgärds- och datatypsdefinitionsfilerna måste namnges enligt mönstret namn.dt.

Du kan placera alla åtgärds- och datatypsdefinitioner i en fil eller distribuera dem bland flera filer. För varje fil använder du ett filnamn som systemadministratörer enkelt kopplar till ditt program.

Åtgärds- och datatypsnamn måste bestå av ett ord (inga inbäddade blanksteg). Du kan använda ett understrykningstecken. Enligt konventionen är den första bokstaven i åtgärds- eller datatypsnamnet versal. Använd inte ett befintligt åtgärdsnamn eller filnamn. Använd ett namn som avancerade användare och systemadministratörer enkelt kopplar till ditt program.

Om du vill att programmets ikon ska ha ett annat namn än åtgärdsnamnet tar du med fältet LABEL i åtgärdsdefinitionen.

Mer information om hur du skapar åtgärder och datatyper finns i:

Steg 5: Placera hjälpfiler i registreringspaketet

Obs!  

Ett exempel på hur du kan lägga till hjälpfiler i ett registreringspaket finns i Steg 5 i Exempel på hur du kan skapa ett registreringspaket.

Om programmet innehåller en skrivbordshjälpvolym (en hjälpvolym som har skapats med Help Developer's Kit för skrivbordssystemet), ska huvudfilen för hjälpvolymen (*.sdl) placeras i katalogen prgm_rot/appconfig/help/språk.

Grafik som används av hjälpfilerna placeras vanligen i underkatalogen graphics. Grafiken måste finnas i samma katalog i förhållande till huvudhjälpvolymfilen (*.sdl) som när hjälpvolymen skapades.

Om programmet inte innehåller en hjälpvolym kan du skapa en sådan, om du har tillgång till hjälputvecklingssystemet.

Det finns två integrationsnivåer för en hjälpvolym:

Steg 6: Skapa ikoner för programmet

Obs!  

Ett exempel på hur du kan skapa ikonfiler för ett program finns i Steg 6 i Exempel på hur du kan skapa ett registreringspaket.

I skrivbordssystemet ingår standardikoner för åtgärder, datatyper och programgrupper. Troligen vill du emellertid skapa unika ikoner för programmet. Troligen vill du emellertid skapa unika ikoner för programmet.

Ikoner placeras i katalogen prgm_rot/dt/appconfig/icons/språk.

Nödvändiga ikoner för skrivbordet

Programmet använder de här ikonbilderna på skrivbordet:

Tabell 5–2 Namnkonventioner för ikonfiler

Storlek, Sidformat, Grad 

Bildpunktsmått 

Bitmappsnamn 

Pixmappsnamn 

mycket liten 

16 gånger 16 

grundnamn.t.bm

Storlek, Sidformat, Grad grundnamn.t.pm

medelstor 

32 gånger 32 

grundnamn.m.bm

grundnamn.m.pm

stor 

48 gånger 48 

grundnamn.l.bm

grundnamn.l.pm

Om du inte tillhandahåller bitmappsfiler anger skrivbordet färgspecifikationerna för bildpunktsbeskrivningsfilerna till svartvitt. Det är dock möjligt att den här tilldelningen inte ger det utseende du vill ha.

Mer information om ikoner finns i Ikonbildsfiler.

Steg 7: Skapa programgruppen registrering

Obs!  

Ett exempel på hur du skapar en programgrupp finns i Steg 7 i Exempel på hur du kan skapa ett registreringspaket.

När du har skapat åtgärds- och datatypsdefinitionerna för programmet måste du skapa konfigurationsfilerna som tillhandahåller det som visas för användaren, dvs programgruppen och dess innehåll.

Programgruppen är en katalog på högsta nivån i programhanteraren (se Figur 5–1).

Du skapar programgruppen i tre steg:

Skapa programgruppskatalogen

Om du vill skapa en programgrupp skapar du katalogerna i registreringspaketet under appmanager, enligt anvisningarna i Figur 5–7.

Figur 5–7 Katalogen appmanager

Graphic

Programgruppsnamn

programgrupper <Programgruppsnamn> i Figur 5–7 är namnet på programgruppen.

Figur 5–8 Programgruppsnamnet (<programgruppsnamn>)

Graphic

Namnet kan vara ett valfritt tillåtet fil- eller katalognamn. Använd ett namn som beskriver programmet.

Konfigurera programgruppen så att den använder en unik ikon

Skrivbordsystemet innehåller en standardikon för programgrupper. Troligen vill du emellertid skapa en anpassad ikon.

Om du vill använda en unik ikon för programgruppen måste du skapa:

Figur 5–9 Hur en programgrupp får en unik ikon

Graphic

Du bör också skapa en Öppna- och en Skriv ut-åtgärd för programgruppens datatyp: 

ACTION Open
 {
 	ARG_TYPE			Media_ToolsAppGroup
 	TYPE				MAP
 	MAP_ACTION		OpenAppGroup
 }
ACTION Print
 {
 	ARG_TYPE			Media_ToolsAppGroup
 	TYPE				MAP
 	MAP_ACTION		PrintAppGroup
 }

Åtgärderna OpenAppGroup och PrintAppGroup är inbyggda åtgärder som är definierade i /usr/dt/appconfig/types/språk/dtappman.dt.

Skapa innehållet i programgruppen

Det viktigaste elementet i programgruppen är den ikon som startar programmet (en åtgärdsikon). Om programgruppen innehåller en uppsättning program finns det vanligen en ikon för varje program.

Förutom en eller flera åtgärdsikoner kan programgruppen innehålla:

Skapa åtgärdsfilen (programikon)

Programgruppen bör innehålla en ikon som startar programmet. Om gruppen tillhandahåller en uppsättning program bör det finnas en ikon för varje program. Ikonerna kallas programikoner eller åtgärdsikoner, eftersom de representerar en underliggande åtgärd.

Du skapar en åtgärdsikon genom att skapa en körbar fil med samma namn som åtgärden den kommer att köra:

prgm_rot/dt/appconfig/appmanager/programgruppsnamn/åtgärdsnamn

Filen kallas en åtgärdsfil, eftersom den används för att skapa en visuell representation av den underliggande åtgärden.

Om du t ex har skapat en åtgärd som heter BraTextredigerare som kör programmet BraTextredigerare, skapar du en körbar fil som heter BraTextredigerare. I filhanteraren och programhanteraren använder åtgärdsfilen ikonbilden som anges i åtgärdsdefinitionen.

Figur 5–10 åskådliggör förhållandet mellan åtgärdsdefinitionen, åtgärdsfilen och den faktiska posten i programhanterarfönstret.

Figur 5–10 Programikonen är en fil i programgruppen

Graphic

Readme-filer

Till skrivbordet finns datatypen README som du använder till programmets README-filer. Använd en av följande namngivningskonventioner:

Skapa en särskild kontroll för huvudgruppen

För det mesta behöver du inte ange en kontrolldefinition för huvudgruppen. Användaren kan lägga till programmet i huvudgruppen genom att släppa åtgärdsikonen på installationsikonen på en panelundermeny.

Du kanske vill skapa en konfigurationsfil för Huvudgruppen som innehåller en kontrolldefinition för programmet om du vill att användare ska kunna installera en kontroll som fungerar annorlunda än åtgärdsikonen, om t ex kontrollen övervakar en fil och ändrar utseende när den övervakade filen ändras.

Huvudgruppens konfigurationsfiler placeras i katalogen prgm_rot/dt/appconfig/types/språk. Filerna måste använda namngivningskonventionen namn.fp.

Om du anger en konfigurationsfil med en kontroll, kan användaren lägga till kontrollen i en panelundermeny genom att släppa filen *.fp på installationsikonen på panelundermenyn.

Följande definition kan exempelvis placeras i en konfigurationsfil på huvudgruppen i programgruppen. Om användaren släpper den här filen på en installationsikon på en panelundermeny skapas en kontroll i panelundermenyn, som kör en upplaga av programmet BraTextredigerare. Om BraTextredigerare redan körs flyttas fönstret högst upp i fönsterstacken på den aktuella arbetsytan.

CONTROL BestTextEditorControl
 {
 	TYPE						icon
 	ICON						BTEFPanel	
 	PUSH_RECALL				True
 	CLIENT_NAME				BTEd
 	PUSH_ACTION				BTEditor
 	DROP_ACTION				BTEditor
 	HELP_STRING				Startar programmet BraTextredigerare.
 }

Mer information om hur du skapar konfigurationsfiler för huvudgruppen finns i:

Steg 8: Registrera programmet med hjälp av dtappintegrate

Obs!  

Ett exempel på hur du kan registrera ett program finns i Steg 8 i Exempel på hur du kan skapa ett registreringspaket.

När du har skapat ett registreringspaket under en programrot kan du utföra själva programregistreringen.

Vid programregistreringen skapas länkar mellan registreringspaketet och katalogerna i skrivbordssystemets sökvägar (se Hur dtappintegrate integrerar program).

Registrera ett program med dtappintegrate

Om programmet är skrivbordsanpassat körs vanligen dtappintegrate automatiskt som sista steg i installationsprocessen. Om det inte körs automatiskt, eller om du har skapat konfigurationsfiler för att integrera ett icke skrivbordsanpassat program, kan du köra dtappintegrate manuellt.

  1. Logga in som root.

  2. Kör kommandot:

    	/usr/dt/bin/dtappintegrate -s  prgm_rot

    där prgm_rot är skrivbordssystemets programrotskatalog. Mer information finns i direkthjälpen (man) till dtaction(1).

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

  4. Kontrollera att programmet är korrekt registrerat:

    1. Visa översta nivån i programhanteraren. Den nya programgruppen ska visas i programhanteraren.

    2. Öppna programgruppen och dubbelklicka på åtgärdsikonen.

Syntax och alternativ för dtappintegrate 

dtappintegrate -s prgm_rot [-t målsökväg ] [-l språk ] [-u]

-s prgm_rot

Nödvändig parameter som anger vilken programrot som programmet är installerat under. 

-t målsökväg

Valfri parameter. Som standard används placeringen /etc/dt/appconfig. Anger adressen dit skrivbordets konfigurationsfiler är länkade. Du måste använda en adress i programmets sökväg.

-l språk

Valfri parameter. Som standard används alla språk. Anger vilka språkberoende skrivbordskonfigurationsfiler som ska integreras. 

-u

Valfri parameter, avintegrerar programmet och tar bort alla länkar som skapades under integreringen. 

Hur dtappintegrate integrerar program

Funktionen hos dtappintegrate är att skapa länkar mellan de installerade filerna och de platser där skrivbordet letar efter konfigurationsfiler.

Åtgärder och datatyper

dtappintegrate skapar symboliska länkar från åtgärds- och datatypsdefinitionsfilerna i registreringspaketet till katalogen för hela systemet enligt åtgärdsdatabasens hjälpsökväg. Detta åstadkoms genom att länkar skapas från

prgm_rot/dt/appconfig/types/språk/*.dt

till

/etc/dt/appconfig/types/språk/*.dt

Hjälpinformationsfiler

dtappintegrate skapar symboliska länkar från hjälpfilerna i registreringspaketet till katalogen för hela systemet enligt åtgärdsdatabasens hjälpsökväg. Detta åstadkoms genom att länkar skapas från 

prgm_rot/dt/appconfig/help/språk/hjälpfil.sdl

till

/etc/dt/appconfig/help/språk/hjälpfil.sdl

Ikonfiler

dtappintegrate skapar symboliska länkar från ikonfilerna i registreringspaketet till katalogen för hela systemet enligt åtgärdsdatabasens hjälpsökväg. Detta åstadkoms genom att länkar skapas från

prgm_rot/dt/appconfig/icons/språk/ikonfiler

till

/etc/dt/appconfig/icons/språk/ikonfiler

Programgrupp

För att placera programgruppen för programmet på översta nivån i programhanteraren skapar dtappintegrate en länk mellan programgruppskatalogen i registreringspaketet och den systemtäckande adressen enligt programmets sökväg. Detta åstadkoms genom att länkar skapas från katalogen

prgm_rot/dt/appconfig/appmanager/språk/programgruppsnamn

till

/etc/dt/appconfig/appmanager/språk/programgruppsnamn

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:

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–3visar 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.