In questo capitolo viene descritto come creare un pacchetto di registrazione per un'applicazione e come registrare l'applicazione nel desktop. Quando un'applicazione è regolarmente registrata nel desktop, essa presenta le seguenti caratteristiche: Dispone di un proprio gruppo separato al livello più elevato della Gestione di applicazioni Dispone di un'azione per l'avvio dell'applicazione, rappresentata da un'icona all'interno del gruppo Opzionalmente, dispone di tipi di dati associati specificamente ai suoi file La registrazione è un'operazione “non-invasiva” per l'applicazione: Non richiede la modifica del file eseguibile. Questo significa che è possibile registrare anche applicazioni già esistenti su un sistema. Non richiede lo spostamento dei file propri dell'applicazione (come l'eseguibile e app-defaults) in posizioni differenti. Può essere eseguita facilmente. Il tool usato per registrare le applicazioni, dtappintegrate, prevede un'opzione per annullare gli effetti della procedura e ripristinare la situazione originaria. La creazione di un pacchetto di registrazione può essere utile nei seguenti casi: Per gli amministratori di sistema che desiderino registrare un'applicazione esistente nel desktop. Per i programmatori di software che desiderino creare un pacchetto di installazione per un'applicazione predisposta per il desktop. Questa sezione descrive: Lo scopo della registrazione delle applicazioni Le caratteristiche che la registrazione apporta alle applicazioni Per un esempio dettagliato della procedura di registrazione di un'applicazione, vedere . Gestione di applicazioniuso per l'integrazione delle applicazioniLa registrazione offre agli utenti un'interfaccia grafica per: Localizzare l'applicazione. Al momento dell'installazione, l'applicazione viene “registrata” nella Gestione di applicazioni e le viene assegnato un gruppo.

Avviare l'applicazione. Il gruppo contiene un'icona che consente, con un doppio clic, di avviare l'applicazione.

applicazioniassociazioni con i tipi di datitipi di datiscopiIdentificare ed editare i file di dati. I file di dati dell'applicazione appariranno con una propria icona nella Gestione di file. Le icone dei file di dati potranno essere usate per: Avviare (Aprire) l'applicazione Stampare i file di dati

Eseguire altre operazioni, ad esempio comprimere, visualizzare o inviare i dati via posta elettronica file di configurazionenel pacchetto di registrazioneUn'applicazione registrata nel desktop possiede determinati file di configurazione che vengono usati per creare la sua interfaccia utente: File di definizione dell'azione e del tipo di dati File contenenti le immagini per le icone (a mappa di pixel o a mappa di bit) Una directory e una serie di file che creano il gruppo dell'applicazione Opzionalmente, i file di aiuto del desktop e i file di definizione per il Pannello principale Per poter essere riconosciuti e utilizzati dal desktop, questi file devono trovarsi in particolari directory specificate nei percorsi di ricerca. Può essere difficile amministrare un'applicazione quando i suoi file di configurazione sono distribuiti in diverse directory. Per questa ragione, il desktop permette di tenere raggruppati tutti i file di configurazione di un'applicazione in una singola directory. Questo insieme di file viene detto pacchetto di registrazionedefinizione pacchetto di registrazione. Se l'applicazione è predisposta per il desktop, essa crea automaticamente un pacchetto di registrazione durante il processo di installazione. Se invece i file di configurazione vengono creati dall'amministratore di sistema, il pacchetto di registrazione dovrà essere creato manualmente. I file di configurazione del pacchetto di registrazione non sono disponibili nel desktop perché non si trovano nelle directory dei percorsi di ricerca. Il processo che colloca questi file nelle posizioni appropriate viene detto registrazionedefinizione registrazione, o integrazione, dell'applicazione. Il desktop comprende un tool, di nome dtappintegrate, che esegue la registrazione creando rappresentazioni dei file collegate simbolicamente alle directory appropriate dei percorsi di ricerca. Molte applicazioni predisposte per il desktop eseguono automaticamente dtappintegrate durante il processo di installazione. Nei casi in cui occorra integrare un'applicazione già esistente, il processo dovrà essere avviato manualmente dall'amministratore del sistema dopo la creazione del pacchetto di registrazione. Quando un'applicazione è registrata nel desktop di un sistema, essa è disponibile a tutti gli utenti di quel sistema. Se il sistema è configurato come server di applicazioniserver di applicazionidisponibilità delle applicazioni, essa sarà disponibile anche agli altri sistemi della rete. Il tool dtappintegrate comprende un'opzione che permette di annullare il processo di registrazione mediante la disabilitazione dei collegamenti. Questo offre la possibilità di eliminare facilmente l'applicazione dalla Gestione di applicazioni per spostarla su un altro server o per eseguire un aggiornamento. Per un esempio dettagliato della procedura da seguire per creare un pacchetto di registrazione, vedere . Modificare tutte le risorse dell'applicazione che impostano i font e i colori. Diversamente, i font e i colori dinamici non funzioneranno correttamente. Vedere . Creare una radice per l'applicazione. Vedere . Creare la struttura delle directory sotto la radice dell'applicazione. Vedere . Creare le azioni e i tipi di dati per l'applicazione. Vedere . Inserire i file di aiuto in una directory appropriata. Vedere . Collocare i file della documentazione online (biblioteche delle informazioni o BiblioInfo) nella directory appropriata. Vedere . Creare le icone per l'applicazione. Vedere . Creare il gruppo per l'applicazione. Vedere . Registrare l'applicazione usando dtappintegrate. Vedere . Per un esempio della procedura da seguire per modificare le risorse di un'applicazione, vedere il della sezione a . 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. Questa sezione si riferisce alle applicazioni create con Motif 1.2™ (o versioni successive). La Gestione degli stili non può impostare i font dell'interfaccia per le applicazioni scritte con versioni precedenti di Motif. La Gestione degli stili del desktop imposterà automaticamente i font dell'interfaccia per le applicazioni create con 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 etichette, menu, pulsanti e altri elementi di sistema font utente Usato per i campi di testo e altre aree editabili Ogni font dispone di sette dimensioni, numerate da 1 a 7 nel riquadro 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 eventuali risorse dell'applicazione che specifichino i font per l'interfaccia. Il desktop imposterà automaticamente le risorse dell'applicazione in modo appropriato: FontList Impostato sul font di sistema XmText*FontList Impostato sul font utente XmTextField*FontList Impostato sul font utente Gestione degli stiliuso per l'integrazione dei colori La Gestione degli stili offre la possibilità di cambiare i colori delle applicazioni in modo dinamico. L'applicazione deve essere un client Motif 1.1 o 1.2. I client scritti con altri toolkit non supportano la modifica dinamica dei colori; le modifiche apportate vengono 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. Per un esempio della procedura da seguire per creare la directory radice per un'applicazione del desktop, vedere il della sezione a . I file del pacchetto di registrazione vengono raggruppati sotto una directory detta “radice dell'applicazione”, o <$nopage>radice_app, Vedere applicazioni, directory radiceradice_app. La directory radice_app usata per i file di configurazione del desktop può essere la stessa utilizzata come radice_app per l'installazione dell'applicazione o una directory diversa. Ad esempio, si supponga di avere installato un'applicazione sotto la directory /usr/BTE. 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/radiceapp_desktop/BTE. Per un esempio della procedura da seguire per creare le directory di un pacchetto di registrazione, vedere il della sezione a . Il pacchetto di registrazione è il gruppo di file di configurazione usato dal desktop per creare un'interfaccia grafica per l'applicazione. I file di configurazione del desktop includono: I file di definizione delle azioni e dei tipi di dati I file contenenti le immagini per le icone Una directory per il gruppo dell'applicazione e il relativo contenuto Opzionalmente: i file di dati dell'aiuto e un file di configurazione per il Pannello principale Il pacchetto di registrazione viene raggruppato a partire da una directory detta “radice dell'applicazione”, o radice_app.

Le categorie principali dei campi di configurazione che si trovano sotto la directory radice_app sono le seguenti: DirectoryContenuto types File di definizione per azioni e tipi di dati help File di aiuto del desktop 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 infolib File di documentazione online organizzati come infolib, librerie e libri 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 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. radice_app/dt/appconfig/types/lingua radice_app/dt/appconfig/help/lingua radice_app/dt/appconfig/icons/lingua radice_app/dt/appconfig/appmanager/lingua/gruppo_app, dove gruppo_app è il nome del gruppo dell'applicazione. Ad esempio, la mostra la Gestione di applicazioni contenente il gruppo_app “Multimedia”.

Il tool 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. Per un esempio dettagliato della procedura da seguire per creare le azioni e i tipi di dati per l'applicazione, vedere il della sezione a . Le azioni e i tipi di dati costituiscono l'interfaccia utente per l'applicazione. Le azioni costituiscono un'interfaccia utente per il comando con cui avviare l'applicazione. I tipi di dati attribuiscono un aspetto e un comportamento personalizzati ai file di dati dell'applicazione. In genere, le applicazioni richiedono le seguenti azioni e tipi di dati: Un'azione per l'avvio dell'applicazione. Un tipo di dati per i file di dati dell'applicazione. Quando si crea un tipo di dati, occorre creare anche: Un'azione Aprire per i file di dati dell'applicazione Un'azione Stampare per i file di dati dell'applicazione Un tipo di dati per il gruppo dell'applicazione (vedere ). Per un'introduzione sul modo in cui le azioni e i tipi di dati vengono usati nel desktop, vedere il . Le azioni e i tipi di dati vengono definiti in 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.

Le definizioni per le azioni e i tipi di dati di un'applicazione possono essere creati in uno dei modi seguenti: Usando il programma Creare azione. Creare azione fornisce un'interfaccia utente molto semplice con campi di testo in cui inserire le informazioni. Tuttavia, questo tool ha alcune limitazioni. Creando le definizioni manualmente. Questo metodo richiede la conoscenza della sintassi per la creazione delle definizioni, ma offre l'accesso a tutte le funzionalità disponibili. Questa procedura viene usata per creare un'azione e tipi di dati con l'utility Creare azione. Per maggiori informazioni su Creare azione, usare l'aiuto online o vedere il . Aprire il gruppo Applicazioni_desktop e fare doppio clic su Creare azione. Usare Creare azione per definire l'azione e i tipi di dati dell'applicazione. Il file di configurazione creato da Creare azione verrà scritto in DirectoryIniziale/.dt/type/nome_azione.dt. Il file dell'azione (l'eseguibile con lo stesso nome dell'azione) viene collocato nella directory iniziale dell'utente. Provare l'azione usando il file creato nella directory iniziale. Copiare il file di definizione dell'azione DirectoryIniziale/.dt/type/nome_azione.dt nella directory radice_app/dt/appconfig/types/lingua. Dopo avere creato la directory per il gruppo dell'applicazione (vedere la ), copiare il file dell'azione DirectoryIniziale/nome_azione nella directory radice_app/dt/appconfig/appmanager/lingua/gruppo_app. 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: Per un esempio della procedura da seguire per aggiungere un file di aiuto a un pacchetto di registrazione, vedere il della sezione a . Se l'applicazione comprende un volume di aiuto del desktop volume di aiutoposizione nel pacchetto di registrazione (cioè un volume di aiuto creato con l'Help Developer's Kit del desktop), il file fondamentale del volume di aiuto ( *.sdl) dovrà essere collocato nella directory radice_app/dt/appconfig/help/lingua. <$nopage>aiutoVedere anche volume di aiuto, file di aiuto[aiuto aaa]I file grafici usati dai file di aiuto vengono solitamente collocati nella directory secondaria graphics. I grafici devono mantenere la stessa posizione rispetto al file principale del volume di aiuto (*.sdl) in cui si trovavano quando è stato creato il volume. Se l'applicazione non comprende un volume di aiuto, l'Help Developer's KitHelp Developer's Kit permette di crearne uno. Per un volume di aiuto sono possibili due livelli di integrazione volume di aiutolivelli di integrazione : aiutointegrazione completaIntegrazione completa. Quando l'aiuto del desktop è integrato in modo completo, il volume è accessibile dall'applicazione — ad esempio, attraverso l'aiuto legato al contesto o il menu Aiuto. L'integrazione completa richiede la modifica degli eseguibili dell'applicazione. aiutointegrazione parzialeIntegrazione parziale. Quando l'aiuto del desktop è integrato in modo parziale, esso è disponibile dal livello più elevato della Gestione dell'aiuto, ma non dalle finestre dell'applicazione. È comunque possibile creare un'azione che consenta di accedere al volume di aiuto dal gruppo dell'applicazione. L'azione dell'esempio seguente visualizza il volume di aiuto del file principale volume di aiutofile principale MiaApp.sdl: ACTION ApriAiutoApplicazione { LABEL AiutoApp ARG_COUNT 0 TYPE COMMAND WINDOW_TYPE NO_STDIO EXEC_STRING /usr/dt/bin/dthelpview -helpVolume MiaApp DESCRIPTION Visualizza l'aiuto per l'applicazione MiaApp. } Se l'applicazione comprende documentazione online (creata con l'Information System Developer's Kit del desktop), la biblioteca delle informazioni ( *.dti) contenente la documentazione dovrà essere collocato nella directory:BiblioInfoubicazione nel paccheto di registrazione radice_appt/dt/infolib/lingua I file grafici usati dai file di libri DocBook (*.sgm) vengono solitamente collocati nella directory secondaria graphics. I grafici devono mantenere la stessa posizione rispetto al file principale della BiblioInfo (*.dti) in cui si trovavano quando è stata creata la BiblioInfo. Se l'applicazione non comprende della documentazione online, l'Information System Developer's Kit permette di crearne una.Information System Developer's Kit Per una BiblioInfo sono possibili due livelli di integrazione: BiblioInfolivelli di integrazione Integrazione completa.BiblioInfo integrazione completa Quando una BiblioInfo è integrata in modo completo, è accessibile dall'applicazione DtActionInvoke per visualizzare un argomento specifico sotto la Gestione delle informazioni. L'integrazione completa richiede la modifica degli eseguibili dell'appicazione. Integrazione parziale.BiblioInfo integrazione parziale Quando una BiblioInfo è integrata in modo parziale, essa è disponibile dal livello più elevato della Gestione delle informazioni, ma non dalle finestre dell'applicazione. È comunque possibile creare un'azione che consenta di accedere alla BiblioInfo dal gruppo dell'applicazione. L'azione dell'esempio seguente visualizza la BiblioInfo del file principale MiaApp.dti: AZIONE ApriBiblioInfoApplicazione { LABEL BiblioInfoApp ARG_TYPE BiblioInfo TYPE MAP MAP_ACTION DtLoadInfoLib /usr/dt/infolib/C/MiaAppInfolib.dti DESCRIPTION Avvia la Gestione delle informazioni per visualizzare la documentazione online per l'applicazione MiaApp. } Per un esempio delle procedure da seguire per creare i file delle icone per l'applicazione, vedere il della sezione a . 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. All'interno del desktop, l'applicazione utilizza le seguenti icone: icone avvio delle applicazioniiconedi applicazioniuso nel desktopiconedi azioniuso nel desktopIcona dell'azione. È l'icona che permette, con un doppio clic, di avviare l'applicazione (azione). Viene specificata nel campo ICON dell'azione che avvia l'applicazione. Specificare tre dimensioni: piccola, media e grande. icone di tipi di datitipi di datiiconeIcona del tipo di dati. Questa icona viene usata per rappresentare i file di dati dell'applicazione nella Gestione di file. Viene ricavata dal campo ICON della definizione del tipo di dati. Se l'applicazione supporta più tipi di dati, specificare un'icona diversa per ogni tipo. Specificare due dimensioni: piccola e media. icone gruppi di applicazionigruppi di applicazioniiconeIcona del gruppo dell'applicazione. È l'icona che rappresenta la directory al livello più elevato della Gestione di applicazioni. Viene specificata nel campo ICON della definizione del tipo di dati per il gruppo dell'applicazione. (Vedere .) Specificare due dimensioni: piccola e media. Per ogni icona si potranno includere sia una versione a mappa di pixel che una versione a mappa di bit per supportare la visualizzazione a colori (a otto bit e superiore) e monocromatica (meno di otto bit). Dimensione Dimensioni in pixel Nome del file a mappa di bitNome 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 rimapperà i colori della versione a mappa di pixel convertendoli in bianco e nero. Si noti tuttavia che questa mappatura potrebbe non produrre l'effetto desiderato. Per maggiori informazioni sulle icone, vedere . Per un esempio della procedura da seguire per creare un gruppo di applicazioni, vedere il della sezione a . 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. gruppi di applicazionidirectoryIl gruppo dell'applicazione è una directory che compare al livello più elevato della Gestione di applicazioni (vedere la ). La creazione di un gruppo per un'applicazione richiede tre operazioni: Creare la directory del gruppo nel pacchetto di registrazione. Opzionalmente: configurare il gruppo dell'applicazione in modo che utilizzi un'icona propria. Questo richiede la definizione di un tipo di dati per la directory del gruppo. Creare il contenuto del gruppo. Per creare un gruppo per un'applicazione, creare le directory richieste nel pacchetto di registrazione sotto appmanager, come mostrato nella .

Nella , <gruppo_app> è il nome del gruppo dell'applicazione.

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. 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: Un tipo di dati per la directory che compare al livello più elevato della Gestione di applicazioni. Le azioni Aprire e Stampare per il tipo di dati. Ad esempio, si supponga di voler creare un gruppo di applicazioni di nome Multimedia. La definizione per il tipo di dati sotto descritta, collocata in un file di nome radice_app/dt/appconfig/types/lingua/nome.dt, assegna un'icona specifica al gruppo dell'applicazione. DATA_ATTRIBUTES GruppoappMultimedia { ACTIONS OpenInPlace,OpenNewView ICON Multimedia DESCRIPTION Fare doppio clic per aprire il gruppo \ di applicazioni Multimedia } DATA_CRITERIA CriteriGruppoappMultimedia1 { DATA_ATTRIBUTES_NAME GruppoappMultimedia MODE d PATH_PATTERN */appmanager/*/Multimedia } La sezione degli attributi della definizione specifica l'icona da utilizzare. La sezione dei criteri specifica che il tipo di dati sarà associato a tutte le directory di nome Multimedia in posizione secondaria rispetto a una directory di nome appmanager. La mostra il rapporto che esiste tra il nome del gruppo dell'applicazione e la definizione del tipo di dati. Il campo PATH_PATTERN della definizione del tipo di dati collega un'icona specifica al gruppo dell'applicazione.

Si dovrà inoltre creare un'azione Aprire e un'azione Stampare per il tipo di dati del gruppogruppi di applicazioniazionigruppi di applicazionitipi di dati 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. Gli elementi più importanti di un gruppo sono le icone per l'avvio delle applicazioni (icone di azione). Se il gruppo contiene più applicazioni, occorrerà predisporre un'icona per ognuna. Oltre a queste icone di azione, il gruppo potrà contenere: Uno o più file README Uno o più esempi di file di dati Modelli Un'icona su cui fare doppio clic per visualizzare le informazioni di aiuto Una pagina di spiegazioni Un controllo speciale per il Pannello principale Il gruppo di applicazioni potrà contenere directory secondarie. Il gruppo di un'applicazione deve contenere un'icona che avvii l'applicazione. Se il gruppo contiene più applicazioni, sarà necessaria un'icona per ognuna. Queste icone vengono dette icone delle applicazioni, o icone delle azioni,poiché rappresentano un'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 dettofile delle azionicreazione 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 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.

Il desktop comprende un tipo di dati README utilizzabile per i file README dell'applicazione. Sono ammesse le seguenti denominazioni: README readme README.* Read.*.Me read.*.me READ.*.ME 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 “Installazione icona” di un pannello secondario. 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: La pagina di spiegazioni relativa a dtfpfile(4) Per un esempio della procedura da seguire per registrare un'applicazione, vedere il della sezione a . 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 ). 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. Effettuare il login come superutente. 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 di spiegazioni relativa a dtappintegrate(1). Aprire il gruppo di applicazioni Strumenti_desktop e fare doppio clic su “Ricaricare applicazioni”. Verificare che l'applicazione sia registrata correttamente: Visualizzare il livello più elevato della Gestione di applicazioni e verificare che compaia il nuovo gruppo dell'applicazione. Aprire il gruppo dell'applicazione e fare doppio clic sull'icona dell'azione. 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 da integrare dipendenti dalla lingua. -u Parametro opzionale. Annulla l'integrazione dell'applicazione, eliminando tutti i collegamenti creati nel processo di integrazione. La funzione di dtappintegrate è quella di creare collegamenti tra i file installati e le directory in cui il desktop cercherà i file di configurazione. 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 dtappintegrate crea una serie di collegamenti simbolici tra i file della biblioteca delle informazioni (BiblioInfo) che si trovano nel pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca del database delle BiblioInfo. I collegamenti vengono creati tra radice_appt/dt/infolib/lingua/*.dti e /etc/dt/infolib/lingua/*.dti dtappintegrate crea collegamenti simbolici tra i file di aiuto del pacchetto di registrazione e la directory di sistema inclusa nel percorso di ricerca dell'aiuto. I collegamenti vengono creati tra radice_app/dt/appconfig/help/lingua/file_aiuto.sdl e /etc/dt/appconfig/help/lingua/file_aiuto.sdl 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 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/gruppo_app e /etc/dt/appconfig/appmanager/lingua/gruppo_app 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 è: NEPrint [-d destinazione] [-s] nomefile dove: -d destinazione Specifica la stampante di destinazione. -s Specifica l'esecuzione della stampa in forma silente, cioè senza la visualizzazione di un riquadro di dialogo. nomefile Specifica il file da stampare. File di modello, identificati dal suffisso .mod. 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 di aiuto online per NuovoEditor usando l'Help Developer's Kit. Nella creazione del volume di aiuto sono stati usati i seguenti file: …/NEAiuto.htg …/graphics/NE1.xwd …/graphics/NE2.xwd per generare il file …/NEAiuto.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: /radiciapp_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: /radiciapp_desktop/NE/dt/appconfig/types /C/radiciapp_desktop/NE/dt/appconfig/help/C /radiciapp_desktop/NE/dt/appconfig/icons/C /radiciapp_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: /radiciapp_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 NEEsegui DESCRIPTION Per avviare NuovoEditor, fare doppio clic\ sull'icona o rilasciare sull'icona un file \ di dati di 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 Aprire,Stampare } DATA_CRITERIA CriteriFiledatiNE1 { DATA_ATTRIBUTES_NAME FiledatiNE NAME_PATTERN *.ned MODE f } Creare il tipo di dati per i file *.mod: DATA_ATTRIBUTES FileModelloNE { DESCRIPTION File modello per NuovoEditor. ICON ModNE ACTIONS Aprire } DATA_CRITERIA CriteriFileModelloNE1 { DATA_ATTRIBUTES_NAME FileModelloNE NAME_PATTERN *.mod MODE f } Creare l'azione Aprire per i file *.ned. ACTION Aprire { ARG_TYPE FileDatiNE TYPE MAP MAP_ACTION NEditor } Creare l'azione Stampare per i file *.ned. Qui di seguito sono riportate alcune azioni Stampare semplici 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 Stampare { ARG_TYPE FileDatiNE TYPE MAP MAP_ACTION StampareDatiNE } ACTION StampareDatiNE { WINDOW_TYPE NO_STDIO EXEC_STRING NEPrint -d $LPDEST %Arg_1% } Gli esempi seguenti presentano un'altra versione dell'azione StampareDatiNE 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 StampareDatiNE { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/NE/bin/NEPrint %(File)Arg_1% } Il contenuto dello script /usr/NE/bin/NEPrint è il seguente: # NEPrint #!/bin/sh DEST= "" SILENT="" if [ $LPDEST ]; then DEST=“-d $LPDEST” fi < NEPrint $DEST $SILENT $1 Creare l'azione Aprire per i file *.mod: ACTION Aprire { ARG_TYPE FileModelloNE TYPE MAP MAP_ACTION NEditor } Creare l'azione Stampare per i file *.mod: ACTION Stampare { ARG_TYPES FileModelloNE TYPE MAP MAP_ACTION NoPrint } NoPrint è un'azione predefinita che visualizza un riquadro di dialogo indicante che il file specificato dall'utente non può essere stampato. Collocare i file di aiuto nel pacchetto di registrazione. Collocare i file di aiuto nelle seguenti directory: /radiciapp_desktop/NE/dt/appconfig/help/C/NEAiuto.sdl /radiciapp_desktop/NE/dt/appconfig/help/C/graphics/NE1.xwd /radiciapp_desktop/NE/dt/appconfig/help/C/graphics/NE2.xwd Creare il file: /radiciapp_desktop/NE/dt/appconfig/types/C/NEAiuto.dt . Inserire nel file la seguente definizione per l'azione: ACTION AiutoNE { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/dt/bin/dthelpview-helpVolume \ NEAiuto.sdl DESCRIPTION Apre il volume di aiuto di NuovoEditor. } Creare le icone per l'applicazione. Creare le icone desiderate usando l'Editor delle icone. Usare i seguenti criteri per le dimensioni: Nome Dimensione nomebase.t.p 16 x 16 nomebase.m.pm 32 x 32 nomebase.l.pm 64 x 64 Creare i file sotto elencati nella directory /radiciapp_desktop/NE/dt/appconfig/icons/C: Icone per rappresentare l'azione che avvia l'applicazione: NEEsegui.t.pm, NEEsegui.m.pm, NEEsegui.l.pm Icone per rappresentare i file *.ned: DatiNE.t.pm, DatiNE.m.pm, Icone per rappresentare i file *.mod: 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.gruppi di applicazioni esempio di creazione Creare la directory. /radiciapp_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 azioni associate per il gruppo dell'applicazione. Omettendo questa operazione, il gruppo dell'applicazione userà l'icona predefinita. Aggiungere le seguenti definizioni al file /radiciapp_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 Aprire e Stampare dei gruppi di applicazioni predefiniti. DATA_ATTRIBUTES GruppoappNuovoEditor { ACTIONS OpenInPlace,OpenNewView ICON AppNE } DATA_CRITERIA CriteriGruppoappNuovoEditor { DATA_ATTRIBUTES_NAME GruppoappNuovoEditor MODE d PATH_PATTERN */appmanager/*/NuovoEditor } ACTION Aprire { ARG_TYPE GruppoappNuovoEditor TYPE MAP MAP_ACTION OpenAppGroup } ACTION Stampare { ARG_TYPE GruppoappNuovoEditor TYPE MAP MAP_ACTION PrintAppGroup } Creare un'icona da inserire nel gruppo per l'avvio dell'applicazione. Creare il file: /radiciapp_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor/NEditor e renderlo eseguibile. Creare nel gruppo dell'applicazione il file di azione per l'apertura del volume di aiuto. Creare il file: /radiciapp_desktop/NE/dt/appconfig/appmanager/C/NuovoEditor/AiutoNE 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: Effettuare il login come superutente. Eseguire il comando: /usr/dt/bin/dtappintegrate -s /radiciapp_desktop/NE Aprire il gruppo di applicazioni Strumenti_desktop e fare doppio clic su “Ricaricare applicazioni”.<$endrange>registrazione esempio