Std AddonMgr/fr: Difference between revisions

Revision as of 11:35, 18 May 2022

Other languages:

Emplacement du menu
Std Gestionnaire d'Addons
Outils → Gestionnaire d'Addons
Ateliers
Tous
Raccourci par défaut
Aucun
Introduit dans la version
0.17
Voir aussi
Ateliers externes, Macros

Description

La commande Gestionnaire d'Addons ouvre le gestionnaire de modules complémentaires. Avec le Gestionnaire d'Addons, vous pouvez installer et gérer ateliers complémentaires et des macros fournis par la communauté FreeCAD. Les ateliers et les macros disponibles proviennent de deux dépôts FreeCAD-addons et FreeCAD-macros et à partir de la page Liste des macros.

Les addons marqués par Python 2 uniquement ne fonctionneront pas dans FreeCAD version 0.19 ou supérieure.

En raison des modifications apportées à la plate-forme GitHub en 2020, le gestionnaire de modules complémentaires ne fonctionne plus si vous utilisez des versions de FreeCAD inférieure ou égale à 0.17. Vous devez passer à la version 0.18.5 ou à une version récente 0.19. Vous pouvez également installer les addons manuellement, voir Remarques ci-dessous.

File:Std AddonMgr dialog.png

Boîte de dialogue du Gestionnaire d'Addons

Utilisation

Sélectionnez l'option Outils → Gestionnaire d'Addons dans le menu.
Si vous utilisez le gestionnaire d'extensions pour la première fois, une boîte de dialogue s'ouvrira pour vous avertir que les extensions du gestionnaire d'Addons ne font pas officiellement partie de FreeCAD. Appuyez sur le bouton OK pour confirmer et continuer.
La boîte de dialogue Addons s'ouvre. Pour plus d'informations, voir Options.
Le bouton Tout mettre à jour ne fonctionne pas pour le moment.
Appuyez sur le bouton Fermer pour fermer la boîte de dialogue.
Si vous avez installé ou mis à jour un plan de travail, une nouvelle boîte de dialogue s'ouvre vous informant que vous devez redémarrer FreeCAD pour que les modifications prennent effet.

Options

La boîte de dialogue Addons comporte deux onglets à gauche, l'un répertoriant les ateliers disponibles et l'autre répertoriant les macros disponibles. Le panneau d'information sur la droite affichera la page d'accueil de l'addon sélectionné.

Désinstaller

Sélectionnez un module complémentaire installé dans l'onglet Ateliers ou dans l'onglet Macros.
Appuyez sur le bouton Désinstaller la sélection.

Installer/mettre à jour

Sélectionnez un module complémentaire dans l'onglet Ateliers ou dans l'onglet Macros.
Appuyez sur le bouton Installer/mettre à jour la sélection.
Si vous souhaitez ajouter une macro à une barre d'outils personnalisée, n'oubliez pas de télécharger manuellement le fichier image d'icône, si disponible, en cliquant sur le lien sur la page d'accueil dans le panneau d'informations. Voir Personnalisation de l'interface.
Pour modifier la position d'un atelier complémentaire dans la liste des Ateliers, voir Personnalisation de l'interface.

Configuration

Appuyez sur le bouton Configurer....
La boîte de dialogue des options du gestionnaire d'extensions s'ouvre.
Cochez éventuellement la case Rechercher automatiquement les mises à jour au démarrage (nécessite GitPython).
Ajoutez éventuellement des dépôts à la liste Dépôts personnalisés. Les modules complémentaires de ces référentiels seront ajoutés sur l'onglet Ateliers ou l'onglet Macros.
Choisissez éventuellement les paramètres du proxy.
Appuyez sur le bouton OK ou sur le Annuler pour fermer la boîte de dialogue.

Remarques

L'utilisation des addons n'est pas limitée à la version FreeCAD à partir de laquelle ils ont été installés. Vous pourrez également les utiliser dans n'importe quelle autre version de FreeCAD, prise en charge par l'addon, que vous pourriez avoir sur votre système.
Les modules complémentaires disponibles dans le gestionnaire de modules complémentaires ne font pas partie du programme officiel FreeCAD et ne sont pas pris en charge par l'équipe de développement principale de FreeCAD. Vous devez lire attentivement les informations fournies pour vous assurer que vous savez ce que vous installez.
Les rapports de bogues et les demandes de fonctionnalités doivent être adressés directement au créateur de l'addon en visitant le site Web indiqué. De nombreux développeurs d'extensions sont des utilisateurs réguliers du forum de FreeCAD et peuvent également y être contactés.
Si le package GitPython est installé sur votre ordinateur, le gestionnaire d'extensions s'en servira, ce qui accélérera les téléchargements.
Vous pouvez également installer des modules complémentaires manuellement. Voir Comment installer des ateliers supplémentaires et Comment installer des macros.

Informations pour les développeurs

Si vous avez développé un atelier ou une macro et souhaitez l'inclure dans le gestionnaire des extensions, lisez la procédure à suivre dans les pages des dépôts (FreeCAD-addons et FreeCAD-macros). Si vous ajoutez votre macro à la Liste des macros, il n'y a rien d'autre à faire, elle sera automatiquement sélectionnée par le gestionnaire Addon Manager.

Ateliers Python

Pour les ateliers 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 module d'extension 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 FreeCAD-addons, votre code restera sur votre propre dépôt git, nous l'ajouterons simplement comme un sous-module au dépôt 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 Création d'atelier.

Ateliers 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 les versions pré-compilées de votre atelier pour les différents systèmes d'exploitation, soit vous devez demander à ce que votre code soit fusionné dans le code source de FreeCAD. Pour cela, vous devez utiliser la licence LGPL (ou une licence entièrement compatible comme celle du MIT ou BSD) et présenter vos nouveaux outils à la communauté dans le forum de FreeCAD pour être examiné. Une fois que votre code a été testé et approuvé, vous devez créer une nouvelle branche dans le dépôt FreeCAD, si ce n’est pas encore fait, y insérer votre code et ouvrir une demande de retrait (pull request) afin que votre branche soit fusionnée dans le dépôt principal.

Personnalisation

Menu Outils

Std Base

Fichier : Nouveau, Ouvrir, Fermer, Fermer tout, Enregistrer, Enregistrer sous, Enregistrer une copie, Enregistrer tout, Rétablir, Importer, Exporter, Fusion de projets, Informations sur le projet, Imprimer, Aperçu avant impression, Exporter au format PDF, Fichiers récents, Quitter

Édition : Annuler, Rétablir, Couper, Copier, Coller, Dupliquer la sélection, Rafraîchir, Sélection par boîte, Sélection d'éléments par boîte, Tout sélectionner, Effacer, Vers la console Python, Positionner, Transformer, Aligner, Basculer le mode d'édition, Mode d'édition, Préférences

Affichage :
- Divers : Créer une nouvelle vue, Vue orthographique, Vue en perspective, Plein écran, Boîte englobante, Axes du repère, Plan de coupe, Mappage de texture, Basculer en mode navigation, Apparence, Couleur aléatoire, Atelier, Barre d'état
- Vues standards‏‎ : Tout afficher, Afficher la sélection, Isométrique, Dimétrique, Trimétrique, Accueil, Vue de devant, Vue de dessus, Vue de droite, Vue de l'arrière, Vue de dessous, Vue de gauche, Rotation à gauche, Rotation à droite
- Figer l'affichage : Enregistrer les vues, Charger les vues, Figer l'affichage, Effacer les vues
- Style de représentation : Par défaut, Points, Filaire, Ligne cachée, Pas d'ombrage, Ombré, Filaire ombré
- Stéréo : Stéréo rouge/cyan, Tampon stéréo quadruple, Lignes stéréo entrelacées, Colonnes stéréo entrelacées, Stéréo désactivée, Position de la caméra
- Zoom : Zoom avant, Zoom arrière, Zoom fenêtre
- Fenêtre de document : Dockée, Non dockée, Plein écran
- Visibilité : Basculer la visibilité, Afficher la sélection, Masquer la sélection, Sélectionner les objets visibles, Basculer tous les objets, Afficher tous les objets, Masquer tous les objets, Basculer la sélectivité, Basculer les mesures, Supprimer les mesures
- Barre d'outils : Fichier, Édition, Presse-papiers, Atelier, Macro, Vue, Structure, Aide
- Panneaux : Vue en arborescence, Éditeur de propriétés, Fenêtre de sélection, Panneau des tâches, Console Python, Vue DAG, Vue combinée, Vue rapport
- Navigation par lien : Objet lié, Objet lié le plus profond, Tous les liens
- Actions sur l'arborescence : Synchroniser la vue, Synchroniser la sélection, Synchroniser le placement, Présélection, Enregistrer la sélection, Document unique, Tous les documents, Réduire/développer, Déplacement, Aller à la sélection, Sélection précédente, Sélection suivante

Outils : Éditeur des paramètres, Capture d'écran, Inspecteur du graphe de scène, Graphique de dépendance, Utilitaire de projet, Mesurer une distance, Ajouter un document texte, Vue en rotation, Convertisseur d'unités, Personnaliser, Gestionnaire des extensions

Macro : Enregistrer une macro, Macros…, Macros récentes, Lancer la macro, Débogueur distant, Déboguer la macro, Arrêt du débogage, Passer outre, Rentrer dedans, Basculer le point d'arrêt

Fenêtre : Suivante, Précédente, Mosaïque, Fenêtres en cascade, Fenêtres...

Aide : Aide en ligne, Site web de FreeCAD, Documentation utilisateurs, Documentation pour programmer en Python, Documentation automatique des modules Python, Forum de FreeCAD, FAQ de FreeCAD, Signaler un bogue, À propos de FreeCAD, Qu'est-ce que c'est ?

Structure et Lien : Std Part, Std Groupe, Créer un lien, Créer un sous-lien, Remplacer par un lien, Délier, Importer des liens, Importer tous les liens

Hub utilisateurs

Démarrer avec FreeCAD
Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don

Aide : Tutoriels, Tutoriels vidéo
Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test, Web

Addons : Gestionnaire d'Addons, Ateliers externes, Scripts et macros

Hubs : Hub utilisateurs, Hub utilisateurs expérimentés, Hub Développeurs

@@ Line 2: / Line 2: @@
 {{Docnav/fr
-|[[Std_DlgCustomize/fr|Std Personnalisation]]
+|[[Std_DlgCustomize/fr|Personnalisation]]
 |
 |[[Std_Tools_Menu/fr|Menu Outils]]
@@ Line 12: / Line 12: @@
 {{GuiCommand/fr
 |Name=Std AddonMgr
-|Name/fr=Std Gestionnaire d'extensions
+|Name/fr=Std Gestionnaire d'Addons
-|MenuLocation=Outils → Gestionnaire d'Addon
+|MenuLocation=Outils → Gestionnaire d'Addons
 |Workbenches=Tous
 |Version=0.17
@@ Line 21: / Line 21: @@
 ==Description==
-La commande '''Std AddonMgr''' ouvre le gestionnaire de modules complémentaires. Avec l'Addon Manager, vous pouvez installer et gérer [[external workbenches/fr|ateliers complémentaires]] et des [[macros/fr|macros]] fournis par la communauté FreeCAD. Les ateliers et les macros disponibles proviennent de deux dépôts [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros] et à partir de la page [[Macros_recipes/fr|Liste des macros]].
+La commande '''Gestionnaire d'Addons''' ouvre le gestionnaire de modules complémentaires. Avec le Gestionnaire d'Addons, vous pouvez installer et gérer [[external workbenches/fr|ateliers complémentaires]] et des [[macros/fr|macros]] fournis par la communauté FreeCAD. Les ateliers et les macros disponibles proviennent de deux dépôts [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros] et à partir de la page [[Macros_recipes/fr|Liste des macros]].
+Les addons marqués par {{emphasis|Python 2 uniquement}} ne fonctionneront pas dans FreeCAD version 0.19 ou supérieure.
+En raison des modifications apportées à la plate-forme GitHub en 2020, le gestionnaire de modules complémentaires ne fonctionne plus si vous utilisez des versions de FreeCAD inférieure ou égale à 0.17. Vous devez passer à la version [https://github.com/FreeCAD/FreeCAD/releases/tag/0.18.5 0.18.5] ou à une version récente [https://github.com/FreeCAD/FreeCAD/releases/tag/0.19_pre 0.19]. Vous pouvez également installer les addons manuellement, voir [[#Remarques|Remarques]] ci-dessous.
 [[Image:Std_AddonMgr_dialog.png]]
-{{Caption|Boîte de dialogue du Gestionnaire de modules complémentaires ou Addon Manager}}
+{{Caption|Boîte de dialogue du Gestionnaire d'Addons}}
 ==Utilisation==
-# Sélectionnez l'option {{MenuCommand|Outils → [[Image:Std_AddonMgr.svg|16px]] Addon manager}} dans le menu.
+# Sélectionnez l'option {{MenuCommand|Outils → [[Image:Std_AddonMgr.svg|16px]] Gestionnaire d'Addons}} dans le menu.
-# Si vous utilisez le gestionnaire d'extensions pour la première fois, une boîte de dialogue s'ouvrira pour vous avertir que les extensions du gestionnaire d'extensions ne font pas officiellement partie de FreeCAD. Appuyez sur le bouton {{Button|OK}} pour confirmer et continuer.
+# Si vous utilisez le gestionnaire d'extensions pour la première fois, une boîte de dialogue s'ouvrira pour vous avertir que les extensions du gestionnaire d'Addons ne font pas officiellement partie de FreeCAD. Appuyez sur le bouton {{Button|OK}} pour confirmer et continuer.
-# La boîte de dialogue Gestionnaire de modules complémentaires s'ouvre. Pour plus d'informations, voir [[#Options|Options]].
+# La boîte de dialogue Addons s'ouvre. Pour plus d'informations, voir [[#Options|Options]].
 # Le bouton {{Button|[[Image:Button_valid.svg|16px]] Tout mettre à jour}} ne fonctionne pas pour le moment.
 # Appuyez sur le bouton {{Button|[[Image:Process-stop.svg|16px]] Fermer}} pour fermer la boîte de dialogue.
@@ Line 37: / Line 41: @@
 ==Options==
-La boîte de dialogue Gestionnaire de modules complémentaires comporte deux onglets à gauche, l'un répertoriant les ateliers disponibles et l'autre répertoriant les macros disponibles. Le panneau d'information sur la droite affichera la page d'accueil de l'addon sélectionné.
+La boîte de dialogue Addons comporte deux onglets à gauche, l'un répertoriant les ateliers disponibles et l'autre répertoriant les macros disponibles. Le panneau d'information sur la droite affichera la page d'accueil de l'addon sélectionné.
 === Désinstaller ===
@@ Line 56: / Line 60: @@
 # La boîte de dialogue des options du gestionnaire d'extensions s'ouvre.
 # Cochez éventuellement la case {{CheckBox|TRUE|Rechercher automatiquement les mises à jour au démarrage (nécessite GitPython)}}.
-# Ajoutez éventuellement des référentiels à la liste '' 'Référentiels personnalisés' ''. Les modules complémentaires de ces référentiels seront ajoutés sur l'onglet [[Image:Folder.svg|16px]] '''Ateliers''' ou l'onglet [[Image:Applications-python.svg|16px]] '''Macros'''.
+# Ajoutez éventuellement des dépôts à la liste '''Dépôts personnalisés'''. Les modules complémentaires de ces référentiels seront ajoutés sur l'onglet [[Image:Folder.svg|16px]] '''Ateliers''' ou l'onglet [[Image:Applications-python.svg|16px]] '''Macros'''.
 # Choisissez éventuellement les paramètres du proxy.
 # Appuyez sur le bouton {{Button|OK}} ou sur le {{Button|Annuler}} pour fermer la boîte de dialogue.
@@ Line 62: / Line 66: @@
 ==Remarques==
+* L'utilisation des addons n'est pas limitée à la version FreeCAD à partir de laquelle ils ont été installés. Vous pourrez également les utiliser dans n'importe quelle autre version de FreeCAD, prise en charge par l'addon, que vous pourriez avoir sur votre système.
 * Les modules complémentaires disponibles dans le gestionnaire de modules complémentaires ne font pas partie du programme officiel FreeCAD et ne sont pas pris en charge par l'équipe de développement principale de FreeCAD. Vous devez lire attentivement les informations fournies pour vous assurer que vous savez ce que vous installez.
 * Les rapports de bogues et les demandes de fonctionnalités doivent être adressés directement au créateur de l'addon en visitant le site Web indiqué. De nombreux développeurs d'extensions sont des utilisateurs réguliers du [https://forum.freecadweb.org forum de FreeCAD] et peuvent également y être contactés.
@@ Line 67: / Line 72: @@
 * Vous pouvez également installer des modules complémentaires manuellement. Voir [[How_to_install_additional_workbenches/fr|Comment installer des ateliers supplémentaires]] et [[How_to_install_macros/fr|Comment installer des macros]].
+== Informations pour les développeurs ==
-==Information for developers==
+Si vous avez développé un atelier ou une macro et souhaitez l'inclure dans le gestionnaire des extensions, lisez la procédure à suivre dans les pages des dépôts ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si vous ajoutez votre macro à la [[Macros_recipes/fr|Liste des macros]], il n'y a rien d'autre à faire, elle sera automatiquement sélectionnée par le gestionnaire Addon Manager.
+=== Ateliers Python ===
-<div class="mw-translate-fuzzy">
-Si vous avez développé un atelier ou une macro et souhaitez l'inclure dans le gestionnaire des extensions, lisez la procédure à suivre dans les pages des dépôts ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Si vous ajoutez votre macro aux [[Macros recipes/fr|Recettes macros]], il n'y a rien d'autre à faire, elle sera automatiquement sélectionnée par le gestionnaire Addon Manager.
-</div>
+Pour les ateliers 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 module d'extension 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]].
-===Python workbenches===
+=== Ateliers C++ ===
-<div class="mw-translate-fuzzy">
-Pour les ateliers Python, vous n'avez besoin d'aucune approbation spécifique pour ajouter votre atelier au Addon manager et, étant en dehors du code source de FreeCAD, vous pouvez choisir la licence de votre choix. Si vous demandez l’ajout de votre atelier dans la liste (nous n’ajouterons aucun nouveau atelier sans une demande de ses auteurs), soit en le demandant sur le forum, soit en créant une requête ("issue" en anglais) sur le site [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons], votre code restera sur votre propre dépôt git, nous l'ajouterons simplement en tant que sous-module au dépôt [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons]. Bien sûr, avant d'ajouter votre atelier, nous allons l'examiner et nous assurer qu'il ne pose aucun problème potentiel.
-</div>
+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 les versions pré-compilées de votre atelier pour les différents systèmes d'exploitation, soit vous devez demander à ce que votre code soit fusionné dans le code source de FreeCAD. Pour cela, vous devez utiliser la licence LGPL (ou une licence entièrement compatible comme celle du MIT ou BSD) et présenter vos nouveaux outils à la communauté dans le [https://forum.freecadweb.org forum de FreeCAD] pour être examiné. Une fois que votre code a été testé et approuvé, vous devez créer une nouvelle branche dans le dépôt FreeCAD, si ce n’est pas encore fait, y insérer votre code et ouvrir une demande de retrait (pull request) afin que votre branche soit fusionnée dans le dépôt principal.
-===C++ workbenches===
-<div class="mw-translate-fuzzy">
-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 2 options, soit vous fournissez vous-même les versions pré-compilées de votre atelier pour les différents systèmes d'exploitation, soit vous devez demander à ce que votre code soit fusionné dans le code source de FreeCAD. Pour cela, vous devez utiliser la licence LGPL (ou entièrement compatible, comme MIT ou BSD), et présenter vos nouveaux outils à la communauté dans le [https://forum.freecadweb.org forum de FreeCAD] pour être examiné. Une fois que votre code a été testé et approuvé, vous devez créer une nouvelle branche dans le dépôt FreeCAD, si ce n’est pas encore fait, y insérer votre code et ouvrir une demande de retrait (pull request) afin que votre branche soit fusionnée dans le dépôt principal.
-</div>
 {{Docnav/fr
-|[[Std_DlgCustomize/fr|Std Personnalisation]]
+|[[Std_DlgCustomize/fr|Personnalisation]]
 |
 |[[Std_Tools_Menu/fr|Menu Outils]]