igl601_td10_redmine_et_tp2 - IGL601

TRAVAUX DIRIGÉS
REDMINE ET LE TP2
IGL601 TECHNIQUES ET OUTILS DE DÉVELOPPEMENT
3 NOVEMBRE 2016
PAR
JONATHAN GUAY, ING. M.ING., DAA, PMP
DÉPARTEMENT D’INFORMATIQUE
UNIVERSITÉ DE SHERBROOKE
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
AGENDA
•
•
•
•
Redmine
Redmine
Redmine
Redmine
et
et
et
et
le module d’extension ‘Embedded’
la gestion des accès
les anomalies
les wikis
2
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
3
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
4
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Embedded et
Doxygen
5
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Embedded et
Javadoc
6
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Quelques consignes pour vous aider
• Le répertoire racine doit absolument s’appeler html
• Le fichier que vous téléverser à Embedded doit avoir l’extension .zip
• Utiliser le gabarit ‘html-frame-vide.zip’ sur le site du cours
• Adapter au besoin le fichier index.html pour pointer vers le bon fichier .html de
départ pour votre documentation contenu sous les répertoires javadoc ou
doxygen
• Note: Vous pouvez rencontrer des erreurs de formattage. Vous n’avez pas à les
corriger pour le TP2. Par contre, assurez-vous de pouvoir permettre la
navigation des différentes classes et méthodes de votre documentation.
• J’ai personnellement eu plus de succès à utiliser index-all.html comme
fichier de départ que le fichier index.html.
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
7
REDMINE ET L’EXTENSION EMBEDDED
Quelques consignes pour vous aider (suite 2)
• Important, pour éviter des problèmes d’affichage avec Doxygen, vous devez générer
votre documentation Doxygen Sans module de recherche (Search).
• Pour ce faire, vous devez:
• 1) Créer un Doxyfile (doxygen –g)
• 2) Éditer le Doxyfile pour déactiver le module de recherche (Search)
• 3) Générer votre documentation avec ce doxyfile
• Si vous utilisez le Wizard graphique, décocher la case ‘Searchengine’ sous
Expert->HTML
8
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Quelques consignes pour vous aider (suite)
• Important, pour éviter des problèmes d’affichage avec Doxygen, vous devez générer
votre documentation Doxygen Sans module de recherche (Search).
• Pour ce faire, vous devez:
• 1) Créer un Doxyfile (doxygen –g)
• 2) Éditer le Doxyfile pour déactiver le module de recherche (Search)
• 3) Générer votre documentation avec ce doxyfile
• Si vous utilisez le Wizard graphique, décocher la case ‘Searchengine’ sous
Expert->HTML
9
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Exemple de formatage erroné si l’option ‘Search’ de Doxygen
n’est pas désactivée
10
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET L’EXTENSION EMBEDDED
Exercices:
1) Utiliser le fichier html.zip sur le site web du cours
(sous travaux pratiques) et rendez le disponible sous
votre projet Redmine (à faire en équipe)
2) Rendez disponible votre documentation javadoc ou
doxygen généré au TP1 sous votre projet Redmine
11
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LA GESTION DES ACCÈS
12
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LA GESTION DES ACCÈS
Voici les accès pour le rôle
‘Reporter’
13
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LA GESTION DES ACCÈS
Exercice:
• Donner accès « reporter » aux membres de l’équipe
responsable de la revue logicielle (à faire en équipe)
- Voir le TP2 pour connaître quelle est l’équipe qui procèdera à votre revue
logicielle.
14
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LES ANOMALIES
15
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LES ANOMALIES
16
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LES ANOMALIES
Exercice:
• Entrez une nouvelle anomalie ‘test’ sous votre projet et
attachez-y un fichier test.
• Entrez une nouvelle anomalie ‘test2’ sous le projet de
l’équipe que vous réviserez.
• Sous votre projet, assignez les anomalies à un membre
de votre équipe. Changer la catégorie de l’anomalie à
‘Feature’ Ajoutez un note et changer le statut à ‘In
progress’.
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
17
REDMINE ET LES WIKI
18
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LES WIKI
Question:
• Que devrait contenir un bon Wiki?
19
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke
REDMINE ET LES WIKI
Exercice:
• Créez un wiki pour le logiciel Sim3000
avec une structure similaire à l’image
suivante
• À la page ‘Discussion sur certaines
problématiques’, ajouter un lien vers
votre anomalie ‘test2’
• Créez une page réunion similaire à
l’image suivante:
20
Copyright 2016 Jonathan Guay, département d’informatique, université de Sherbrooke