Addon/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Si vous développez un atelier en C++, il ne peut pas être exécuté directement par les utilisateurs et doit d'abord être compilé. Vous avez alors deux options, soit vous...")
No edit summary
 
(7 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 :
=== Ateliers en Python ===
* [[Workbench_creation/fr#Distribution|Distribution d'un atelier Python]]

* [[Workbench_creation/fr#Distribution_2|Distribution d'un atelier C++]]
Pour les ateliers en Python, vous n'avez pas besoin d'une approbation spécifique pour que votre atelier soit ajouté au gestionnaire d'addons. De plus, comme votre addon ne fait pas partie du code source de FreeCAD, vous pouvez choisir la licence qui vous convient. Si vous demandez que votre atelier soit ajouté à la liste par défaut du gestionnaire d'addons (nous n'ajouterons aucun nouvel atelier sans une demande de ses auteurs), soit en le demandant sur le forum, soit en ouvrant un problème sur le dépôt [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons], votre code restera sur votre propre dépôt git, nous l'ajouterons simplement comme un sous-module au dépôt [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons]. Bien sûr, avant d'ajouter votre atelier, nous y jetterons un coup d'œil et nous nous assurerons qu'il n'y a rien de potentiellement problématique. Pour plus de détails sur la structuration de votre addon, y compris des informations sur les métadonnées utilisées par le gestionnaire d'addons, voir [[Workbench_creation/fr|Création d'atelier]].

=== Ateliers en C++ ===

Si vous développez un atelier en C++, il ne peut pas être exécuté directement par les utilisateurs et doit d'abord être compilé. Vous avez alors deux options, soit vous fournissez vous-même des versions précompilées de votre atelier, pour les différents systèmes d'exploitation, soit vous demandez à ce que votre code soit intégré au code source de FreeCAD. Pour cela, vous devez utiliser la licence LGPL (ou une licence totalement compatible comme MIT ou BSD), et vous devez présenter vos nouveaux outils à la communauté sur le [https://forum.freecadweb.org forum de FreeCAD] pour examen. Une fois que votre code a été testé et approuvé, vous devez faire un fork du dépôt FreeCAD, si ce n'est pas encore fait, créer une nouvelle branche, y pousser votre code, et ouvrir une demande d'extraction pour que votre branche soit fusionnée dans le dépôt principal.





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 :