How to install additional workbenches/es: Difference between revisions

From FreeCAD Documentation
(Created page with "===Instalación Recomendada===")
(Updating to match new version of source page)
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{TutorialInfo/es
{{TutorialInfo/es
|Topic=Programación
|Topic=Programación
Line 9: Line 10:
}}
}}


<span id="Description"></span>
==Descripción==
==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.
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.


'''Nota:''' A partir de la versión 0.17 FreeCAD incluye un [[Image:AddonManager.svg|24px|link=Addon_Manager/es]][[Addon_Manager/es|Administrador de complementos]] en el menu {{MenuCommand|Herramientas → Administrador de complementos}} que permite instalar fácilmente una serie de Ambiente de trabajo externos. Las instrucciones de más abajo son solo necesarias si estás usando una versión anterior o quieres instalar un entorno de trabajo que no está en la lista ofrecida por el [[Addon_Manager/es|Administrador de complementos]]
{{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}}.


<div class="mw-collapsible mw-collapsed toccolours">
<div class="mw-collapsible mw-collapsed toccolours">

<span id="Installing_on_Windows"></span>
==Instalación en Windows==
==Instalación en Windows==


Line 20: Line 25:
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


=== Instalación Recomendada ===
=== Manual Install ===

{{VeryImportantMessage|El método de instalación recomendado más moderno es {{MenuCommand|Herramientas → [[Image:AddonManager.svg|24px|link=Addon_Manager/es]] [[Addon_Manager/es|Administrador de complementos]]}}.}}

=== Obsoleto ===

{{Emphasis|Nota:}} usar el "addons-installer" ya no es recomendado. Usar el [[Addon_Manager/es|Administrador de complementos]] es el método recomendado en todos los sistemas.

Use el [https://github.com/FreeCAD/FreeCAD-addons addons-installer de Github]

Durante el verano del código 2016 de Google, el estudiante Mandeep Singh comenzó a trabajar en una versión mejorada ([https://github.com/mandeeps708/PluginManager disponible aquí]), pero esa versión necesita más trabajo antes de que pueda ser totalmente integrada en FreeCAD.


<div class="mw-translate-fuzzy">
=== Instalación manual ===
=== Instalación manual ===
{{Emphasis|Nota:}} Este método es posible pero no necesario con la introducción del [[Addon Manager/es|Administrador de complementos]]. Sin embargo, la información aquí puede ser útil para algunos.
{{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.
</div>


* 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"
* 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
* Unpack the downloaded archive on your local hard disk
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → General → Macro}} and look for the ”Macro path”
* 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}}
* 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 macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
Line 44: Line 41:
* After restart of FreeCAD you should now have an entry in the [[Std_Workbench|workbench selector]]
* 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'''
'''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.
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</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">
<div class="mw-collapsible mw-collapsed toccolours">


<span id="Installing_on_Linux"></span>
==Instalación en Linux ==
==Instalación en Linux ==


Cómo instalar bancos de trabajo adicionales y complementos en Linux
How to install additional workbenches and addons on Linux
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">


===Instalación Recomendada===
===Using git===


Adding the [https://launchpad.net/~freecad-community/+archive/ubuntu/ppa community-ppa] within the ppa-manager.<br/>
{{VeryImportantMessage|The modern recommended installation is using the {{MenuCommand|Tools → [[Image:AddonManager.svg|24px|link=Addon Manager]] [[Addon Manager]]}}.}}
Installing the workbenches via Synaptic Packet Manager.

===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 73: Line 67:
}}
}}


FreeCAD you will now have a new workbench-entry called "CurvesWB". Once installed, use git to upgrade to the latest version:
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=
Line 82: Line 76:


===Manual Installation===
===Manual Installation===

{{Emphasis|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.
{{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 {{Button|Clone}} or {{Button|Download}} on the github page (upper right corner) and choosing "Download ZIP"
* 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
* Unpack the downloaded archive on your local hard disk
* Within FreeCAD, locate the macro path by choosing {{MenuCommand|Edit → Preferences → General → Macro}} and look for the ”Macro path”
* 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
* 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 macro-directory create (if not already present) a folder called “{{FileName|Mod}}”
Line 95: Line 90:
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</div> <!-- END of Windows section collapsible div. Please do not remove --->
</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">
<div class="mw-collapsible mw-collapsed toccolours">
==Installing on Mac==
==Installing on Mac==


How to install additional workbenches and addons on MacOS
How to install additional workbenches and addons on macOS
<div class="mw-collapsible-content">
<div class="mw-collapsible-content">

===Recommended Installation===
{{VeryImportantMessage|The modern recommended installation is using the {{MenuCommand|Tools → [[Image:AddonManager.svg|24px|link=Addon Manager]] [[Addon Manager]]}}.}}


===Manual Installation===
===Manual Installation===

{{Emphasis|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.
{{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:
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
* 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 {{FileName|/Applications/FreeCAD/v0.xx}}", go to {{FileName|/Applications/FreeCAD/v0.xx}}" in the Browser, and select FreeCAD.app
# All Users: {{FileName|/Applications/FreeCAD.app/Contents/Resources/Mod}}
* RMB 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 "Curves"
** go to {{FileName|/Applications}}" and select FreeCAD.app
* Unzip downloaded repository in the folder "Contents/Mod/Curves"
** 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 --->
</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>
==General troubleshooting==
==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 {{MenuCommand|EditPreferences → 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)]


*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
*Workbench still not showing up ? In FreeCAD, choose {{MenuCommand|ToolsCustomize → Workbenches}} and make sure it is not set to invisible
*'''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


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

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