Addon/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire d'addons, lisez comment faire sur les pages : ([https://github.c...")
No edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 4: Line 4:
== Introduction ==
== Introduction ==


Dans FreeCAD et dans cette documentation, un [[addon/fr|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.
Dans FreeCAD et dans cette documentation, une [[addon/fr|extension]] est un composant qui ne fait pas partie de l'installation de base mais peut être ajouté au système par certaines méthodes.


<span id="Different_types"></span>
== Différents types ==
== Différents types ==


Il existe environ trois types d'extensions:
Il existe environ trois types d'extensions :
* [[Macros/fr|Macros]]: 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|Macros]] : 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}}.
* [[External_workbenches/fr|Ateliers]]: 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|Ateliers]] : 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.
* [[Preference_Packs/fr|Kits de préférence]] : kits de préférences d'utilisateurs. {{Version/fr|0.20}}
* [[Preference_Packs/fr|Kits de préférence]] : kits de préférences d'utilisateurs. {{Version/fr|0.20}}


== Installation ==
== Installation ==


La méthode recommandée pour installer des addons est d'utiliser le [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|Gestionnaire d'Addon]].
La méthode recommandée pour installer des extensions est d'utiliser le [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|Gestionnaire des extensions]].


Mais pour les macros et les ateliers, une installation manuelle est également possible :
Mais pour les macros et les ateliers, une installation manuelle est également possible :
Line 21: Line 22:
* [[Installing_more_workbenches/fr|Comment installer un atelier]]
* [[Installing_more_workbenches/fr|Comment installer un atelier]]


<span id="Information_for_developers"></span>
== Informations pour les développeurs ==
== Informations pour les développeurs ==


Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire d'addons, lisez comment faire sur les pages : ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si vous ajoutez votre macro à la page [[Macros_recipes/fr|Liste des macros]], il n'y a rien d'autre à faire, elle sera automatiquement récupérée par le gestionnaire d'addons.
Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire des extensions, lisez comment faire sur les pages : ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si vous ajoutez votre macro à la page [[Macros_recipes/fr|Liste des macros]], il n'y a rien d'autre à faire, elle sera automatiquement récupérée par le gestionnaire des extensions.


Voir aussi :
=== Python workbenches ===
* [[Workbench_creation/fr#Distribution|Distribution d'un atelier Python]]

* [[Workbench_creation/fr#Distribution_2|Distribution d'un atelier C++]]
For Python workbenches, you don't need any specific approval to have your workbench added to the Addon Manager. In addition, because your Addon is outside the FreeCAD source code, you can choose the license you want. If you request for your workbench to be added to the Addon Manager's default list (we will not add any new workbench without a request from its authors), either by asking so on the forum or by opening an issue on the [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] repository, your code will stay on your own git repository, we will just add it as a submodule to the [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] repository. Of course, before adding your workbench, we will take a look at it and make sure there is nothing potentially problematic with it. For more details about structuring your Addon, including information about metadata used by the Addon Manager, see [[Workbench_creation|Workbench creation]].

=== C++ workbenches ===

If you develop a workbench in C++, it cannot be run directly by users and must be compiled first. You then have two options, either you provide precompiled versions of your workbench yourself, for the different operating systems, or you should request to have your code merged into the FreeCAD source code. For that, you should use the LGPL license (or a fully compatible license like MIT or BSD), and you must present your new tools to the community in the [https://forum.freecadweb.org FreeCAD forum] for review. Once your code has been tested and approved, you should fork the FreeCAD repository, if not done yet, create a new branch, push your code to it, and open a pull request so that your branch is merged into the main repository.





Latest revision as of 18:31, 21 November 2023

Introduction

Dans FreeCAD et dans cette documentation, une extension 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 :

  • Macros : petit bout de code en Python qui fournit un nouvel outil ou une nouvelle fonctionnalité dans un seul fichier se terminant par .FCMacro.
  • Ateliers : 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.
  • Kits de préférence : kits de préférences d'utilisateurs. introduit dans la version 0.20

Installation

La méthode recommandée pour installer des extensions est d'utiliser le Gestionnaire des extensions.

Mais pour les macros et les ateliers, une installation manuelle est également possible :

Informations pour les développeurs

Si vous avez développé une macro ou un atelier, et que vous souhaitez qu'il soit inclus dans le gestionnaire des extensions, lisez comment faire sur les pages : (FreeCAD-addons et FreeCAD-macros). Si vous ajoutez votre macro à la page Liste des macros, il n'y a rien d'autre à faire, elle sera automatiquement récupérée par le gestionnaire des extensions.

Voir aussi :