Manuale del CDE Solaris per utenti esperti e amministratori di sistema

Procedura generale per la registrazione di un'applicazione


Nota -

Per un esempio dettagliato della procedura da seguire per creare un pacchetto di registrazione, vedere "Esempio di creazione di un pacchetto di registrazione".


  1. Modificare tutte le risorse dell'applicazione che impostano i font e i colori. Diversamente, i font e i colori dinamici non funzioneranno correttamente.

    Vedere "Fase 1: Modifica delle risorse per font e colori".

  2. Creare una directory radice per l'applicazione.

    Vedere "Fase 2: Creazione della radice dell'applicazione".

  3. Creare la struttura delle directory sotto la radice dell'applicazione.

    Vedere "Fase 3: Creazione delle directory del pacchetto di registrazione".

  4. Creare le azioni e i tipi di dati.

    Vedere "Fase 4: Creazione delle azioni e dei tipi di dati per l'applicazione".

  5. Inserire i file della guida in una directory appropriata.

    Vedere "Fase 5: Inserimento dei file della guida nel pacchetto di registrazione".

  6. Creare le icone per l'applicazione.

    Vedere "Fase 6: Creazione delle icone per le applicazioni".

  7. Creare il gruppo per l'applicazione.

    Vedere "Fase 7: Creazione del gruppo di applicazioni".

  8. Registrare l'applicazione usando dtappintegrate.

    Vedere "Fase 8: Registrazione dell'applicazione con dtappintegrate".

Fase 1: Modifica delle risorse per font e colori


Nota -

Per un esempio della procedura da seguire per modificare le risorse di un'applicazione, vedere "Esempio di creazione di un pacchetto di registrazione".


Il desktop comprende una serie di meccanismi che consentono di impostare e modificare i font dell'interfaccia e i colori delle finestre. Perché l'applicazione utilizzi questi meccanismi correttamente, potrà essere necessario modificare il relativo file app-defaults.

Modifica delle risorse dei font


Nota -

Questa sezione si riferisce alle applicazioni create con OSF/Motif 1.2TM (o versioni successive). La Gestione degli stili non può impostare i font dell'interfaccia per le applicazioni scritte con versioni precedenti di OSF/Motif.


La Gestione degli stili del desktop imposterà automaticamente i font dell'interfaccia per le applicazioni create con OSF/Motif 1.2 (o versioni successive), salvo i casi in cui l'applicazione specifichi l'uso di font particolari.

La Gestione degli stili utilizza due font:

font di sistema: usato per le etichette, i menu, i pulsanti e altri elementi del sistema

font utente: usato per i campi di testo e altre aree modificabili

Ogni font dispone di sette dimensioni, numerate da 1 a 7 nella finestra di dialogo Font. I font della Gestione degli stili sono collegati ai font effettivi del sistema attraverso le risorse impostate in /usr/dt/app-defaults/lingua/Dtstyle.

Se si desidera che l'applicazione utilizzi i font della Gestione degli stili, eliminare le risorse dell'applicazione che specificano i font per l'interfaccia. Il desktop imposterà automaticamente le risorse dell'applicazione in modo appropriato:

FontList: verrà impostato sul font di sistema

XmText*FontList: verrà impostato sul font utente

XmTextField*FontList: verrà impostato sul font utente

Modifica delle risorse dei colori

La Gestione degli stili offre la possibilità di cambiare i colori delle applicazioni in modo dinamico. L'applicazione deve essere un client OSF/Motif 1.1 o 1.2. I client scritti con altri toolkit non supportano la modifica dinamica dei colori; le modifiche apportate devono essere applicate riavviando l'applicazione client.

Il modo più semplice per usare i colori dinamici forniti dal desktop consiste nell'eliminare tutte le risorse dell'applicazione relative ai colori di sfondo e di primo piano.

Fase 2: Creazione della radice dell'applicazione


Nota -

Per un esempio della procedura da seguire per creare la directory radice per un'applicazione del desktop, vedere "Esempio di creazione di un pacchetto di registrazione".


I file del pacchetto di registrazione vengono raggruppati sotto una directory detta "radice dell'applicazione", o radice_app. La directory radice_app usata per i file di configurazione del desktop può essere la stessa utilizzata per l'installazione dell'applicazione o una directory diversa.

Ad esempio, si supponga di avere installato un'applicazione sotto la directory /usr/NE. Questa stessa directory potrà essere utilizzata come radice_app anche per i file di configurazione del desktop. Tuttavia, nei casi in cui occorra integrare nel desktop un'applicazione esistente, si consiglia di creare una radice_app diversa. In questo modo si eviterà che i file di configurazione creati dall'amministratore vengano sovrascritti durante un aggiornamento dell'applicazione.

Ad esempio, si potrà creare come radice_app del desktop una directory di nome /etc/radici_app_desktop/NE.

Fase 3: Creazione delle directory del pacchetto di registrazione


Nota -

Per un esempio della procedura da seguire per creare le directory di un pacchetto di registrazione, vedere "Esempio di creazione di un pacchetto di registrazione".


Il pacchetto di registrazione è il gruppo di file di configurazione usato dal desktop per creare un'interfaccia grafica per l'applicazione.

Contenuto del pacchetto di registrazione

I file di configurazione del desktop includono:

Figura 5-4 Pacchetto di registrazione nella directory radice di un'applicazione

Graphic

Le categorie principali dei campi di configurazione che si trovano sotto la directory radice_app/dt/appconfig sono indicate nella Tabella 5-1.

Tabella 5-1 Principali categorie dei campi di configurazione

Sottodirectory 

Contenuto 

types

File di definizione delle azioni e dei tipi di dati 

help

File della guida 

icons

File grafici a mappa di pixel o a mappa di bit usati dalle azioni e dai tipi di dati dell'applicazione 

appmanager

La directory e i relativi elementi che creano il gruppo dell'applicazione 

Ognuna di queste categorie comprende directory secondarie per i file dipendenti dalla lingua. I file associati alla lingua predefinita si trovano nella directory C.

Creare il pacchetto di registrazione

    Creare le directory indicate. Se sono presenti file di configurazione dipendenti dalla lingua, creare una directory separata per ogni lingua. Se l'applicazione è in un'unica lingua, collocare i file nella directory C.

Figura 5-5 Gruppo di applicazioni al livello più elevato della Gestione di applicazioni

Graphic

Lo strumento dtappintegrate opera solo sui file di configurazione del desktop che si trovano nelle directory types, help, icons e appmanager. L'eseguibile dell'applicazione, app-defaults, e i file di catalogo dei messaggi vengono amministrati separatamente.

Fase 4: Creazione delle azioni e dei tipi di dati per l'applicazione


Nota -

Per un esempio dettagliato della procedura da seguire per creare le azioni e i tipi di dati per l'applicazione, vedere "Esempio di creazione di un pacchetto di registrazione".


Le azioni e i tipi di dati costituiscono l'interfaccia utente per l'applicazione.

Azioni e tipi di dati richiesti da un'applicazione

In genere, le applicazioni richiedono le seguenti azioni e tipi di dati:

Posizione dei file di configurazione che definiscono le azioni e i tipi di dati

Le azioni e i tipi di dati vengono definiti in speciali file di configurazione. L'unico requisito per la denominazione di questi file è il suffisso finale .dt. Per convenzione, i file vengono generalmente denominati come nome_azione.dt o nome_applicazione.dt.

Collocare i file che definiscono le azioni e i tipi di dati sotto la directory radice dell'applicazione, in radice_app/dt/appconfig/types/lingua. La lingua predefinita è C.

Figura 5-6 File di definizione per azioni e tipi di dati

Graphic

Metodi per creare le azioni e i tipi di dati

Le definizioni per le azioni e i tipi di dati di un'applicazione possono essere creati in uno dei modi seguenti:

Creare azioni e tipi di dati usando Crea azione

Questa procedura crea l'azione e i tipi di dati per un'applicazione con l'utility Crea azione.

Per maggiori informazioni su Crea azione, consultare la guida in linea o vedere il Capitolo 11.

  1. Aprire il gruppo Applicazioni_desktop e fare doppio clic su Crea azione.

  2. Usare Crea azione per definire l'azione e i tipi di dati dell'applicazione.

    Il file di configurazione creato da Crea azione verrà scritto in DirectoryIniziale/.dt/types/nome_azione.dt. Il file dell'azione (l'eseguibile con lo stesso nome dell'azione) viene collocato nella directory iniziale dell'utente.

  3. Provare l'azione usando il file creato nella directory iniziale.

  4. Copiare il file di definizione dell'azione DirectoryIniziale/.dt/types/nome_azione.dt nella directory radice_app/dt/appconfig/types/lingua.

  5. Dopo avere creato la directory per il gruppo dell'applicazione (vedere "Fase 7: Creazione del gruppo di applicazioni"), copiare il file dell'azione DirectoryIniziale/nome_azione nella directory radice_app/dt/appconfig/appmanager/lingua/gruppo_app.

Creare azioni e tipi di dati manualmente

    Creare un file di configurazione che contenga le definizioni per le azioni e i tipi di dati dell'applicazione.

I file con le definizioni per le azioni e i tipi di dati devono essere denominati secondo la convenzione nome.dt.

È possibile inserire tutte le definizioni per le azioni e i tipi di dati in un unico file oppure distribuirle su più file. Per ogni file, usare un nome che l'amministratore di sistema possa collegare facilmente all'applicazione.

I nomi delle azioni e dei tipi di dati devono essere formati da una sola parola (senza spazi vuoti). Sono ammessi i caratteri di sottolineatura. Per convenzione, la prima lettera del nome di un'azione o di un tipo di dati è maiuscola. Non usare nomi già esistenti. Usare nomi che l'amministratore di sistema o gli altri utenti possano collegare facilmente all'applicazione.

Se si desidera che l'icona dell'applicazione sia associata ad un nome diverso da quello dell'azione, includere nella definizione dell'azione un campo LABEL.

Per maggiori informazioni sulla creazione di azioni e tipi di dati, vedere:

Fase 5: Inserimento dei file della guida nel pacchetto di registrazione


Nota -

Per un esempio della procedura da seguire per aggiungere file della guida a un pacchetto di registrazione, vedere "Esempio di creazione di un pacchetto di registrazione".


Se l'applicazione comprende un volume della guida del desktop (cioè un volume creato con l'Help Developer's Kit del desktop), il file fondamentale del volume della guida (*.sdl) dovrà essere collocato nella directory radice_app/appconfig/help/lingua.

I file grafici usati dai file della guida vengono solitamente collocati nella directory secondaria graphics. I grafici devono mantenere la stessa posizione rispetto al file principale del volume della guida (*.sdl) in cui si trovavano quando è stato creato il volume.

Se l'applicazione non comprende un volume di guida, l'Help Developer's Kit permette di crearne uno.

Per un volume della guida sono possibili due livelli di integrazione:

Fase 6: Creazione delle icone per le applicazioni


Nota -

Per un esempio delle procedure da seguire per creare i file delle icone per l'applicazione, vedere "Esempio di creazione di un pacchetto di registrazione".


Il desktop comprende icone predefinite per le azioni, i tipi di dati e i gruppi di applicazioni. Tuttavia, ogni utente potrà creare nuove icone per le proprie applicazioni.

Le icone vengono collocate nella directory radice_app/dt/appconfig/icons/lingua.

Icone richieste per il desktop

All'interno del desktop, l'applicazione utilizza le seguenti icone:

Tabella 5-2 Convenzioni di denominazione per le icone

Dimensione 

Dimensioni in pixel 

Nome del file a mappa di bit 

Nome del file a mappa di pixel 

piccola 

16 x 16 

nomebase.t.bm

nomebase.t.pm

media 

32 x 32 

nomebase.m.bm

nomebase.m.pm

grande 

48 x 48 

nomebase.l.bm

nomebase.l.pm

Se non viene specificato alcun file a mappa di bit, il desktop riassegnerà i colori della versione a mappa di pixel convertendoli in bianco e nero. Si noti tuttavia che questa operazione potrebbe non produrre l'effetto desiderato.

Per maggiori informazioni sulle icone, vedere "File grafici delle icone".

Fase 7: Creazione del gruppo di applicazioni


Nota -

Per un esempio della procedura da seguire per creare un gruppo di applicazioni, vedere "Esempio di creazione di un pacchetto di registrazione".


Una volta create le definizioni per le azioni e i tipi di dati dell'applicazione, occorre creare i file di configurazione per gli elementi che l'utente vedrà effettivamente: il gruppo dell'applicazione e il suo contenuto.

Il gruppo dell'applicazione è una directory che compare al livello più elevato della Gestione di applicazioni (vedere la Figura 5-1).

La creazione di un gruppo per un'applicazione richiede tre operazioni:

Creazione della directory per il gruppo di applicazioni

Per creare un gruppo per un'applicazione, creare le directory richieste nel pacchetto di registrazione sotto appmanager, come mostrato nella Figura 5-7.

Figura 5-7 La directory appmanager

Graphic

Nome del gruppo

Nella Figura 5-7, <gruppo_app> è il nome del gruppo dell'applicazione.

Figura 5-8 Nome del gruppo dell'applicazione (<gruppo_app>)

Graphic

Il nome può contenere tutti i caratteri ammessi per i nomi dei file (e delle directory). Si consiglia di usare un nome che descriva l'applicazione.

Configurazione del gruppo di applicazioni per l'uso di un'icona propria

Il desktop comprende un'icona predefinita per i gruppi di applicazioni. Tuttavia, ogni utente potrà creare icone personalizzate per i propri gruppi.

Per associare un gruppo a un'icona personalizzata, occorrerà creare:

Figura 5-9 Come assegnare un'icona a un gruppo di applicazioni

Si dovrà inoltre creare un'azione Apri e un'azione Stampa per il tipo di dati del gruppo dell'applicazione:

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

Le azioni OpenAppGroup e PrintAppGroup sono azioni standard predefinite in /usr/dt/appconfig/types/lingua/dtappman.dt.

Creazione del contenuto del gruppo di applicazioni

L'elemento più importante di un gruppo è l'icona per l'avvio dell'applicazione (icone dell'azione). Se il gruppo contiene più applicazioni, occorrerà predisporre un'icona per ognuna.

Oltre all'icona dell'azione, il gruppo potrà contenere:

Creazione del file dell'azione (icona dell'applicazione)

Il gruppo di un'applicazione deve contenere un'icona per l'avvio dell'applicazione. Se il gruppo contiene più applicazioni, sarà necessaria un'icona per ognuna. Questa icona viene detta icona dell'applicazione, o icona dell'azione, poiché rappresenta l'azione alla base dell'applicazione.

Per creare l'icona di un'azione occorre creare un file eseguibile con lo stesso nome dell'azione che dovrà essere eseguita:

radice_app/dt/appconfig/appmanager/gruppo_app/nome_azione

Il file così creato viene detto file dell'azione, poiché ha lo scopo di creare una rappresentazione visiva dell'azione sottostante.

Ad esempio, se è stata creata un'azione di nome NuovoEditor che avvia l'applicazione NuovoEditor, si dovrà creare un file eseguibile di nome NuovoEditor. Nella Gestione di file e nella Gestione di applicazioni, il file dell'azione userà l'icona specificata nella definizione dell'azione.

La Figura 5-10 illustra la relazione che esiste tra la definizione dell'azione, il file dell'azione e ciò che compare effettivamente nella finestra della Gestione di applicazioni.

Figura 5-10 L'icona dell'applicazione è un file del gruppo dell'applicazione

Graphic

File README

Il desktop comprende un tipo di dati README utilizzabile per i file README dell'applicazione. Sono ammesse le seguenti denominazioni:

Creazione di un controllo specifico per il Pannello principale

Nella maggior parte dei casi non sarà necessario definire un controllo per il Pannello principale; l'utente potrà aggiungere l'applicazione al Pannello principale semplicemente rilasciando l'icona dell'azione sul controllo.

Tuttavia, si potrà creare un file di configurazione speciale per il Pannello principale per consentire agli utenti di installare un controllo che si comporti diversamente dall'icona dell'azione, ad esempio, un controllo che effettui un monitoraggio su un file e cambi aspetto in base allo stato di quel file.

I file di configurazione del Pannello principale si trovano nella directory radice_app/dt/appconfig/types/lingua, e per convenzione vengono denominati nella forma nome.fp.

Se si crea un file di configurazione contenente un controllo, l'utente potrà aggiungere quel controllo a un pannello secondario rilasciando il file *.fp sul controllo "Installazione icona" appropriato.

La definizione mostrata nell'esempio seguente può essere collocata in un file di configurazione del Pannello principale nel gruppo dell'applicazione. Rilasciando questo file sul controllo "Installazione icona" di un pannello secondario, verrà creato un controllo per l'avvio di una singola copia dell'applicazione NuovoEditor. Se NuovoEditor fosse già in esecuzione, la finestra verrebbe spostata in primo piano nello spazio di lavoro corrente.

CONTROL ControlloNuovoEditor
 {
 	TYPE						icon
 	ICON						NEFPanel	
 	PUSH_RECALL				True
 	CLIENT_NAME				NEd
 	PUSH_ACTION				NEditor
 	DROP_ACTION				NEditor
 	HELP_STRING				Avvia l'applicazione NuovoEditor.
 }

Per maggiori informazioni su come creare i file di configurazione per il Pannello principale, vedere:

Fase 8: Registrazione dell'applicazione con dtappintegrate


Nota -

Per un esempio della procedura da seguire per registrare un'applicazione, vedere il punto 8 di "Esempio di creazione di un pacchetto di registrazione".


Una volta creato un pacchetto di registrazione sotto la directory radice dell'applicazione, si potrà procedere con la registrazione vera e propria dell'applicazione.

La registrazione dell'applicazione crea una serie di collegamenti tra il pacchetto di registrazione e le directory incluse nei percorsi di ricerca del desktop (vedere "Effetti dell'integrazione delle applicazioni con dtappintegrate").

Registrare un'applicazione con dtappintegrate

Se l'applicazione è predisposta per il desktop, dtappintegrate viene in genere eseguito automaticamente alla fine del processo di installazione. Se ciò non avviene, o se sono stati creati nuovi file di configurazione per integrare un'applicazione non predisposta per il desktop, occorrerà avviare dtappintegrate manualmente.

  1. Effettuare il login come superutente.

  2. Eseguire il comando:

    	/usr/dt/bin/dtappintegrate -s  radice_app
    

    dove radice_app è la directory radice dell'applicazione del desktop. Per maggiori informazioni, vedere la pagina man relativa a dtappintegrate(1).

  3. Aprire il gruppo di applicazioni Strumenti_desktop e fare doppio clic su "Ricarica applicazioni".

  4. Verificare che l'applicazione sia registrata correttamente:

    1. Visualizzare il livello più elevato della Gestione di applicazioni e verificare che compaia il nuovo gruppo dell'applicazione.

    2. Aprire il gruppo dell'applicazione e fare doppio clic sull'icona dell'azione.

Sintassi e opzioni di dtappintegrate

dtappintegrate -s radice_app [-t destinazione ] [-l lingua ] [-u]

-s radice_app

Parametro necessario. Specifica la directory radice sotto la quale è stata installata l'applicazione. 

-t destinazione

Parametro opzionale, il cui valore predefinito è /etc/dt/appconfig. Specifica la directory a cui puntano i collegamenti dei file di configurazione del desktop. La directory specificata deve essere inclusa nel percorso di ricerca delle applicazioni.

-l lingua

Parametro opzionale, il cui valore predefinito sono tutte le lingue. Specifica i file di configurazione dipendenti dalla lingua da integrare. 

-u

Parametro opzionale. Annulla l'integrazione dell'applicazione, eliminando tutti i collegamenti creati nel processo di integrazione. 

Effetti dell'integrazione delle applicazioni con dtappintegrate

La funzione di dtappintegrate è quella di creare collegamenti tra i file installati e le directory in cui il desktop cercherà i file di configurazione.

Azioni e tipi di dati

dtappintegrate crea una serie di collegamenti simbolici tra i file delle azioni e dei tipi di dati che si trovano nel pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca del database delle azioni. I collegamenti vengono creati tra

radice_app/dt/appconfig/types/lingua/*.dt

e

/etc/dt/appconfig/types/lingua/*.dt

File della guida

dtappintegrate crea collegamenti simbolici tra i file della guida del pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca della guida. I collegamenti vengono creati tra

radice_app/dt/appconfig/help/lingua/file_guida.sdl

e

/etc/dt/appconfig/help/lingua/file_guida.sdl

File delle icone

dtappintegrate crea collegamenti simbolici tra i file delle icone che si trovano nel pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca delle icone. I collegamenti vengono creati tra

radice_app/dt/appconfig/icons/lingua/file_icone

e

/etc/dt/appconfig/icons/lingua/file_icone 

Gruppo dell'applicazione

Per collocare il gruppo dell'applicazione al livello più elevato della Gestione di applicazioni, dtappintegrate crea un collegamento tra la directory del gruppo nel pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca delle applicazioni. Il collegamento viene creato tra la directory

radice_app/dt/appconfig/appmanager/lingua/nome_gruppo

e

/etc/dt/appconfig/appmanager/lingua/nome_gruppo