SDK
Pacchetto di installazione
Il pacchetto di installazione comprende i seguenti file e percorsi:
- iSysCleaner.exe, eseguibile principale;
- iSysCleaner.xml, file di configurazione;
- lng.dll, libreria dinamica per il caricamento e la gestione dei file di
linguaggio;
- misc.dll, libreria dinamica di supporto;
- languages, percorso contenente i file di linguaggio (vedi Crea un file
di linguaggio);
- defines, percorso contenente i file di definizione e scripts (vedi
Definizioni e Scripts);
- traces, percorso contenente i file di log;
- saves, percorso contenente i file di analisi salvati (lista oggetti);
- rips, percorso contenente i file di crash dell'applicativo (vedi Notificare un crash).
Percorso Defines
Con l'installazione sono forniti i seguenti file di definizione.
- cookies.def, file di definizione dei tracking cookies;
- applications.script, script file applicazioni di terzi;
- extensions.def, file di definizione delle estensioni di base.
Percorso Languages
Nella directory "Languages" sono installati i file di linguaggio.
Collegandosi al sito sarà possibile scaricare altri file di linguaggio.
Funzionamento
iSysCleaner è una applicazione multi-threads composta da un modulo principale
(eseguibile) e da file esterni opzionali contenenti informazioni addizionali.
Modifiche e aggiunte personali
Prima di modficare i file di linguaggio e gli script esistenti:
- leggete attentamente il manuale di utilizzo del programma;
- fate un backup dei file esistenti;
- riportate ogni modifica via e-mail a <support@isyscleaner.net>;
- in caso di malfunzionamento inviate il vostro file a
<support@isyscleaner.net> e ripristinate il file originali.
Tutte le aggiunte o le modifiche ritenute interessanti e utili saranno
distribuite con le versioni successive del programma e rese disponibili sul sito.
Creare un file di linguaggio
Per creare un file di linguaggio basta:
- creare una copia del file english.lng,
- rinominare il file ricordando di tenere l'estensione .lng,
- impostare il nome da visualizzare,
- tradurre le stringhe dei corrispettivi elementi.
Editando il file english.lng con un semplice editor di testo, troviamo le
seguenti righe.
[0001.0001]
Questa riga è il numero di versione del file. Specificare sempre il numero
di versione aiuta a manuntenere il file di linguaggio da una versione all'altra.
[MAIN]
In questa sezione sono specificati il nome (name) del linguaggio e se il
file è il linguaggio corrente (default).
Il nome del linguaggio è lo stesso visualizzato nella combobox di selezione.
[STRINGS]
In questa sezione sono specificati tutti i singoli gli elementi e la stringa
associata.
Esempio
Prima cosa duplico il file english.lng e lo rinomino in
italian.lng. Poi con un editor di testo modifico la stringa name in "Italiano" e
imposto il default a "false". Traduco tutte le stringhe. il risultato è il
seguente.

Definizioni e Scripts
In queste prossime righe descriverò come creare un proprio file di
definizione e come modificare il file applications.script.
Definizioni
I file di definizione sono una lista di stringhe utilizzate dal programma per
cercare congruenze tra la lista e i file trovati.
Per esempio, il file cookies.def contiene una lista di alcuni tracking
cookies riconosciuti. Il rpogramma cerca delle congruenze in ogni file di
cookies. Se ne trova allora seleziona il file come "Tracking Cookies".
Per rendere la ricerca più approfondita e completa, è possibile aggiungere
altre stringhe di definizione a quelle esistenti.
Ogni file è editabile con il semplice notepad. Vediamo come.

Come nei file di linguaggio, anche qui la prima riga è dedicata
al numero di versione "[0001.0000]". Le righe successive sono le stringhe
di match usate dal programma. Anche i caratteri jolly (*?) possono essere usati.
Per esempio. Se definisco una riga come "acme*.com", il
programma cercherà un match simile nei file. Quindi valori come "acmeporn.com",
"acme123.com" e "acmexyz123.com" sono tutti accettabili.
Scripts
I file di script sono un pò più complicati dei file di
definizione. Per il momento l'applicativo gestisce il solo file di script
"applications.script". In futuro sarà possibile definire nuovi file
personalizzati nei quali definire i file da cancellare.
Vediamo come modificare e aggiornare il file
"applications.script".

Il file è strutturato come un file ini, con le sue sezioni e le
chiavi. Ogni sezione, tranne la prima, definisce una riga nella lista delle
applicazioni.
[0001.0001]
Questa è la versione del file.
[<nome sezione>]
Si definisce qui il nome della sezione. Nell'esempio abbiamo "Acrobat Reader
Search Cache". Ogni sezione all'interno del file deve essere univoca. Non
possono esserci sezioni con lo stesso nome.
version
numero di versione della sezione.
selected
indica al programma se la sezione è selezionata oppure no. Se selezionata
verrà inclusa nel processo di scansione.
subfolder
1 = vero, 0 = falso. Se vero il programma include anche tutti i sotto
percorsi nel processo di scansione.
display
Stringa visualizzata in interfaccia.
items
numero degli item a seguire. Ogni item deve essere formato da almeno due
delle chiavi sottostanti: "folder_include" e "extension_include".
x.folder_include
indica il percorso in cui eseguire la scansione (vedi anche "Costanti di
default").
x.folder_exclude
indica il sotto percorso da escludere nel processo di scansione (vedi anche
"Costanti di default").
x.extension_include
estensione dei file da cercare nel percorso definito in x.folder_include
(vedi "Lista estensioni").
x.extension_exclude
estensione dei file da escludere nel percorso definito in
x.folder_include (vedi "Lista estensioni").
Editando il file esistente "applications.script" con un semplice
editor di testo, sarà possibile modificare le sezioni esistenti oppure
aggiungerne di nuove.
Costanti di default
Le costanti di default sono stringhe racchiuse tra parentesi
graffe { }. Il programma converte queste costanti nel loro valore di default.
Per esempio {win} corrisponde al folder "C:\Windows".
Di seguito troviamo la lista delle costanti di default
supportate.
{appdata}
= C:\Documents and Settings\username\Application Data.
{commonappdata}
= C:\Documents and Settings\All Users\Application Data.
{localappdata}
= C:\Documents and Settings\username\Local Settings\Application Data.
{sys}
= C:\Windows\System32.
{win}
= C:\Windows.
Lista estensioni
Sezione al momento non disponibile.
|