Ian
Geiser

# Usare gli script in KDevelop

## Eseguire gli script

Per accedere agli script disponibili in &kdevelop; selezionare la voce Strumenti Script. Se questa voce non è presente significa che non ci sono script disponibili.

## Aggiungere Script

Dopo aver aggiunto il supporto per KScript nella propria applicazione è semplice inserire degli script. Essi sono composti da due parti: un file desktop che contiene i metadati e lo script vero e proprio. Questo metodo viene usato per motivi di sicurezza e semplicità: il file desktop fornisce le meta-informazioni per i menu e il tipo di script, in modo che l'applicazione host non debba verificare lo script ogni volta che viene caricato. Di seguito viene mostrato un esempio di questo file:

Il precedente esempio mostra le parti principali che vengono esaminate da KScript. La prima voce "Name" è il nome che verrà visualizzato all'utente nell'applicazione host e la voce "Comment" contiene un commento che viene visualizzato in un aiuto. La voce "Type" è la più importante. È usata per selezionare lo script engine appropriato per eseguire lo script; attualmente in KDE sono disponibili "ShellScript/bash" e "JavaScript/kjs". Successivamente si deve creare lo script vero e proprio. Nell'esempio precedente il tipo di script usato è "ShellScript/bash". L'engine shellscript fornisce alcuni strumenti allo sviluppatore. Il primo elemento è l'ID DCOP dell'applicazione host, che viene passato allo script come primo argomento. Nello script, il valore "$1" restituirà l'ID DCOP dell'host. Di seguito viene mostrato un script shell di esempio:

Questo script è piuttosto semplice: esegue un comando ed imposta come testo del primo documento l'output del comando "ls -l"

L'applicazione KDCOP è uno degli strumenti più importanti nello sviluppo di script.

### Navigazione nelle interfacce DCOP in &kdevelop; con KDCOP

KDCOP permette agli sviluppatori di script la navigazione e il debug delle interfacce dell'applicazione host. Inoltre fornisce anche la possibilità di selezionare un metodo e trascinare il codice in un editor di testo, in modo da semplificare l'uso per chi non capisce i metodi DCOP del linguaggio host. Per l'accesso a DCOP vengono attualmente supportati i linguaggi KJSEmbed, Python e shell UNIX.

Una volta che lo script è completato può essere installato. Gli sviluppatori di applicazioni dovrebbero documentare la posizione che verrà esaminata per cercare gli script. Nell'esempio precedente gli script di Kate sono contenuti in "$KDEDIRS/share/apps/kate/scripts".

### Script &kdevelop; nel filesystem

Il file desktop e lo script associato dovrebbero essere contenuti nella stessa directory. Viene raccomandato agli sviluppatori di script di inserire nella stessa directory anche tutte le altre risorse per gli script come i file UI o i file di dati. Nell'esempio precedente gli script verranno visualizzati nel menu Strumenti->Script. È importante notare che gli script non dovrebbero effettuare operazioni che possono bloccarsi per un lungo periodo di tempo, o entrare in un loop di eventi perché la versione attuale dell'interfaccia degli script è adattata per compiti automatizzati che vengono eseguiti fino al loro termine. Essa verrà successivamente estesa in KDE 4.