Tracker/fr

Other languages:
Outils tiers
Débogage
Index
En février 2022, le suivi des bogues de FreeCAD a été transféré sur GitHub Issues. Le système de suivi des bogues Mantis décrit ci-dessous est maintenant en mode lecture seule.
link=https://freecadweb.org/tracker/MantisBT est le framework de bugtracker que FreeCAD utilise
link=https://freecadweb.org/tracker/MantisBT est le framework de bugtracker que FreeCAD utilise

Le traqueur de bogues FreeCAD est un endroit pour rapporter des bogues, soumettre des demandes de fonctionnalités, de correctifs, ou encore faire une demande de fusion de votre branche si vous développez avec Git. Le traqueur est divisé en plusieurs sections de travail, donc s'il vous plait soyez rigoureux et remplissez votre demande dans la catégorie appropriée. En cas de doutes, laissez le dans la section "FreeCAD".


Flux de travail recommandé

Comme vous pouvez le voir dans l'organigramme présenté ci-dessus, avant de créer des tickets, prenez le temps de faire des recherches dans les forums et le traqueur de bogues pour vérifier si votre problème n'est pas déjà référencé. Ceci afin d'éviter de gaspiller un temps de travail "au combien précieux" pour les développeurs et les volontaires qui pourraient le consacrer davantage au développement de l'application.

Signaler les bugs

Si vous pensez que vous pourriez avoir trouvé un bogue (dysfonctionnement ou erreur), vous êtes invité de le signaler si vous avez suivi nos instructions pas à pas.

Demande de fonctionnalités

Si vous souhaitez que quelque chose apparaisse dans FreeCAD qui ne soit pas encore implémenté, ce n'est pas un bug mais une demande de fonctionnalité.

  1. IMPORTANT ː Avant de demander une éventuelle demande de fonctionnalité assurez-vous d'être le premier à le faire en effectuant une recherche dans les forums et dans le bugtracker. Si vous avez conclu qu'il n'y a pas de tickets/discussions préexistants, la prochaine étape consiste à…
  2. Démarrer un fil de discussion pour discuter de votre demande de fonctionnalité avec la communauté via le Open Discussion forum.
  3. Une fois que la communauté accepte que cette fonctionnalité est valide, vous pouvez ensuite ouvrir un ticket sur le suivi (enregistrez-la sous feature request au lieu de "bug").
Page de rapport de FreeCAD Bugtracker - utilisez le menu déroulant pour désigner correctement le ticket

Soumettre un correctif (patch)

Si vous avez programmé une correction de bogue, une extension ou quelque chose d'autre qui peut être d'utilité publique dans FreeCAD, soumettez votre patch comme une "Pull Request" sur GitHub.

  1. Pour une contribution importante, complexe ou modifiant le comportement, ouvrez un fil de discussion sur le forum Developer subforum pour annoncer et discuter de votre correctif. Ce n'est pas nécessaire pour les petites corrections de bogues.
  2. Soumettez votre Pull Request (PR) sur la repo GitHub de FreeCAD. Le message de soumission de la PR sera pré-rempli avec une liste de contrôle que vous devrez suivre pour vous assurer que votre soumission a les meilleures chances d'être acceptée rapidement. Si vous n'avez jamais travaillé avec git auparavant ou si vous n'êtes pas familier avec la soumission d'un PR sur github, veuillez lire notre page wiki d'introduction github.
  3. Soyez présent lors de la discussion, à la fois sur le forum et dans la pull request GitHub afin que votre code puisse potentiellement être fusionné plus rapidement.

Demande de fusion

Si vous avez créé une branche git contenant les modifications que vous aimeriez voir fusionné dans le code FreeCAD, vous pouvez y demander que votre branche soit examinée et fusionnée si les développeurs FreeCAD sont OK avec elle. Vous devez d'abord publier votre branche dans un dépôt git publique (github, bitbucket, sourceforge ...) et donner ensuite l'URL de votre branche dans votre demande de fusion.

Si vous avez créé une branche git contenant les modifications que vous souhaiteriez voir fusionnées dans le code FreeCAD, vous pouvez demander à ce que votre branche soit revue et fusionnée si les développeurs FreeCAD le souhaitent. Vous devez d'abord publier votre branche dans un répertoire git public (github, gitlab, bitbucket, sourceforge, etc.), puis donner l'URL de votre branche dans votre demande de fusion.

Trucs et astuces sous MantisBT

Le balisage de MantisBT

MantisBT (Mantis Bug Tracker) a son propre balisage.

Le BBCode de MantisBT

En plus du balisage de MantisBT ci-dessus, il est également possible d'utiliser le format BBCode. Pour une liste complète, voir BBCode plus plugin page. Voici une liste des tags BBCode supportés ː
[img][/img] - Images
[url][/url] - Liens
[email][/email] - Adresses E-mail
[color=red][/color] - Texte colorisé
[highlight=yellow][/highlight] - Texte surligné
[size][/size] - Taille de police
[list][/list] - Listes
[list=1][/list] - Listes numérotées (le numéro est le numéro de départ)
[*] - Liste d'items
[b][/b] - Gras
[u][/u] - Sousligné
[i][/i] - Italique
[s][/s] - Barré
[left][/left] - Aligné à gauche
[center][/center] - Centré
[right][/right] - Aligné à droite
[justify][/justify] - Justifié
[hr] - Règle horizontale
[sub][/sub] - Indice
[sup][/sup] - Exposant
[table][/table] - Tableau
[table=1][/table] - Tableau avec bordure de largeur spécifiée
[tr][/tr] - Rangée du tableau
[td][/td] - Colone du tableau
[code][/code] - Bloc de code
[code=sql][/code] - Bloc de code avec définition de langage
[code start=3][/code] - Bloc de code avec des numéros de ligne commençant par un numéro
[quote][/quote] - Citation de *quelqu'un* (sans nom)
[quote=name][/quote] - Citation de *nom*

MantisBT <=> GitHub Markup

Vous trouverez ci-dessous des mots-clés spéciaux du plug-in MantisBT Source-Integration qui renverront au référentiel FreeCAD GitHub. Voir GitHub et MantisBT.

GitHub et MantisBT

Le bugtracker de FreeCAD a un plug-in appelé Source Integration qui lie essentiellement le référentiel FreeCAD GitHub à notre traqueur MantisBT. Cela facilite le suivi et l’association des commits git avec leurs tickets MantisBT respectifs. Le plug-in Source Integration recherche dans les messages de git commit des mots-clés spécifiques afin d'exécuter les actions suivantes :

Remarque : les mots-clés ci-dessous doivent être ajoutés au git commit message et non au sujet du PR.

Référencement à distance d'un ticket

L'utilisation de ce modèle associera automatiquement un commit git à un ticket (Remarque: cela ne fermera pas le ticket.) Le format MantisBT reconnaîtra:

Pour les curieux, voici le regex que MantisBT utilise pour cette opération:
/(?:bugs?|issues?|reports?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i

Résolution à distance d'un ticket

Le format que MantisBT reconnaîtra :

Pour les curieux, voici le regex que MantisBT utilise pour cette opération:
/(?:fixe?d?s?|resolved?s?)+\s*:?\s+(?:#(?:\d+)[,\.\s]*)+/i


Outils tiers
Débogage
Index
Hub utilisateurs