Difference between revisions of "FR/qa-test/TestTool"

From Apache OpenOffice Wiki
< FR
Jump to: navigation, search
(Présentation)
Line 5: Line 5:
 
=Présentation=
 
=Présentation=
  
TestTool est un exécutable qui test OOo tout seul. Il est capable d'enchaîner de nombreux essais. Il rédige lui-même les comptes rendus des essais qu'il fait.<br/>
+
TestTool est un exécutable qui teste OOo tout seul. Il est capable d'enchaîner de nombreux essais. Il rédige lui-même les comptes rendus des essais qu'il fait.<br/>
 
Pour fonctionner, l'exécutable TestTool doit aussi avoir son "Environnement" : c'est un gros paquet de fichiers, qu'on appelle en abrégé TestTool-Env ; il est livré dans une arborescence de dossiers dont la racine s'appelle qatesttool.<br/>
 
Pour fonctionner, l'exécutable TestTool doit aussi avoir son "Environnement" : c'est un gros paquet de fichiers, qu'on appelle en abrégé TestTool-Env ; il est livré dans une arborescence de dossiers dont la racine s'appelle qatesttool.<br/>
 
<br/>
 
<br/>
 
Remarque : Le TestTool a été testé sur différents systèmes :
 
Remarque : Le TestTool a été testé sur différents systèmes :
* Linux (Debian, Mandrake,..), Win 2000, Win XP et Mac OS X
+
* Linux (Debian, Mandrake/Mandriva,..), Win 2000, Win XP et Mac OS X
  
 
=Installation=
 
=Installation=

Revision as of 04:35, 11 October 2007

Wiki Francophone OOo

LaMouette BigJump.png

Sommaire:

Catégories:

Site principal Francophone


Présentation, Installation et Utilisation

Présentation

TestTool est un exécutable qui teste OOo tout seul. Il est capable d'enchaîner de nombreux essais. Il rédige lui-même les comptes rendus des essais qu'il fait.
Pour fonctionner, l'exécutable TestTool doit aussi avoir son "Environnement" : c'est un gros paquet de fichiers, qu'on appelle en abrégé TestTool-Env ; il est livré dans une arborescence de dossiers dont la racine s'appelle qatesttool.

Remarque : Le TestTool a été testé sur différents systèmes :

  • Linux (Debian, Mandrake/Mandriva,..), Win 2000, Win XP et Mac OS X

Installation

2.1 - Installer l'exécutable TestTool

L'exécutable TestTool en français est livré en standard dans OOo. Cependant, lors d'une installation courante avec les paramètres "par défaut", il n'est pas installé. Il convient donc d'installer (ou de réinstaller) OOo :

  • Choisir "installation personnalisée" et sélectionner tous les composants.
  • L'exécutable TestTool est alors dans le sous-dossier "program" (testtool.bin sous Linux)

(pour Linux, une installation normale des paquetages RPM installe aussi le programme dans le répertoire standard, en principe dans /opt/openoffice.org2.0 )

2.2 - Télécharger TestTool-Env

L'environnement du TestTool, se télécharge en utilisant le système CVS pour être certain d'avoir la dernière version actualisée par les développeurs :

  • Télécharger TestTool-Env

2.3 - Paramétrer TestTool

Avant de pouvoir utiliser le TestTool, il est nécessaire de le paramètrer :

  • Paramétrer TestTool

2.4 - Sauvegarder vos réglages personnels

ATTENTION : Pendant son fonctionnement TestTool modifie fréquemment la configuration de OOo. Vous allez donc perdre vos réglages personnels ! Pour pallier cet inconvénient, sauvegardez votre configuration avant d'utiliser TestTool : vous pourrez ainsi restaurer vos règlages après avoir terminé les essais :

  • Faites une copie de sauvegarde du dossier OOo situé dans votre profil utilisateur.
  • Lancez TestTool en tant que simple utilisateur (pas en admin).

Une autre solution consiste à créer un utilisateur spécifique pour le TestTool

3 - Utilisation

3.1 - Tester TestTool :-)

  • Fermez OOo et le démarrage rapide de OOo (n'existe pas sous Linux).
  • Lancez le porgramme TestTool
  • Menu "Fichier / Ouvrir" et sélectionnez par exemple le programme "qatesttool\framework\first\first.bas" ou le programme "qatesttool\framework\first\topten.bas"
  • Menu "Programme / Démarrer" (Chaque programme dure environ 15 mn)


Et après ?

  • Il y a plus de 200 autres programmes .bas dans le TestTool-Env


Remarque : Lors de l'utilisation de TestTool-Env, de nombreux fichiers seront enregistrés dans le dossier "user/work" du dossier OOo de votre profil utilisateur. Dans ce dossier il y a aussi le fichier "crashrep.txt" qui apparemment devrait contenir les rapports de crash de OOo, mais jusqu'à maintenant, il est resté vide.

3.2 - Lancer testtool en batch

ATTENTION : Ce script dure entre 60 et 80H. Il est conseillé de sauvegarder sa confiugration de OOo avant de le lancer
Il existe un script permettant de lancer plusieurs tests (fichiers .bas) automatiquement :

  • Sous Linux, il faut lancer le programme : qatesttool\script\unix\OOoTestRun_unix.sh ou ooo_releasetests.sh
  • Sous Win, il faut lancer le programme : qatesttool\script\win32\OOoTestRun_win32.bat ou ooo_releasetests.bat


Pour pouvoir utiliser ce script, il faut modifier les deux variables au début du fichier pour indiquer le chemin d'installation de OOo et le chemin d'installation du testtool-env. Exemple :

  • set tool="C:\Program Files\OpenOffice.org 2.0\program\testtool"
  • set work=C:\QA-TEST


(Dans mon cas, le dossier QA-TEST contient le sous-dossier "qatesttool" contenant le testtool-env téléchargé via CVS)

Sous Linux pour la 2.0.3rc3, j'ai :

  • sLocation=/CVS/TestTool/qa (Ce chemin contient le dossier "qatesttool" téléchargé via CVS)
  • sTestTool=/opt/openoffice.org2.0/program/testtool.bin


Pour finir il faut indiquer la liste des fichiers .bas à lancer dans la variable 'testList', Pour éviter de les saisir manuellement et pour avoir une estimation de la durée total des tests, il existe un outil permettant de sélectionner facilement les scripts à executer :

3.3 - Lancer testtool en batch (Version améliorée)

Yves propose une version améliorée du script évoqué précédemment. Ce script modifié, permet de fixer un temps MAXIMUM au delà duquel la macro stoppera. Il permet aussi, lors de la relance, de passer tous les tests déjà effectués (si .res existe). Ce script modifié est disponible ici et il suffit de le placer dans le même dossier que le script original :

3.4 - Lancer testtool en batch sous Mac OSX

La plupart des informations mentionnées ci-dessus sont valables pour tous les systèmes, mais vous trouverez dans la page suivante des informations complémentaires pour faire fonctionner le testtool sous Mac OSX :

  • TestToolMacOSX

4 - Question subsidiaire: ce que je télécharge avec cvs sous Linux peut être recopié tel quel sous Windows?

oui ; lorsqu'il y a des scripts différents, ils sont présents dans les deux versions : exemple, pour faire tourner testtool en batch :

  • qatesttool\script\unix\OOoTestRun_unix.sh ou ooo_releasetests.sh
  • qatesttool\script\win32\OOoTestRun_win32.bat ou ooo_releasetests..bat


J'ai quand même eu un blême avec un fichier .bas :

  • je l'avais zieuté, et y avait rajouté une ligne de commentaire sauvegardée avec je ne sais plus quel éditeur de texte qui n'a pas aimé les fins de ligne à la unix ; résultat : l'interpréteur basic de testtool voyait des double fin de ligne à chaque ligne, et donc plantait sur les lignes continuées.
  • Petit ménage des fins de lignes sur ce fichier, et retour à la normale.

5 - Analyser les résultats

Le test complet comporte environ 200 scripts pour une durée totale théorique de 81H (La durée est quasiment indépendante de la puissance de la machine, car il y a de très nombreuses pauses). Chaque script créé un fichier de résultat avec l'extension « .res » ou il indique les problèmes rencontrés. La difficulté réside donc dans l'analyse de ces scripts.

Bob a réalisé une macro sous OOo permettant de faire la synthèse des résultats (fichiers .res d'un même répertoire) en ne retenant que les warning et les erreurs :


De plus, de nombreux problèmes identifiés par le TestTool ne sont pas des problèmes liés à OOo mais uniquement des problèmes de scripts ou de configuration du TestTool. Il faut donc trier les problèmes liés à OOo et ceux liés au TestTool.

6 - Résumé des opérations

  • Installer la dernière version de OOo (OOo 2.0.3 RC3 à ce jour)
  • Choisissez l'installation complète pour avoir les outils de test.
  • Utiliser l'exécutable TestTool qui est dedans.
  • Récupérer via CVS le qatesttool tagué : HEAD
  • Tester avec first.bas
  • Préparer le lancement automatique des scripts à l'aide de la macro
  • Executer tous les scripts demandés (Pour la version 2.03, les scripts à lancer sont indiqués sur cette page http://qa.openoffice.org/qatesttool/all_tests_ooo203.html)
  • Faire la synthèse des scripts à l'aide de la macro de Bob
  • Placer les résultats (fichiers .res et synthèse) dans un zip et dans le dossier http://fr.openoffice.org/servlets/ProjectDocumentList?folderID=609
    • Pour faciliter les recherches, il faudrait nommer le fichier .zip sous la forme suivante : VersionOOo_OS_Auteur (ex : 2.03rc5_Win2000_Francis.zip ou 2.0.3rc5_Win-XP-SP1-JRE_Patrice)
    • Il existe une FAQ expliquant comment déposer un document dans Doc&Files : http://fr.openoffice.org/FAQ/general_fr/g43fr.htm
Personal tools