L'esempio seguente crea un pacchetto di registrazione per un'applicazione esistente e non predisposta per il desktop di nome NuovoEditor.
Nell'esempio si presume quanto segue:
NuovoEditor è installato nella directory /usr/NE.
La lingua delle sessioni utente è quella predefinita, cioè C.
Il comando da eseguire per avviare NuovoEditor è:
NEd {nomefile]
dove nomefile è il nome del file di dati da aprire nella nuova finestra. NuovoEditor crea una finestra propria, non viene cioè eseguito in una finestra di emulazione di terminale.
NuovoEditor crea e utilizza due tipi di file di dati:
File di documentazione, identificati dal suffisso .ned. NuovoEditor dispone di un comando per la stampa dei file di dati .ned. La sintassi del comando è:
StampaNE [-d destinazione] [-s] nomefile
dove:
-d destinazione: specifica la stampante di destinazione.
-s: specifica l'esecuzione della stampa senza la visualizzazione di una finestra di dialogo.
nomefile: specifica il file da stampare.
File di modello, identificati dal suffisso *.tpl. I file di modello non possono essere stampati.
I file app-defaults di NuovoEditor esistenti e non predisposti per il desktop contengono risorse per i font dell'interfaccia e per i colori di primo piano e di sfondo.
È stato creato un volume della guida in linea per NuovoEditor usando l'Help Developer's Kit. Nella creazione del volume della guida sono stati usati i seguenti file:
…/GuidaNE.htg …/graphics/NE1.xwd …/graphics/NE2.xwd
per generare …/GuidaNE.sdl.
La procedura seguente si riferisce alla registrazione di NuovoEditor.
Modificare le risorse per i font e i colori.
Nel file app-defaults di NuovoEditor, cancellare le risorse che definiscono:
I font per il testo
I colori di primo piano e di sfondo
Creare la directory radice per l'applicazione.
Creare la directory:
/radici_app_desktop/NE
Se si tratta di integrare un'applicazione esistente, è opportuno creare la radice dell'applicazione in una posizione diversa da quella usata per l'installazione; diversamente, i file di configurazione creati verranno sovrascritti al primo aggiornamento dell'applicazione.
Creare le directory per il pacchetto di registrazione.
Creare queste directory:
/radici_app_desktop/NE/dt/appconfig/types/C /radici_app_desktop/NE/dt/appconfig/help/C /radici_app_desktop/NE/dt/appconfig/icons/C /radici_app_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor
Creare le azioni e i tipi di dati per l'applicazione.
Creare il file di configurazione con le definizioni delle azioni e dei tipi di dati:
/radici_app_desktop/NE/dt/appconfig/types/C/NE.dt
Creare la definizione dell'azione per l'avvio di NuovoEditor:
ACTION NEditor { WINDOW_TYPE NO_STDIO ICON EseguiNE DESCRIPTION Per avviare NuovoEditor, fare \ doppio clic su un file di dati NE \ o trascinarne l'icona su NuovoEditor. EXEC_STRING /usr/NE/NEd %Arg_1% }
Creare il tipo di dati per i file *.ned:
DATA_ATTRIBUTES FileDatiNE { DESCRIPTION File di dati di NuovoEditor. ICON DatiNE ACTIONS Open,Print } DATA_CRITERIA CriteriFileDatiNE1 { DATA_ATTRIBUTES_NAME FileDatiNE NAME_PATTERN *.bte MODE f }
Creare il tipo di dati per i file *.tpl:
DATA_ATTRIBUTES FileModelloNE { DESCRIPTION File di modello di NuovoEditor. ICON ModNE ACTIONS Open } DATA_CRITERIAL CriteriFileModelloNE1 { DATA_ATTRIBUTES_NAME FileModelloNE NAME_PATTERN *.tpl MODE f }
Creare l'azione Apri per i file *.ned.
ACTION Open { ARG_TYPE FileDatiNE TYPE MAP MAP_ACTION NEditor }
Creare l'azione Stampa per i file *.ned.
Qui di seguito sono riportate alcune semplici azioni Stampa per la stampa dei file di dati. Queste azioni richiedono un valore per la variabile d'ambiente LPDEST ed ignorano l'opzione di stampa -s. (Se la variabile LPDEST non viene impostata, l'azione non verrà eseguita.)
ACTION Print { ARG_TYPE FileDatiNE TYPE MAP MAP_ACTION StampaDatiNE }
ACTION StampaDatiNE { WINDOW_TYPE NO_STDIO EXEC_STRING StampaNE -d $LPDEST %Arg_1% }
Gli esempi seguenti presentano un'altra versione dell'azione StampaDatiNE e uno script associato a questa azione. Insieme, questi due elementi possono gestire le situazioni in cui la variabile LPDEST non è impostata o in cui è richiesta l'esecuzione silente della stampa.
ACTION StampaDatiNE { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/NE/bin/stampaNE \ %(File)Arg_1% }
Il contenuto dello script /usr/NE/bin/stampaNE è il seguente:
# stampaNE #!/bin/sh DEST=”” SILENT=”” if [ $LPDEST ] ; then DEST=”-d $LPDEST” fi stampaNE $DEST SILENT $1
Creare l'azione Apri per i file *.tpl:
ACTION Open { ARG_TYPE FileModelloNE TYPE MAP MAP_ACTION NEditor }
Creare l'azione Stampa per i file *.tpl:
ACTION Print { ARG_TYPES FileModelloNE TYPE MAP MAP_ACTION NoPrint }
NoPrint è un'azione predefinita che visualizza una finestra di dialogo indicante che il file specificato dall'utente non può essere stampato.
Collocare i file della guida nel pacchetto di registrazione.
Collocare i file della guida nelle seguenti directory:
/radici_app_desktop/NE/dt/appconfig/help/C/GuidaNE.sdl /radici_app_desktop/BTE/dt/appconfig/help/C/graphics/NE1.xwd /radici_app_desktop/BTE/dt/appconfig/help/C/graphics/NE2.xwd
Creare il file:
/radiciapp_desktop/NE/dt/appconfig/types/C/GuidaNE.dt.
Inserire nel file la seguente definizione per l'azione:
ACTION GuidaNE { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/dt/bin/dthelpview -helpVolume \ GuidaNE.sdl DESCRIPTION Apre il volume della guida di NuovoEditor. }
Creare le icone per l'applicazione.
Creare le icone desiderate usando l'Editor delle icone. La Tabella 5–3 riporta i criteri da usare per le dimensioni.
Tabella 5–3 Dimensioni delle icone
Nome |
Dimensione |
---|---|
nomebase.t.pm |
16 x 16 |
nomebase.m.pm |
32 x 32 |
nomebase.l.pm |
48 x 48 |
Creare i file sotto elencati nella directory /radiciapp_desktop/NE/dt/appconfig/icons/C:
Icone per rappresentare l'azione che avvia l'applicazione: EseguiNE.t.pm, EseguiNE.m.pm, EseguiNE.l.pm
Icone per rappresentare i file *.ned: DatiNE.t.pm, DatiNE.m.pm,
Icone per rappresentare i file *.tpl: ModNE.t.pm, ModNE.m.pm
Icone per rappresentare il gruppo dell'applicazione (usate nella fase 7): AppNE.t.pm, AppNE.m.pm
Creare il gruppo dell'applicazione.
Creare la directory.
/radici_app_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor
Questa fase è opzionale. Il suo scopo è quello di creare un'icona specifica per il gruppo dell'applicazione creando un tipo di dati e le relative azioni per il gruppo dell'applicazione. Omettendo questa operazione, il gruppo dell'applicazione userà l'icona predefinita.
Aggiungere le seguenti definizioni al file /radici_app_desktop/NE/dt/appconfig/types/C/NEd.dt. La definizione del tipo di dati specifica l'icona da utilizzare per il gruppo dell'applicazione NuovoEditor. Le definizioni delle azioni specificano lo stesso comportamento delle azioni Apri e Stampa dei gruppi di applicazioni predefiniti.
DATA_ATTRIBUTES GruppoAppNuovoEditor { ACTIONS OpenInPlace,OpenNewView ICON AppNE {
DATA_CRITERIA CriteriGruppoAppNuovoEditorl { DATA_ATTRIBUTES_NAME GruppoAppNuovoEditor MODE d PATH_PATTERN */appmanager/*/NuovoEditor }
ACTION Open { ARG_TYPE GruppoAppNuovoEditor TYPE MAP MAP_ACTION OpenAppGroup }
ACTION Print { ARG_TYPE GruppoAppNuovoEditor TYPE MAP MAP_ACTION PrintAppGroup }
Creare un'icona da inserire nel gruppo per l'avvio dell'applicazione. Creare il file:
/radici_app_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor/NEditor
e renderlo eseguibile.
Creare nel gruppo dell'applicazione il file dell'azione per l'apertura del volume della guida. Creare il file:
/radici_app_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor/GuidaNE
e renderlo eseguibile.
Se necessario, inserire altri tipi di file nel gruppo dell'applicazione; ad esempio, file “readme”, esempi di file di dati e modelli.
Registrare l'applicazione.
Da una finestra di emulazione di terminale: