Test di accettazione con Abbot e Fitnesse

Abbot è una libreria per poter scrivere test di una GUI in Swing o SWT. Grazie a queste classi possiamo programmare test first anche sulla GUI, o scrivere test di accettazione pilotando la GUI. Il mio obiettivo “finale” è scrivere test di accettazione con Fitnesse, che testano le operazioni della GUI (quindi non la GUI), pilotando la GUI stessa. In particolare mi interessa agire su una GUI scritta in SWT, ed è questo uno dei motivi principali per i quali la mia scelta è caduta su Abbot.

Di seguito la procedura che ho seguito per creare i jar da includere nelle applicazioni da testare.

Allo stato attuale non esiste una versione stabile di abbot.swt: è necessario scaricare i sorgenti da SVN (o CVS) e costruire il jar. E’ anche possibile installare abbot ed abbot.swt come plugin eclipse, ma come detto il mio obiettivo è usare abbot con Fitnesse, quindi mi basta avere i jar.

Premetto che non è proprio immediato creare i jar, soprattutto perché in alcuni tratti la documentazione è un po’ nebulosa. Ad ogni modo seguendo i passi che ho tracciato qui non dovreste avere problemi.
Una precisazione importante: ad oggi abbot.swt non compila sotto eclipse 3.2, a causa dell’interfaccia IAdaptable non più presente nel runtime jar del nuovo Eclipse Callisto. I passi seguenti funzionano quindi per un eclipse 3.1.x.

Checkout del modulo abbot da svn (o cvs):

	https://svn.sourceforge.net/svnroot/abbot/abbot/trunk

Se state effettuando il checkout da eclipse, molto probabilmete eclipse vi creerà un altro progetto, abbot.plain, da utilizzare nel Workbench. Vi consiglio vivamente comunque di fare il build da riga di comando e non da eclipse.

Dalla directory nella quale avete scaricato il modulo abbot (non abbot.plain), digitate:

	ant

Ora dovreste trovarvi sotto build il jar abbot.jar.

Effettuare ora un checkout di abbot.swt. E’ importante che la directory abbot.swt scaricata sia allo stesso livello della precedente directory abbot.

	https://svn.sourceforge.net/svnroot/abbot/abbot.swt/trunk/abbot.swt

Creare ora il file eclipse.properties sotto abbot.swt e specificare la proprietà eclipse.home valorizzata con il path completo della home dell’eclipse che state utilizzando.

Modificare il build.xml:
da

	<include name="org.eclipse.swt.win32.win32.x86_3.1.0.jar" />

a

	<include name="org.eclipse.swt.win32.win32.x86_3.1.*.jar" />

Da riga di comando sotto abbot.swt:

	ant

A questo punto avete sotto abbot/build e abbot.swt/build i jar necessari per scrivere i test con Abbot. Per testare che i jar siano stati creati correttamente, portate nell’applicazione che volete testare i jar abbot.swt.jar, abbot.jar e abbot.swt.example.jar, oltre ovviamente ad swt.jar accoppiato con la sua dll, da aggiungere nel java.library.path della jvm (io sto usando una 1.4.2) o all’interno della variabile d’ambiente PATH del vostro sistema operativo. Eseguite a questo punto i due TestCase che trovate nel jar abbot.swt.example.jar.

E’ presente nello stesso jar di esempio la classe di test SWTPatchTest1, che testa se siete esenti dal seguente “bug” sulle SWT: bug.


Tale bug è presente, ad oggi, su tutte le versione delle SWT, ma Abbot fornisce una patch scaricabile da SVN (o cvs) al seguente indirizzo:

https://svn.sourceforge.net/svnroot/abbot/abbot.swt/trunk/org.eclipse.swt.

patched

Peccato che per quanto mi riguarda con la patch 3123 il TestCase di cui sopra mi fa fallire 3 test su 6, mentre con la 3232 non patchata i test che falliscono sono 2 su 6… Quindi sono rimasto alla versione originale. Se a voi funziona fatemi sapere.

Questo è quanto: ai prossimi post per la parte più divertente.