Std Gestionnaire des extensions

From FreeCAD Documentation
Revision as of 10:51, 8 May 2020 by David69 (talk | contribs) (Created page with "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...")

Std Gestionnaire d'extensions

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

Description

La commande Std AddonMgr ouvre le gestionnaire de modules complémentaires. Avec l'Addon Manager, 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.

File:Std AddonMgr dialog.png

Boîte de dialogue du Gestionnaire de modules complémentaires ou Addon Manager

Utilisation

  1. Sélectionnez l'option Outils → Addon manager dans le menu.
  2. 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 OK pour confirmer et continuer.
  3. La boîte de dialogue Gestionnaire de modules complémentaires s'ouvre. Pour plus d'informations, voir Options.
  4. Le bouton Tout mettre à jour ne fonctionne pas pour le moment.
  5. Appuyez sur le bouton Fermer pour fermer la boîte de dialogue.
  6. 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 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é.

Uninstall

  1. Select an installed addon on the Workbenches tab or the Macros tab.
  2. Press the Uninstall selected button.

Install/update

  1. Select an addon on the Workbenches tab or the Macros tab.
  2. Press the Install/update selected button.
  3. If you want to add a macro to a custom toolbar then don't forget to manually download the icon image file, if available, by clicking on the link on the homepage in the information panel. See Interface Customization.
  4. To change the position of an addon workbench in the Workbench selector list see Interface Customization.

Configuration

  1. Press the Configure... button.
  2. The Addon manager options dialog box opens.
  3. Optionally check the Automatically check for updates at start (requires GitPython) checkbox.
  4. Optionally add repositories to the Custom repositories list. Addons from these repositories will be added on the Workbenches tab or the Macros tab.
  5. Optionally choose proxy settings.
  6. Press the OK button or the Cancel button to close the dialog box.

Notes

  • The addons available in the Addon manager are not part of the official FreeCAD program and are not supported by the core FreeCAD development team. You should read the provided information carefully to make sure you know what you are installing.
  • Bug reports and feature requests should be made directly to the creator of the addon by visiting the indicated website. Many addon developers are regular users of the FreeCAD forum, and can also be contacted there.
  • If the GitPython package is installed on your computer the Addon manager will make use of it, making downloads faster.
  • You can also install addons manually. See How to install additional workbenches and How to install macros.

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 (FreeCAD-addons et FreeCAD-macros). Si vous ajoutez votre macro aux Recettes macros, il n'y a rien d'autre à faire, elle sera automatiquement sélectionnée par le gestionnaire Addon Manager.

Python workbenches

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 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 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.

C++ workbenches

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 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.