How to install additional workbenches/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
 
(98 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{TutorialInfo/fr|Topic=Programming|Level=Medium programmer|Time=15 minutes|FCVersion=All|Author=[[User:R-Frank|r-frank]]}}
{{TutorialInfo/fr
|Topic=Programmation
|Level=Programmeur moyen
|Time=15 minutes
|FCVersion=Toutes versions
|Author=[[User:R-Frank|r-frank]]
|Files=aucun
}}


==Description==
==Description==
Des utilisateurs avancés ont étendu les fonctionnalités de FreeCAD avec divers ateliers (workbenches) personnalisés, qui ne sont pas (encore !) intégrés dans le code source FreeCAD,
mais ces ateliers sont facilement installables dans une installation FreeCAD existante. Ici, nous allons découvrir diverses méthodes d'installation pour les différents systèmes d'exploitation.


Les utilisateurs expérimentés enrichissent FreeCAD avec divers [[external_workbenches/fr|ateliers externes]] qui ne sont pas intégrés au code source de base mais qui sont faciles à installer à une distribution FreeCAD existante. Nous allons couvrir ici les méthodes d'installation pour les différents systèmes d'exploitation.
'''Remarque''': à partir de la version 0.17, FreeCAD propose un menu de gestion des addons dans le menu Outils qui permet d'installer facilement une série d'ateliers externes. Les instructions ci-dessous ne sont nécessaires que si vous utilisez une version antérieure ou si vous souhaitez installer un atelier ne figurant pas dans la liste proposée par le gestionnaire de modules complémentaires.


{{Emphasis|Remarque :}} à partir de la version 0.17, FreeCAD propose un [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|gestionnaire des extensions]] dans le menu {{MenuCommand|Outils → Gestionnaire des extensions}}. Il permet d'installer à la fois des macros et des ateliers. Les instructions ci-dessous ne sont nécessaires que si vous souhaitez installer manuellement un atelier. Cela peut être nécessaire si, pour une raison quelconque, le Gestionnaire des extensions ne fonctionne pas mais que vous avez accès à l'atelier téléchargé en tant que package {{FileName|.zip}}.
==Installation dans Windows==


<div class="mw-collapsible mw-collapsed toccolours">
'''Méthode d'installation recommandée'''


<span id="Installing_on_Windows"></span>
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Addon Manager|Addon Manager]] in all systems is the recommended way.
==Installation sous Windows==


Comment installer des ateliers et des extensions supplémentaires sous Windows
Utilisez [https://github.com/FreeCAD/FreeCAD-addons addons-installer from Github].
<div class="mw-collapsible-content">


<span id="Manual_Install"></span>
During Google Summer of Code 2016 student Mandeep Singh started work on an improved version ([https://github.com/mandeeps708/PluginManager available here]) but that version needs further work before it can be fully integrated in FreeCAD.
=== Installation manuelle ===


{{Emphasis|Remarque :}} cette méthode est possible mais pas nécessaire avec l'introduction du [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|gestionnaire des extensions]]. Néanmoins les informations ici peuvent encore être utiles à certains.
'''Méthode d'installation alternative “installation manuelle”'''


*téléchargez l'atelier sur github en cliquant sur le bouton “clone or download” dans la page github (coins droit supérieur) et choisissez "Download ZIP"
* Téléchargez l'atelier depuis github en cliquant sur le bouton {{Button|Clone}} ou {{Button|Download}} sur la page github (coin supérieur droit) et en choisissant "Download ZIP"
*dézippez l'archive téléchargée sur votre disque dur
* Dézippez l'archive téléchargée sur votre disque dur local
*dans FreeCAD, localisez le chemin des macros et choisissant “Edition > Préférences > Général > Macro” et localisez ”le chemin des macros”
* Dans FreeCAD, localisez le chemin de la macro en choisissant {{MenuCommand|Édition Préférences Python Macro}} et cherchez "Chemin de la macro".
*supposed your Windows-Login is “User-Name” the default macro path is “C:\Users\User-Name\AppData\Roaming\FreeCAD\”
* Supposons que votre connexion Windows est "''nom_utilisateur''", le chemin par défaut de la macro est {{FileName|%APPDATA%\FreeCAD\}} qui est couramment {{FileName|C:\Users\''nom_utilisateur''\Appdata\Roaming\FreeCAD}}
*dans le répertoire des macros, créez (s'il n'est pas déjà présent) un répertoire nommé “Mod”
* Dans le répertoire macro, créez (s'il n'est pas déjà présent) un dossier appelé "{{FileName|Mod}}"
*dans le répertoire Mod créez un répertoire nommé avec le nom de l'atelier téléchargé, par exemple “Assembly2”
* Dans le dossier Mod, créez un dossier avec le nom de l'atelier, par exemple “Curves”
* Déplacez maintenant les fichiers et sous-dossiers décompressés de l'atelier dans le dossier de l'atelier qui vient d'être créé.
*maintenant déplacez le contenu di fichier dézippé dans le répertoire nouvellement créé (ici Assembly2)
* Après le redémarrage de FreeCAD, vous devriez maintenant avoir une entrée dans le [[Std_Workbench/fr|sélecteur d'atelier]]
*après avoir redémarrer FreeCAD cliquez sur la boite déroulante d'ateliers et sélectionnez votre atelier


'''Recommandations pour mettre à jour un atelier additionnel'''
'''Recommandation supplémentaire pour la mise à jour des ateliers'''


Sous Windows, lors de la mise à jour d'un atelier déjà installé, Windows conserve les anciens fichiers .py converti en .pyc. Étant donné que cela peut entraîner des problèmes de compatibilité, il est recommandé de désinstaller l'atelier, de redémarrer FreeCAD et d'installer la nouvelle version de cet atelier.
<div class="mw-translate-fuzzy">
</div> <!-- END of Windows section collapsible div. Please do not remove --->
Sur Windows, lors de la mise à jour d'un atelier déjà installé, Windows conserve les anciens fichiers .py converti en .pyc. <br />
</div> <!-- END of Windows section collapsible div. Please do not remove --->
Étant donné que cela peut entraîner des problèmes de compatibilité, il est recommandé de désinstaller l'atelier, de redémarrer FreeCAD et d'installer la nouvelle version de cet atelier.
</div>


<div class="mw-collapsible mw-collapsed toccolours">
==Installation dans Linux (Ubuntu/Mint)==


<span id="Installing_on_Linux"></span>
'''Méthode d'installation recommandée'''
== Installation sous Linux ==


Comment installer des ateliers et des extensions supplémentaires sous Linux
Ajoutez [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] dans ppa-manager.<br />
<div class="mw-collapsible-content">
Installez l'atelier via synaptic packet manager.


<span id="Using_git"></span>
'''Méthode d'installation alternative “Installation via Git”'''
=== Utiliser git ===

Ajoutez [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] dans le gestionnaire ppa.<br/>
Installez les ateliers via Synaptic Packet Manager.


{{Code|code=
{{Code|code=
Line 49: Line 62:
$ mkdir ~/.FreeCAD/Mod
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone https://github.com/hamish2014/FreeCAD_assembly2.git
$ git clone https://github.com/tomate44/CurvesWB.git
}}
}}


Vous possédez maintenant un nouveau atelier dans FreeCAD appelé "Assembly 2". Après l'installation, utilisez git pour faire les mises à jours des dernières versions en utilisant BASH
Dans FreeCAD, vous aurez maintenant un nouvel atelier appelé "CurvesWB". Une fois installé, utilisez git pour les mises à jour :


{{Code|code=
{{Code|code=
$ cd ~/.FreeCAD/Mod/FreeCAD_assembly2
$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ git pull
$ rm *.pyc
$ rm *.pyc
}}
}}


<span id="Manual_Installation"></span>
'''Méthode d'installation alternative “installation manuelle”'''
===Installation manuelle===


{{Emphasis|Remarque :}} cette méthode est possible mais pas nécessaire avec l'introduction du [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|gestionnaire des extensions]]. Néanmoins les informations ici peuvent encore être utiles à certains.
*téléchargez l'atelier sur github en cliquant sur le bouton “clone or download” dans la page github (coins droit supérieur) et choisissez "Download ZIP"
*dézippez l'archive téléchargée sur votre disque dur
*dans FreeCAD, localisez le chemin des macros et choisissant “Edition > Préférences > Général > Macro” et localisez ”le chemin des macros”
*par défaut, le répertoire des macros (caché) est "/.FreeCAD" dans votre bureau
*dans le répertoire des macros, créez (s'il n'est pas déjà présent) un répertoire nommé “Mod”
*dans le répertoire Mod créez un répertoire nommé avec le nom de l'atelier téléchargé, par exemple “Assembly2”
*maintenant déplacez le contenu di fichier dézippé dans le répertoire nouvellement créé (ici Assembly2)
*après avoir redémarrer FreeCAD cliquez sur la boite déroulante d'ateliers et sélectionnez votre atelier


* Téléchargez l'atelier à partir de github en cliquant sur le bouton {{Button|Clone}} ou {{Button|Download}} sur la page github (coin supérieur droit) et en choisissant "Download ZIP"
==Installation sur Mac==
* Dézippez l'archive téléchargée sur votre disque dur local
* Dans FreeCAD, localisez le chemin de la macro en choisissant {{MenuCommand|Édition → Préférences → Python → Macro}} et cherchez "Chemin de la macro"
* Par défaut, le répertoire des macros est le répertoire {{MenuCommand|./.FreeCAD/}} (masqué) de votre répertoire personnel
* Dans le répertoire macro, créez (s'il n'est pas déjà présent) un dossier appelé “{{FileName|Mod}}”
* Dans le dossier Mod/, créez un dossier avec le nom de l'atelier, par exemple “Curves”
* Déplacez maintenant les fichiers et sous-dossiers décompressés du plan de travail dans le dossier de l'atelier qui vient d'être créé.
* Après le redémarrage de FreeCAD, vous devriez maintenant avoir une entrée dans le [[Std_Workbench/fr|sélecteur d'atelier]]


</div> <!-- END of Windows section collapsible div. Please do not remove --->
'''Méthode d'installation recommandée'''
</div> <!-- END of Windows section collapsible div. Please do not remove --->


<div class="mw-collapsible mw-collapsed toccolours">
==Installation sur Mac==


Comment installer des ateliers et des extensions supplémentaires sous macOS
''Méthode d'installation alternative''' cet exemple décri la procédure à suivre avec l'atelier '''assembly'''
<div class="mw-collapsible-content">
*téléchargez le fichier zip dans le dépôt git
**(Windows) assurez vous que FreeCAD est installé dans "/Programme (ou Programme file (x86) ) /FreeCAD v0.15''' puis allez dans "C:\Users\nom utilisateur\AppData\Roaming\FreeCAD\Mod"
**(Linux) assurez vous que FreeCAD est installé dans "/Applications/FreeCAD/v0.15", puis allez dans "/Applications/FreeCAD/v0.15" dans votre explorateur, sélectionnez FreeCAD.app
*faites clic droit dans le répertoire et créez un dossier "assembly2"
*dézippez le le fichier .zip téléchargé dans le dossier "assembly2"


<span id="Manual_Installation"></span>
===Installation manuelle===


{{Emphasis|Remarque :}} cette méthode est possible mais pas nécessaire avec l'introduction du [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/fr|gestionnaire des extensions]]. Néanmoins les informations ici peuvent encore être utiles à certains.
Copier ou décompressez drawing dimensioning dans le dossier '''FreeCAD.app/Contents/Mod''' où FreeCAD est installé.


Dans le cadre de cet exemple, disons que vous avez choisi l'l'[[Curves_Workbench/fr|atelier Curves]] comme atelier externe à installer :
* Choisissez et téléchargez le dépôt git de l'atelier externe de votre choix sous forme de fichier ZIP.
* Il existe deux emplacements possibles pour votre extension "Mods" :
# Tous les utilisateurs : {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}.
# Utilisateur en cours uniquement : {{FileName|/Users/myusername/Library/Application Support/FreeCAD/Mod}}.
* Si vous utilisez Finder pour naviguer manuellement vers l'emplacement All Users dans Applications, vous devrez
** aller dans {{FileName|/Applications}}" et sélectionner FreeCAD.app
** Cliquez avec le bouton droit de la souris et sélectionnez "Show Package Contents", une nouvelle fenêtre apparaîtra avec un dossier nommé "Contents".
** Un seul clic sur le dossier "Contents" puis sur "Resources" et un double-clic pour ouvrir le dossier "Mod".
* Une fois que vous êtes dans le dossier "Mod" que vous voulez utiliser, créez un nouveau dossier nommé "Curves".
* Dézippez le dépôt téléchargé dans le dossier "Mod/Curves".
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->

<span id="General_troubleshooting"></span>
==Dysfonctionnement généralités==
==Dysfonctionnement généralités==


*N'utilisez pas de caractères spéciaux (par exemple: accentués, tréma...) dans votre nom utilisateur, sinon FreeCAD risque de ne pas reconnaître le juste chemin des macros
* N'utilisez pas de caractères spéciaux (par exemple des trémas allemands) dans votre nom d'utilisateur Windows, sinon FreeCAD ne reconnaîtra pas les fichiers et dossiers dans le chemin de la macro.
*Si vous possédez un nom d'utilisateur de ce type, changez votre nom d'utilisateur sans accentués et autres caractères spéciaux
* Si vous avez déjà configuré un nom d'utilisateur avec des caractères spéciaux, créez un nouveau nom d'utilisateur ou pointez le chemin de la macro vers un répertoire n'utilisant pas de caractères spéciaux.
* Allez dans {{MenuCommand|Édition → Préférences → Ateliers}} et assurez-vous que l'atelier n'est pas défini comme invisible.
*Vous ne voyez pas d'atelier dans la barre déroulante ? Sur la barre d'outil de FreeCAD, faites clic droit de la souris '''Personnaliser... > Atelier''' et assurez-vous qu'il soit présent dans la fenêtre de droite (ou Outils > Personnaliser... > Ateliers)
* '''Notes pour les utilisateurs avec un système 32 bits et FreeCAD 0.16.6706'''. Après l'installation, les nouveaux ateliers peuvent ne pas être disponibles. Dans ce cas
* Avec les systèmes 32 bits et FreeCAD 0.16.6706, après les tentatives d'installation, les ateliers supplémentaires peuvent ne pas être disponibles. Dans ce cas
** ouvrez la Vue Rapport pendant le démarrage de FreeCAD et lisez l'erreur affichée
** gardez la [[Report_view/fr|vue rapport]] ouverte lors du démarrage de FreeCAD et lisez l'erreur,
** voir la discussion sur le forum: http://forum.freecadweb.org/viewtopic.php?t=12839#p102933
** voir ce fil de discussion du forum [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 dans la version : 0.16.5602 (Git)]


{{Userdocnavi{{#translation:}}}}
{{Powerdocnavi{{#translation:}}}}
[[Category:External Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Latest revision as of 09:09, 10 August 2023

Tutoriel
Thème
Programmation
Niveau
Programmeur moyen
Temps d'exécution estimé
15 minutes
Auteurs
r-frank
Version de FreeCAD
Toutes versions
Fichiers exemples
aucun
Voir aussi
None

Description

Les utilisateurs expérimentés enrichissent FreeCAD avec divers ateliers externes qui ne sont pas intégrés au code source de base mais qui sont faciles à installer à une distribution FreeCAD existante. Nous allons couvrir ici les méthodes d'installation pour les différents systèmes d'exploitation.

Remarque : à partir de la version 0.17, FreeCAD propose un gestionnaire des extensions dans le menu Outils → Gestionnaire des extensions. Il permet d'installer à la fois des macros et des ateliers. Les instructions ci-dessous ne sont nécessaires que si vous souhaitez installer manuellement un atelier. Cela peut être nécessaire si, pour une raison quelconque, le Gestionnaire des extensions ne fonctionne pas mais que vous avez accès à l'atelier téléchargé en tant que package .zip.

Installation sous Windows

Comment installer des ateliers et des extensions supplémentaires sous Windows

Installation manuelle

Remarque : cette méthode est possible mais pas nécessaire avec l'introduction du gestionnaire des extensions. Néanmoins les informations ici peuvent encore être utiles à certains.

  • Téléchargez l'atelier depuis github en cliquant sur le bouton Clone ou Download sur la page github (coin supérieur droit) et en choisissant "Download ZIP"
  • Dézippez l'archive téléchargée sur votre disque dur local
  • Dans FreeCAD, localisez le chemin de la macro en choisissant Édition → Préférences → Python → Macro et cherchez "Chemin de la macro".
  • Supposons que votre connexion Windows est "nom_utilisateur", le chemin par défaut de la macro est %APPDATA%\FreeCAD\ qui est couramment C:\Users\nom_utilisateur\Appdata\Roaming\FreeCAD
  • Dans le répertoire macro, créez (s'il n'est pas déjà présent) un dossier appelé "Mod"
  • Dans le dossier Mod, créez un dossier avec le nom de l'atelier, par exemple “Curves”
  • Déplacez maintenant les fichiers et sous-dossiers décompressés de l'atelier dans le dossier de l'atelier qui vient d'être créé.
  • Après le redémarrage de FreeCAD, vous devriez maintenant avoir une entrée dans le sélecteur d'atelier

Recommandation supplémentaire pour la mise à jour des ateliers

Sous Windows, lors de la mise à jour d'un atelier déjà installé, Windows conserve les anciens fichiers .py converti en .pyc. Étant donné que cela peut entraîner des problèmes de compatibilité, il est recommandé de désinstaller l'atelier, de redémarrer FreeCAD et d'installer la nouvelle version de cet atelier.

Installation sous Linux

Comment installer des ateliers et des extensions supplémentaires sous Linux

Utiliser git

Ajoutez community-ppa dans le gestionnaire ppa.
Installez les ateliers via Synaptic Packet Manager.

$ sudo apt-get install git python-numpy python-pyside
$ mkdir ~/.FreeCAD/Mod
$ cd ~/.FreeCAD/Mod
$ git clone  https://github.com/tomate44/CurvesWB.git

Dans FreeCAD, vous aurez maintenant un nouvel atelier appelé "CurvesWB". Une fois installé, utilisez git pour les mises à jour :

$ cd ~/.FreeCAD/Mod/CurvesWB
$ git pull
$ rm *.pyc

Installation manuelle

Remarque : cette méthode est possible mais pas nécessaire avec l'introduction du gestionnaire des extensions. Néanmoins les informations ici peuvent encore être utiles à certains.

  • Téléchargez l'atelier à partir de github en cliquant sur le bouton Clone ou Download sur la page github (coin supérieur droit) et en choisissant "Download ZIP"
  • Dézippez l'archive téléchargée sur votre disque dur local
  • Dans FreeCAD, localisez le chemin de la macro en choisissant Édition → Préférences → Python → Macro et cherchez "Chemin de la macro"
  • Par défaut, le répertoire des macros est le répertoire ./.FreeCAD/ (masqué) de votre répertoire personnel
  • Dans le répertoire macro, créez (s'il n'est pas déjà présent) un dossier appelé “Mod
  • Dans le dossier Mod/, créez un dossier avec le nom de l'atelier, par exemple “Curves”
  • Déplacez maintenant les fichiers et sous-dossiers décompressés du plan de travail dans le dossier de l'atelier qui vient d'être créé.
  • Après le redémarrage de FreeCAD, vous devriez maintenant avoir une entrée dans le sélecteur d'atelier

Installation sur Mac

Comment installer des ateliers et des extensions supplémentaires sous macOS

Installation manuelle

Remarque : cette méthode est possible mais pas nécessaire avec l'introduction du gestionnaire des extensions. Néanmoins les informations ici peuvent encore être utiles à certains.

Dans le cadre de cet exemple, disons que vous avez choisi l'l'atelier Curves comme atelier externe à installer :

  • Choisissez et téléchargez le dépôt git de l'atelier externe de votre choix sous forme de fichier ZIP.
  • Il existe deux emplacements possibles pour votre extension "Mods" :
  1. Tous les utilisateurs : /Applications/FreeCAD.app/Contents/Resources/Mod.
  2. Utilisateur en cours uniquement : /Users/myusername/Library/Application Support/FreeCAD/Mod.
  • Si vous utilisez Finder pour naviguer manuellement vers l'emplacement All Users dans Applications, vous devrez
    • aller dans /Applications" et sélectionner FreeCAD.app
    • Cliquez avec le bouton droit de la souris et sélectionnez "Show Package Contents", une nouvelle fenêtre apparaîtra avec un dossier nommé "Contents".
    • Un seul clic sur le dossier "Contents" puis sur "Resources" et un double-clic pour ouvrir le dossier "Mod".
  • Une fois que vous êtes dans le dossier "Mod" que vous voulez utiliser, créez un nouveau dossier nommé "Curves".
  • Dézippez le dépôt téléchargé dans le dossier "Mod/Curves".

Dysfonctionnement généralités

  • N'utilisez pas de caractères spéciaux (par exemple des trémas allemands) dans votre nom d'utilisateur Windows, sinon FreeCAD ne reconnaîtra pas les fichiers et dossiers dans le chemin de la macro.
  • Si vous avez déjà configuré un nom d'utilisateur avec des caractères spéciaux, créez un nouveau nom d'utilisateur ou pointez le chemin de la macro vers un répertoire n'utilisant pas de caractères spéciaux.
  • Allez dans Édition → Préférences → Ateliers et assurez-vous que l'atelier n'est pas défini comme invisible.
  • Avec les systèmes 32 bits et FreeCAD 0.16.6706, après les tentatives d'installation, les ateliers supplémentaires peuvent ne pas être disponibles. Dans ce cas