Std AddonMgr/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
|[[Std_DlgCustomize|Std DlgCustomize]]
|
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgCustomize.svg
|IconR=
|IconC=Freecad.svg
⚫
}}

<div class="mw-translate-fuzzy">
{{GuiCommand/fr
{{GuiCommand/fr
|Name=Std AddonMgr
|Name=Std AddonMgr
Line 8: Line 19:
|Version=0.17
|Version=0.17
}}
}}
</div>


<div class="mw-translate-fuzzy">
== Introduction ==
== Introduction ==
</div>


<div class="mw-translate-fuzzy">
Le gestionnaire d'extensions '''Addon manager''' est un outil permettant d'installer et de gérer des [[external workbenches/fr|ateliers complémentaires]] et des [[macros/fr|macros]] fournis par la communauté FreeCAD. Si le paquet [https://github.com/gitpython-developers/GitPython git-python] est installé sur votre ordinateur, le Addon manager l'utilisera pour mettre à jour les ateliers installés, accélérant les téléchargements.
Le gestionnaire d'extensions '''Addon manager''' est un outil permettant d'installer et de gérer des [[external workbenches/fr|ateliers complémentaires]] et des [[macros/fr|macros]] fournis par la communauté FreeCAD. Si le paquet [https://github.com/gitpython-developers/GitPython git-python] est installé sur votre ordinateur, le Addon manager l'utilisera pour mettre à jour les ateliers installés, accélérant les téléchargements.
</div>


[[Image:Std_AddonMgr_dialog.png]]
La liste des ateliers et macros à installer est tirée de deux dépôts, [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] et [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros], respectivement, depuis la page [[Macros recipes/fr|recettes macros]].
<div class="mw-translate-fuzzy">

[[Image:Addon_Manager_example.png]]
[[Image:Addon_Manager_example.png]]
{{Caption|L'interface de [[AddonManager/fr|Addon Manager]]}}
{{Caption|L'interface de [[AddonManager/fr|Addon Manager]]}}
</div>


<div class="mw-translate-fuzzy">
== Utilisation ==
== Utilisation ==
</div>


<div class="mw-translate-fuzzy">
* Ouvrez l'outil via le menu {{MenuCommand|{{StdMenu/fr|Outils}} → Gestionnaire d'Addon}}.
* Ouvrez l'outil via le menu {{MenuCommand|{{StdMenu/fr|Outils}} → Gestionnaire d'Addon}}.
* Pour installer un atelier : faites défiler la liste et sélectionnez l'atelier complémentaire ; une courte description ainsi que sa page d'accueil sera affichée sous la liste. Appuyez sur le bouton {{Button|Install/update}} pour installer l'atelier. Pour installer une macro, cliquez sur l'onglet {{MenuCommand|Macros}} et répétez les étapes ci-dessus.
* Pour installer un atelier : faites défiler la liste et sélectionnez l'atelier complémentaire ; une courte description ainsi que sa page d'accueil sera affichée sous la liste. Appuyez sur le bouton {{Button|Install/update}} pour installer l'atelier. Pour installer une macro, cliquez sur l'onglet {{MenuCommand|Macros}} et répétez les étapes ci-dessus.
Line 29: Line 49:
* Appuyez sur le bouton {{Button|Close}} pour fermer le gestionnaire d'Addon.
* Appuyez sur le bouton {{Button|Close}} pour fermer le gestionnaire d'Addon.
Vous devrez redémarrer FreeCAD avant que de nouveaux ateliers apparaissent dans la liste des ateliers disponibles. Ils sont ajoutés à la fin. Si vous souhaitez les avoir dans l’ordre alphabétique, vous pouvez les réorganiser dans la boîte de dialogue [[Image:Std_DlgCustomize.svg|16px]] [[Std DlgCustomize/fr|Std Personnalisation]].
Vous devrez redémarrer FreeCAD avant que de nouveaux ateliers apparaissent dans la liste des ateliers disponibles. Ils sont ajoutés à la fin. Si vous souhaitez les avoir dans l’ordre alphabétique, vous pouvez les réorganiser dans la boîte de dialogue [[Image:Std_DlgCustomize.svg|16px]] [[Std DlgCustomize/fr|Std Personnalisation]].
</div>


==Options==
=== Installation manuelle ===
Si vous n'utilisez pas l'Addon Manager, vous pouvez installer manuellement de nouveaux outils en plaçant leur code dans le répertoire {{incode|FreeCAD/}} de votre dossier personnel. Voir les liens suivants pour plus de détails:
* [[How to install macros/fr|Comment installer des macros]]
* [[How to install additional workbenches/fr|Comment installer des ateliers supplémentaires]]


The Addon manager dialog box has two tabs on the left, one listing the available workbenches and the other listing the available macros. The information panel on the right will display the homepage of the selected addon.
== Limitations ==


===Uninstall===
* Ces modules complémentaires ne font pas partie du logiciel FreeCAD officiel et ne sont pas pris en charge par l'équipe FreeCAD. Vous devez lire les informations fournies sur chacune des pages complémentaires avant d'en installer une pour vous assurer de savoir ce que vous installez.


# Select an installed addon on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
* Les rapports de bogues et les demandes de fonctionnalités doivent être adressés directement au créateur de l'add-on en visitant le site Web indiqué. De nombreux auteurs de modules complémentaires sont des utilisateurs réguliers du [https://forum.freecadweb.org forum FreeCAD] et peuvent être contactés à cet emplacement.
# Press the {{Button|[[Image:Delete.svg|16px]] Uninstall selected}} button.


===Install/update===
* Les adresses web des dépôts des extensions et macros sont codées en dur dans l'Addon manager. Comme il est écrit en Python, celles-ci pourraient être modifiés par les utilisateurs connaissant Python en éditant les champs appropriés dans


# Select an addon on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
:{{Code|code=
# Press the {{Button|[[Image:Edit_OK.svg|16px]] Install/update selected}} button.
$ROOT/Mod/AddonManager/AddonManager.py
# 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#Toolbars|Interface Customization]].
⚫
}}
# To change the position of an addon workbench in the [[Std_Workbench|Workbench selector]] list see [[Interface_Customization#Workbenches|Interface Customization]].


===Configuration===
: où {{incode|$ROOT}} est le répertoire d'installation de FreeCAD dans votre système particulier, par exemple,
:* Linux: {{incode|/usr/lib/freecad/Mod/AddonManager/AddonManager.py}}
:* Windows: {{Incode|C:\Program Files\FreeCAD version\Mod\AddonManager.py}}


# Press the {{Button|[[Image:Preferences-general.svg|16px]] Configure...}} button.
== Nouveaux ateliers et macros ==
# The Addon manager options dialog box opens.
# Optionally check the {{CheckBox|TRUE|Automatically check for updates at start (requires GitPython)}} checkbox.
# Optionally add repositories to the '''Custom repositories''' list. Addons from these repositories will be added on the [[Image:Folder.svg|16px]] '''Workbenches''' tab or the [[Image:Applications-python.svg|16px]] '''Macros''' tab.
# Optionally choose proxy settings.
# Press the {{Button|OK}} button or the {{Button|Cancel}} button to close the dialog box.


==Notes==
⚫
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.


* 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.
⚫
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.
* 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 [https://forum.freecadweb.org FreeCAD forum], and can also be contacted there.
* If the [https://github.com/gitpython-developers/GitPython 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|How to install additional workbenches]] and [[How_to_install_macros|How to install macros]].


==Information for developers==
⚫
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 class="mw-translate-fuzzy">
== Test de AddonManager ==
⚫
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.
{{VeryImportantMessage|Cette section est destinée aux développeurs}}
</div>
Le gestionnaire d’addons étant codé en Python, il est possible de modifier le code source sans le compiler. Plus spécifiquement, le test nécessite de modifier le code dans {{incode|FreeCAD/src/Mod/AddonManager}} et de simplement ré-exécuter FreeCAD.


===Python workbenches===
Pour tester la capacité de téléchargement du gestionnaire d’addons, vous pouvez simuler la nécessité de télécharger, par exemple une version précédente d’un plan de travail via l’interface de ligne de commande. Dans l'exemple suivant, nous allons utiliser Assembly2 + Workbench (ou [[A2plus_Workbench|A2plus]] en abrégé):


<div class="mw-translate-fuzzy">
{{Code|code=
⚫
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.
cd ~/FreeCAD/Mod/A2plus/
</div>
git reset --hard "v0.4.21"
⚫
}}


===C++ workbenches===
La sortie de l'interface de ligne de commande doit indiquer '''HEAD est maintenant à b2c53a4 Demande de fusion #281 de kbwbe/devel'''


<div class="mw-translate-fuzzy">
Nous avons essentiellement utilisé une balise de la version précédente pour réinitialiser cette version.
⚫
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.
Maintenant, dans le gestionnaire d’addon, actualisez la liste des ateliers et il s'affiche que l’atelier A2plus utilise une version inférieure.
</div>


{{clear}}
{{Docnav
|[[Std_DlgCustomize|Std DlgCustomize]]
|
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgCustomize.svg
|IconR=
|IconC=Freecad.svg
⚫
}}


{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}

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

[[Category:Addons{{#translation:}}]]

Revision as of 20:01, 6 May 2020

Other languages:

Std Gestionnaire d'extensions

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

Introduction

Le gestionnaire d'extensions Addon manager est un outil permettant d'installer et de gérer des ateliers complémentaires et des macros fournis par la communauté FreeCAD. Si le paquet git-python est installé sur votre ordinateur, le Addon manager l'utilisera pour mettre à jour les ateliers installés, accélérant les téléchargements.

File:Std AddonMgr dialog.png

L'interface de Addon Manager

Utilisation

  • Ouvrez l'outil via le menu Template:StdMenu/fr → Gestionnaire d'Addon.
  • Pour installer un atelier : faites défiler la liste et sélectionnez l'atelier complémentaire ; une courte description ainsi que sa page d'accueil sera affichée sous la liste. Appuyez sur le bouton Install/update pour installer l'atelier. Pour installer une macro, cliquez sur l'onglet Macros et répétez les étapes ci-dessus.
  • Pour supprimer un atelier ou une macro : faites défiler la liste, sélectionnez le greffon puis appuyez sur le bouton Remove.
  • Pour mettre à jour un atelier ou une macro : faites défiler la liste, sélectionnez le greffon puis appuyez sur le bouton Install/update.
  • Pour vérifier les mises à jour : appuyez sur le bouton Refresh; les mises à jour disponibles seront signalées sous la liste. Appuyez à nouveau sur le bouton Refresh pour installer toutes les mises à jour en même temps.

Remarque l'icône pourrait être différente en fonction de votre système d'exploitation.

  • Pour exécuter une macro : installez d'abord la macro désirée, puis sélectionnez-la à nouveau dans la liste, et appuyez sur le bouton Execute. La macro est automatiquement éditée dans l'éditeur de macros de FreeCAD, pour visualise le code.
  • Appuyez sur le bouton Close pour fermer le gestionnaire d'Addon.

Vous devrez redémarrer FreeCAD avant que de nouveaux ateliers apparaissent dans la liste des ateliers disponibles. Ils sont ajoutés à la fin. Si vous souhaitez les avoir dans l’ordre alphabétique, vous pouvez les réorganiser dans la boîte de dialogue Std Personnalisation.

Options

The Addon manager dialog box has two tabs on the left, one listing the available workbenches and the other listing the available macros. The information panel on the right will display the homepage of the selected addon.

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.

Std Base
Hub utilisateurs
Retrieved from "http://wiki.freecad.org/index.php?title=Std_AddonMgr/fr&oldid=677376"