Std AddonMgr/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 21: Line 21:
==Description==
==Description==


<div class="mw-translate-fuzzy">
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]].
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]].
</div>


<div class="mw-translate-fuzzy">
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.
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.
</div>

[[Image:Std_AddonMgr_dialog.png]]
{{Caption|Boîte de dialogue du Gestionnaire d'Addons}}


==Utilisation==
==Utilisation==


<div class="mw-translate-fuzzy">
# Sélectionnez l'option {{MenuCommand|Outils → [[Image:Std_AddonMgr.svg|16px]] Gestionnaire d'Addons}} 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'Addons 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.
Line 38: Line 38:
# Appuyez sur le bouton {{Button|[[Image:Process-stop.svg|16px]] Fermer}} pour fermer la boîte de dialogue.
# Appuyez sur le bouton {{Button|[[Image:Process-stop.svg|16px]] 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.
# 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.
</div>


==Options==
==Options==


[[File:AddonManager_Main.png|600px]]
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é.


# The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
=== Désinstaller ===
# Three different types of addons are supported: [[external_workbenches|workbenches]], [[macros|macros]], and [[Preference_Packs|preference packs]]. You can choose to show just one type, or all of them in a single list.
# The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
# The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
# The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a [[Package_Metadata|package metadata]] file (or for macros with embedded metadata).
# Addon data is cached locally, with a variable cache update frequency set in the user preferences.
# At any time you can choose to manually update your local cache to see the latest updates available for each addon.
# Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.


Clicking on an addon in this view brings up the addon's Details page:
# Sélectionnez un module complémentaire installé dans l'onglet [[Image:Folder.svg|16px]] '''Ateliers''' ou dans l'onglet [[Image:Applications-python.svg|16px]] '''Macros'''.
# Appuyez sur le bouton {{Button|[[Image:Delete.svg|16px]] Désinstaller la sélection}}.


[[File:AddonManager_Details.png|600px]]
=== Installer/mettre à jour ===


The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).
# Sélectionnez un module complémentaire dans l'onglet [[Image:Folder.svg|16px]] '''Ateliers''' ou dans l'onglet [[Image:Applications-python.svg|16px]] '''Macros'''.
# Appuyez sur le bouton {{Button|[[Image:Edit_OK.svg|16px]] 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 [[Interface_Customization/fr#Barre_d.27outils|Personnalisation de l'interface]].
# Pour modifier la position d'un atelier complémentaire dans la liste des [[Std_Workbench/fr|Ateliers]], voir [[Interface_Customization/fr#Ateliers|Personnalisation de l'interface]].


==Preferences==
=== Configuration ===


The preferences for the Addon manager can be found in the [[Preferences_Editor#Addon_Manager|Preferences Editor]]. {{Version|0.20}}
# Appuyez sur le bouton {{Button|[[Image:Preferences-general.svg|16px]] Configurer...}}.
# 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 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.


==Remarques==
==Remarques==


<div class="mw-translate-fuzzy">
* 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.
* 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 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.
Line 71: Line 71:
* Si le package [https://github.com/gitpython-developers/GitPython GitPython] est installé sur votre ordinateur, le gestionnaire d'extensions s'en servira, ce qui accélérera les téléchargements.
* Si le package [https://github.com/gitpython-developers/GitPython 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 [[How_to_install_additional_workbenches/fr|Comment installer des ateliers supplémentaires]] et [[How_to_install_macros/fr|Comment installer des macros]].
* 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]].
</div>


== Informations pour les développeurs ==
== Informations pour les développeurs ==


See [[Addon#Information_for_developers|Addon]].
Si vous avez développé un atelier ou une macro et souhaitez l'inclure dans le gestionnaire des Addons, 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.

=== Ateliers en 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 [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 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 [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.




Line 96: Line 89:
{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 08:43, 9 September 2022

Std Gestionnaire d'Addons

Emplacement du menu
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.

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.

Utilisation

  1. Sélectionnez l'option Outils → Gestionnaire d'Addons 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'Addons ne font pas officiellement partie de FreeCAD. Appuyez sur le bouton OK pour confirmer et continuer.
  3. La boîte de dialogue Addons 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

  1. The Addon manager provides two view layouts: "Condensed" and "Expanded". In "Condensed" view, each addon takes a single line, and its description is truncated to fit the available space. "Expanded" shows additional details, including more of the description text as well as maintainer information, more installation details, etc.
  2. Three different types of addons are supported: workbenches, macros, and preference packs. You can choose to show just one type, or all of them in a single list.
  3. The list can be limited to show just installed packages, just packages with available updates, or just packages that are not yet installed.
  4. The list can be filtered, searching for a keyword in the title, description, and tags (description and tags must be specified by the addon developer in their addon's metadata). The filter can even be a regular expression, for fine-grained control of the exact search term.
  5. The expanded view shows available version information, description, maintainer information, and installation version information, for packages that provide a package metadata file (or for macros with embedded metadata).
  6. Addon data is cached locally, with a variable cache update frequency set in the user preferences.
  7. At any time you can choose to manually update your local cache to see the latest updates available for each addon.
  8. Update checks may be set up to be automatic, or done manually via a button click (configured in user preferences). If GitPython and git are installed on your system then update information is fetched using git. If not, then update information is obtained from any present metadata file.

Clicking on an addon in this view brings up the addon's Details page:

The details page shows buttons allowing installing, uninstalling, updating, and temporarily disabling an addon. For installed addons it lists the currently installed version and the installation date, and whether that is the most recent version available. Below is an embedded web browser window showing the addon's README page (for workbenches and preference packs), or Wiki page (for macros).

Preferences

The preferences for the Addon manager can be found in the Preferences Editor. introduced in version 0.20

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

See Addon.