Addon/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 7: Line 7:
== Différents types ==
== Différents types ==


<div class="mw-translate-fuzzy">
Il existe environ trois types d'extensions:
Il existe environ trois types d'extensions:
* [[Macros/fr|Macro]]: petit bout de code en [[Python/fr|Python]] qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par {{incode|.FCMacro}}.
* [[Macros/fr|Macro]]: petit bout de code en [[Python/fr|Python]] qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par {{incode|.FCMacro}}.
* Module: un seul fichier source Python, ou une collection de fichiers Python, qui étend le logiciel d'une certaine manière. Les modules ne définissent pas nécessairement un «atelier» graphique mais peuvent fournir une fonctionnalité de support, par exemple, une bibliothèque qui effectue la conversion des formats ou du code qui modifie l'[[interface/fr|interface]] graphique.
* Module: un seul fichier source Python, ou une collection de fichiers Python, qui étend le logiciel d'une certaine manière. Les modules ne définissent pas nécessairement un «atelier» graphique mais peuvent fournir une fonctionnalité de support, par exemple, une bibliothèque qui effectue la conversion des formats ou du code qui modifie l'[[interface/fr|interface]] graphique.
* [[External_workbenches/fr|Atelier]]: collections de fichiers Python qui fournissent des [[Gui_Command/fr|Gui Commands]] (outils) centrés autour d'un sujet particulier, par exemple, des outils pour concevoir des armoires ou des outils pour travailler avec l'architecture, ou des outils pour concevoir des bateaux, etc. Ces ateliers définissent généralement de nouvelles barres d'outils où des [[Gui_Command/fr|commandes]] sont placées sous forme de boutons.
* [[External_workbenches/fr|Atelier]]: collections de fichiers Python qui fournissent des [[Gui_Command/fr|Gui Commands]] (outils) centrés autour d'un sujet particulier, par exemple, des outils pour concevoir des armoires ou des outils pour travailler avec l'architecture, ou des outils pour concevoir des bateaux, etc. Ces ateliers définissent généralement de nouvelles barres d'outils où des [[Gui_Command/fr|commandes]] sont placées sous forme de boutons.
</div>

Les macros sont installées dans le répertoire {{incode|Macro/}} de l'utilisateur tandis que les modules et les ateliers se trouvent dans le répertoire {{incode|Mod/}}.
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/
}}

Généralement l'utilisation de macros sont un moyen de simplifier ou d'automatiser une tâche de dessin ou d'édition d'un objet particulier. Si plusieurs de ces macros sont collectées dans un répertoire et la structure est fournie pour collecter ces outils, puis le répertoire entier peut être distribué comme un atelier.

En d'autres termes, les macros, modules et les ateliers sont essentiellement la même chose, des éléments de code Python qui étendent les fonctionnalités de base. Les macros sont généralement courtes et concentrées sur une seule tâche, les modules fournissent généralement de nouvelles fonctions ou interfaces, et les ateliers sont des collections d'outils (boutons, menus) et d'interfaces graphiques pour effectuer des tâches connexes.

Si un atelier est suffisamment développé et bien documenté, il peut être inclus en tant qu'[[workbenches/fr|atelier]] de base dans FreeCAD.


== Installation ==
== Installation ==


<div class="mw-translate-fuzzy">
À partir de FreeCAD 0.17, la méthode recommandée pour installer des addons est d'utiliser [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|Gestionnaire d'Addon]].
À partir de FreeCAD 0.17, la méthode recommandée pour installer des addons est d'utiliser [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|Gestionnaire d'Addon]].
</div>


<div class="mw-translate-fuzzy">
Cependant, une installation manuelle est toujours possible.
Cependant, une installation manuelle est toujours possible.
* [[How_to_install_macros/fr|Comment installer une macro]]
* [[How_to_install_macros/fr|Comment installer une macro]]
* [[Installing_more_workbenches/fr|Comment installer un atelier]]
* [[Installing_more_workbenches/fr|Comment installer un atelier]]
</div>



{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Revision as of 08:50, 12 June 2022

Introduction

Dans FreeCAD et dans cette documentation, un addon est un composant qui ne fait pas partie de l'installation de base mais peut être ajouté au système par certaines méthodes.

Différents types

Il existe environ trois types d'extensions:

  • Macro: petit bout de code en Python qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par .FCMacro.
  • Module: un seul fichier source Python, ou une collection de fichiers Python, qui étend le logiciel d'une certaine manière. Les modules ne définissent pas nécessairement un «atelier» graphique mais peuvent fournir une fonctionnalité de support, par exemple, une bibliothèque qui effectue la conversion des formats ou du code qui modifie l'interface graphique.
  • Atelier: collections de fichiers Python qui fournissent des Gui Commands (outils) centrés autour d'un sujet particulier, par exemple, des outils pour concevoir des armoires ou des outils pour travailler avec l'architecture, ou des outils pour concevoir des bateaux, etc. Ces ateliers définissent généralement de nouvelles barres d'outils où des commandes sont placées sous forme de boutons.

Installation

À partir de FreeCAD 0.17, la méthode recommandée pour installer des addons est d'utiliser Gestionnaire d'Addon.

Cependant, une installation manuelle est toujours possible.