How to install additional workbenches/es: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(52 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{TutorialInfo/es|Topic=Programming|Level=Medium programmer|Time=15 minutes|FCVersion=All|Author=[[User:R-Frank|r-frank]]}}
</div>


{{TutorialInfo/es
==Description==
|Topic=Programación
Power users have extended FreeCAD with various custom external workbenches, that are not integrated into the FreeCAD source code (yet!),
|Level=Programador mediano
but are easy to install on an existing FreeCAD installation. Here we will cover the installation methods for the different operating systems.
|Time=15 minutos
|FCVersion=Todos
|Author=[[User:R-Frank|r-frank]]
|Files=ninguno
}}


<span id="Description"></span>
'''Note''' Starting from version 0.17, FreeCAD features an addons manager in the Tools menu, that allows to easily install a series of external workbenches. The instructions below are only necessary if you are running an earlier version, or if you want to install a workbench that is not in the list offered by the addons manager.
==Descripción==


Usuarios avanzados han extendido FreeCAD con varios [[external workbenches/es|Ambiente de trabajo externos]], que no están integrados en el código fuente principal de FreeCAD, pero son fáciles de instalar en una instalación de FreeCAD existente. Aquí cubriremos los métodos de instalación para los distintos sistemas operativos.
==Installing on Windows==


{{Emphasis|Note:}} a partir de la versión 0.17, FreeCAD presenta un [[File:AddonManager.svg|24px]] [[Std_AddonMgr/es|Administrador de complementos]] en el menú {{MenuCommand|Herramientas → Administrador de complementos}}, que permite instalar tanto macros como bancos de trabajo. Las instrucciones que siguen sólo son necesarias si se desea instalar manualmente un banco de trabajo. Esto puede ser necesario si por alguna razón el Administrador de complementos no funciona pero tienes acceso al banco de trabajo descargado como un paquete {{FileName|.zip}}.
'''Recommended installation method'''


<div class="mw-collapsible mw-collapsed toccolours">
{{Emphasis|Note:}} using the "addons-installer" is not recommended any more. Using the [[Addon Manager|Addon Manager]] in all systems is the recommended way.


<span id="Installing_on_Windows"></span>
Use the [https://github.com/FreeCAD/FreeCAD-addons addons-installer from Github].
==Instalación en Windows==


Como instalar Ambiente de trabajo adicionales y complementos en Windows
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.
<div class="mw-collapsible-content">


=== Manual Install ===
'''Alternative installation method “manual install”'''


<div class="mw-translate-fuzzy">
*download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"
=== Instalación manual ===
*unpack the downloaded archive on your local hard disk
{{Emphasis|Nota:}} Este método es posible pero no necesario con la introducción del [[Std_AddonMgr/es|Administrador de complementos]]. Sin embargo, la información aquí puede ser útil para algunos.
*within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”
</div>
*supposed your Windows-Login is “User-Name” the default macro path is “C:\User-Name\Appdata\Roaming\FreeCAD”
*within the macro-directory create (if not already present) a folder called “Mod”
*within the folder mod create a folder with the name of the workbench, for example “Assembly2”
*now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
*after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu


* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
'''Additional Recommendation for upating workbenches'''
* Unpack the downloaded archive on your local hard disk
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → Python → Macro}} and look for the ”Macro path”
* Supposed your Windows-Login is “''username''” the default macro path is {{FileName|%APPDATA%\FreeCAD\}} which is usually {{FileName|C:\Users\''username''\Appdata\Roaming\FreeCAD}}
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
* Within the Mod folder, create a folder with the name of the workbench, for example “Curves”
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]


'''Recomendación adicional para la actualización de l'Ambiente de trabajo'''
On windows, when updating an already installed workbench, Windows keeps the old .py files as .pyc. Since this may lead to trouble, it is recommended to uninstall the workbench, restart FreeCAD and install the new version of the workbench.


En Windows, cuando se actualiza un Ambiente de trabajo ya instalado, Windows mantiene los viejos archivos .py como .pyc. Dado que esto puede dar lugar a problemas, se recomienda desinstalar el Ambiente de trabajo, reiniciar FreeCAD e instalar la nueva versión del Ambiente de trabajo.
==Installing on Linux (Ubuntu/Mint)==
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->


<div class="mw-collapsible mw-collapsed toccolours">
'''Recommended installation method'''


<span id="Installing_on_Linux"></span>
Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br />
==Instalación en Linux ==
Installing the workbenches via synaptic packet manager.


Cómo instalar bancos de trabajo adicionales y complementos en Linux
'''Alternative installation method “Installing via Git”'''
<div class="mw-collapsible-content">

===Using git===

Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br/>
Installing the workbenches via Synaptic Packet Manager.


{{Code|code=
{{Code|code=
Line 48: Line 64:
$ 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
}}
}}


FreeCAD you will now have a new workbench-entry called "Assembly 2". Once installed, use git to upgrade to the latest version through BASH as follows
In FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:


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


===Manual Installation===
'''Alternative installation method “manual install”'''


{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Std_AddonMgr|Addon Manager]]. Nevertheless, the information here may still be useful to some.
*download the workbench from github by clicking on the button “clone or download” on the github page (upper right corner) and choosing "Download ZIP"
*unpack the downloaded archive on your local hard disk
*within FreeCAD, locate the macro path by choosing “Edit > Preferences > General > Macro” and look for the ”Macro path”
*by default, the macro directory is the (hidden) "/.FreeCAD"-directory in your home-directory
*within the macro-directory create (if not already present) a folder called “Mod”
*within the folder "mod" create a folder with the name of the workbench, for example “Assembly2”
*now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
*after restart of FreeCAD you should now have an entry in the workbench-pulldown-menu


* Download the workbench from github by clicking on the button {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
* Unpack the downloaded archive on your local hard disk
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → Python → Macro}} and look for the ”Macro path”
* By default, the macro directory is the (hidden) {{MenuCommand|./.FreeCAD/}} directory in your home-directory
* Within the macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
* Within the Mod/ folder, create a folder with the name of the workbench, for example “Curves”
* Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]

</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->

<div class="mw-collapsible mw-collapsed toccolours">
==Installing on Mac==
==Installing on Mac==


How to install additional workbenches and addons on macOS
'''Recommended installation method'''
<div class="mw-collapsible-content">

===Manual Installation===


{{Emphasis|Note:}} This method is possible but not necessary with the introduction of the [[Std_AddonMgr|Addon Manager]]. Nevertheless, the information here may still be useful to some.


For the sake of this example, say you've chosen the [[Curves Workbench]] as the external workbench you want to install:
'''Alternative installation method “manual install”''' - here a description for the workbench "assembly2"
*download the git repository as ZIP
* Choose and download the git repository of your chosen external workbench as a ZIP file
* There are two possible locations for your Addon workbench 'Mods':
*assuming FreeCAD is installed in "/Applications/FreeCAD/v0.15", go to "/Applications/FreeCAD/v0.15" in the Browser, and select FreeCAD.app
# All Users: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
*right-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
# Current user only: {{FileName|/Users/myusername/Library/Application Support/FreeCAD/Mod}}
*single-click on the folder "Contents" and select the folder "Mod"
* If you use Finder to navigate manually to the All Users location in Applications you will need to
*in the folder "Mod" create a new folder named "assembly2"
** go to {{FileName|/Applications}}" and select FreeCAD.app
*unzip downloaded repository in the folder "Contents/Mod/assembly2"
** right-mouse-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
** single-click on the folder "Contents" then on "Resources" and double-click to open the folder "Mod"
* Once you are in whichever "Mod" folder you want to use, create a New Folder named "Curves"
* Unzip downloaded repository in the folder "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>
==Solución de problemas generales==


* Don't use special characters (for example German umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path.
Copy or unzip the drawing dimensioning folder to the directory FreeCAD.app/Contents/Mod
* If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters.
where FreeCAD.app is the folder where FreeCAD is installed.
* Go to {{MenuCommand|Edit → Preferences → Workbenches}} and make sure the workbench is not set to invisible.
* With 32-bit systems and FreeCAD 0.16.6706, after attempts to install, the additional Workbenches may not be available. In this case
** keep the [[report_view|report view]] open while starting FreeCAD, and read the error,
** see this forum thread [http://forum.freecadweb.org/viewtopic.php?t=12839#p102933 Assembly2 in Version: 0.16.5602 (Git)]


==General troubleshooting==


{{Userdocnavi{{#translation:}}}}
*Don’t use special characters (for example german umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path
{{Powerdocnavi{{#translation:}}}}
*If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters
[[Category:External Workbenches{{#translation:}}]]
*Workbench still not showing up ? In FreeCAD, choose “Tools > Customize > Workbenches” and make sure it is not set to invisible
[[Category:Addons{{#translation:}}]]
*'''Notes for users with 32-bit system and FreeCAD 0.16.6706 '''. After attempts to install, the additional Workbenches may not be available. In this case
** hold the Report panel open while starting FreeCAD, and read the error
** see this forum thread: http://forum.freecadweb.org/viewtopic.php?t=12839#p102933

Latest revision as of 19:54, 9 August 2023

Tutorial
Tema
Programación
Nivel
Programador mediano
Tiempo para completar
15 minutos
Autores
r-frank
Versión de FreeCAD
Todos
Archivos de ejemplos
ninguno
Ver también
None

Descripción

Usuarios avanzados han extendido FreeCAD con varios Ambiente de trabajo externos, que no están integrados en el código fuente principal de FreeCAD, pero son fáciles de instalar en una instalación de FreeCAD existente. Aquí cubriremos los métodos de instalación para los distintos sistemas operativos.

Note: a partir de la versión 0.17, FreeCAD presenta un Administrador de complementos en el menú Herramientas → Administrador de complementos, que permite instalar tanto macros como bancos de trabajo. Las instrucciones que siguen sólo son necesarias si se desea instalar manualmente un banco de trabajo. Esto puede ser necesario si por alguna razón el Administrador de complementos no funciona pero tienes acceso al banco de trabajo descargado como un paquete .zip.

Instalación en Windows

Como instalar Ambiente de trabajo adicionales y complementos en Windows

Manual Install

Instalación manual

Nota: Este método es posible pero no necesario con la introducción del Administrador de complementos. Sin embargo, la información aquí puede ser útil para algunos.

  • Download the workbench from github by clicking on the button Clone or Download on the github page (upper right corner) and choosing "Download ZIP"
  • Unpack the downloaded archive on your local hard disk
  • Within FreeCAD, locate the macro path by choosing Edit → Preferences → Python → Macro and look for the ”Macro path”
  • Supposed your Windows-Login is “username” the default macro path is %APPDATA%\FreeCAD\ which is usually C:\Users\username\Appdata\Roaming\FreeCAD
  • Within the macro-directory create (if not already present) a folder called “Mod
  • Within the Mod folder, create a folder with the name of the workbench, for example “Curves”
  • Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
  • After restart of FreeCAD you should now have an entry in the workbench selector

Recomendación adicional para la actualización de l'Ambiente de trabajo

En Windows, cuando se actualiza un Ambiente de trabajo ya instalado, Windows mantiene los viejos archivos .py como .pyc. Dado que esto puede dar lugar a problemas, se recomienda desinstalar el Ambiente de trabajo, reiniciar FreeCAD e instalar la nueva versión del Ambiente de trabajo.

Instalación en Linux

Cómo instalar bancos de trabajo adicionales y complementos en Linux

Using git

Adding the community-ppa within the ppa-manager.
Installing the workbenches 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

In FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:

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

Manual Installation

Note: This method is possible but not necessary with the introduction of the Addon Manager. Nevertheless, the information here may still be useful to some.

  • Download the workbench from github by clicking on the button Clone or Download on the github page (upper right corner) and choosing "Download ZIP"
  • Unpack the downloaded archive on your local hard disk
  • Within FreeCAD, locate the macro path by choosing Edit → Preferences → Python → Macro and look for the ”Macro path”
  • By default, the macro directory is the (hidden) ./.FreeCAD/ directory in your home-directory
  • Within the macro-directory create (if not already present) a folder called “Mod
  • Within the Mod/ folder, create a folder with the name of the workbench, for example “Curves”
  • Now move the unpacked files and sub-folders of the workbench to the just created workbench-folder
  • After restart of FreeCAD you should now have an entry in the workbench selector

Installing on Mac

How to install additional workbenches and addons on macOS

Manual Installation

Note: This method is possible but not necessary with the introduction of the Addon Manager. Nevertheless, the information here may still be useful to some.

For the sake of this example, say you've chosen the Curves Workbench as the external workbench you want to install:

  • Choose and download the git repository of your chosen external workbench as a ZIP file
  • There are two possible locations for your Addon workbench 'Mods':
  1. All Users: /Applications/FreeCAD.app/Contents/Resources/Mod
  2. Current user only: /Users/myusername/Library/Application Support/FreeCAD/Mod
  • If you use Finder to navigate manually to the All Users location in Applications you will need to
    • go to /Applications" and select FreeCAD.app
    • right-mouse-click and select "Show Package Contents", a new window will appear with a folder named "Contents"
    • single-click on the folder "Contents" then on "Resources" and double-click to open the folder "Mod"
  • Once you are in whichever "Mod" folder you want to use, create a New Folder named "Curves"
  • Unzip downloaded repository in the folder "Mod/Curves"

Solución de problemas generales

  • Don't use special characters (for example German umlauts) in your windows user name, otherwise FreeCAD will not recognize files and folders in the macro path.
  • If you have already set up a user name with special characters either create a new user name or point the macro path to a directory not using special characters.
  • Go to Edit → Preferences → Workbenches and make sure the workbench is not set to invisible.
  • With 32-bit systems and FreeCAD 0.16.6706, after attempts to install, the additional Workbenches may not be available. In this case