Comment installer des ateliers supplémentaires

From FreeCAD Documentation
Revision as of 09:40, 22 April 2020 by Gnrc (talk | contribs)
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

Des utilisateurs avancés ont étendu les fonctionnalités de FreeCAD avec divers ateliers (workbenches) externes personnalisés, qui ne sont pas intégrés dans le code source principal de 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.

Remarque: à partir de la version 0.17, FreeCAD propose un menu de Gestionnaire des addons depuis le menu Outils → Gestionnaire d'Addon 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 des addons.

Installation sous Windows

Comment installer des ateliers et des modules complémentaires supplémentaires sous Windows

Installation recommandée

L'installation recommandée utilise le Outils → Gestionnaire des addons.

Obsolète

Note: l'utilisation de "addons-installer" n'est plus recommandé. L'utilisation de Addon Manager qui se trouve dans tous les systèmes est la manière recommandée.

Utilisez addons-installer from Github.

Au cours de Google Summer of Code 2016, l'étudiant Mandeep Singh a commencé à travailler sur une version améliorée (disponible ici) mais cette version doit encore être améliorée avant de pouvoir être pleinement intégrée à FreeCAD.

Installation manuelle

Remarque: cette méthode est possible mais pas nécessaire avec l'introduction de Gestionnaire des addons. 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 "Télécharger 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 → Général → Macro et recherchez le «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

Sur 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 modules complémentaires supplémentaires sous Linux

Installation recommandée

L'installation recommandée utilise le Outils → Gestionnaire des addons.

Utiliser git

Ajout de community-ppa dans le gestionnaire ppa.
Installation des ateliers via le gestionnaire de paquets synaptique.

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

FreeCAD vous aurez maintenant une nouvel atelier appelé "CurvesWB". Une fois installé, utilisez git pour passer à la dernière version:

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

Installation manuelle

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

  • Téléchargez le plan de travail depuis github en cliquant sur le bouton Clone ou Download sur la page github (coin supérieur droit) et en choisissant "Télécharger 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 → Général → Macro et recherchez le «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 macro-répertoire, 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 du plan de travail, par exemple “Curves”
  • Déplacez maintenant les fichiers et sous-dossiers décompressés du plan de travail dans le dossier du plan de travail 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 modules complémentaires supplémentaires sous MacOS

L'installation recommandée utilise le Outils → Gestionnaire des addons.

Installation manuelle

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

Pour cet exemple, supposons que vous ayez choisi l'Atelier Courbes comme atelier externe que vous souhaitez installer:

  • Choisissez et téléchargez le référentiel git de votre plan de travail externe choisi sous forme de fichier ZIP
  • En supposant que FreeCAD est installé dans /Applications/FreeCAD/v0.xx", accédez à /Applications/FreeCAD/v0.xx" dans le navigateur et sélectionnez FreeCAD.app
  • RMB et sélectionnez "Afficher le contenu du paquet", une nouvelle fenêtre apparaîtra avec un dossier nommé "Contenu"
  • Un clic unique sur le dossier "Contenu" et sélectionnez le dossier "Mod"
  • Dans le dossier "Mod" créez un nouveau dossier nommé "Curves"
  • Dézippez le répertoire téléchargé dans le dossier "Contents/Mod/Curves"

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
  • 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
  • L'atelier n'apparaît toujours pas? Dans FreeCAD, choisissez Outils → Personnaliser... → Ateliers et assurez-vous qu'il n'est pas défini comme invisible
  • Remarques 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