Addon/es: Difference between revisions

From FreeCAD Documentation
(Created page with "Existen aproximadamente tres tipos de addons: * Macro: breve fragmento de código Python que proporciona una nueva herramienta o funcionalidad en u...")
(linking)
(4 intermediate revisions by one other user not shown)
Line 10: Line 10:
* [[Macros/es|Macro]]: breve fragmento de código [[Python/es|Python]] que proporciona una nueva herramienta o funcionalidad en un único archivo que termina en {{incode|.FCMacro}}.
* [[Macros/es|Macro]]: breve fragmento de código [[Python/es|Python]] que proporciona una nueva herramienta o funcionalidad en un único archivo que termina en {{incode|.FCMacro}}.
* Módulo: un único archivo fuente de Python, o una colección de archivos de Python, que amplía el software de alguna manera. Los módulos no definen necesariamente un "ambiente de trabajo" gráfico, pero pueden proporcionar una característica de apoyo, por ejemplo, una biblioteca que realiza la conversión de formatos, o el código que modifica la [[interface/es|interfaz]] gráfica.
* Módulo: un único archivo fuente de Python, o una colección de archivos de Python, que amplía el software de alguna manera. Los módulos no definen necesariamente un "ambiente de trabajo" gráfico, pero pueden proporcionar una característica de apoyo, por ejemplo, una biblioteca que realiza la conversión de formatos, o el código que modifica la [[interface/es|interfaz]] gráfica.
* [[External_workbenches/es|Ambiente de trabajo]]: colecciones de archivos Python que proporcionan [[Gui_Command/de|Comandos Gui]] relacionados. (herramientas) centradas en un tema concreto, por ejemplo, herramientas para diseñar armarios, o herramientas para trabajar con arquitectura, o herramientas para diseñar barcos, etc. Estos bancos de trabajo suelen definir nuevas barras de herramientas donde los [[Gui_Command/es|comandos]] se colocan como botones.
* [[External_workbenches/es|Ambiente de trabajo]]: colecciones de archivos Python que proporcionan [[Gui_Command/es|Comandos Gui]] relacionados. (herramientas) centradas en un tema concreto, por ejemplo, herramientas para diseñar armarios, o herramientas para trabajar con arquitectura, o herramientas para diseñar barcos, etc. Estos bancos de trabajo suelen definir nuevas barras de herramientas donde los [[Gui_Command/es|comandos]] se colocan como botones.


Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.
Las macros se instalan en el directorio {{incode|Macro/}} del usuario, mientras que los módulos y los ambientes de trabajo están en el directorio {{incode|Mod/}}.
{{Code|lang=bash|code=
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Macro/
Line 18: Line 18:
}}
}}


Las macros suelen comenzar como una forma de simplificar o automatizar la tarea de dibujar o editar un objeto concreto. Si muchas de estas macros se reúnen dentro de un directorio, y se proporciona una estructura para recoger esas herramientas, entonces todo el directorio puede distribuirse como un ambiente de trabajo.
Macros usually start as a way to simplify or automate the task of drawing or editing a particular object. If many of these macros are collected inside a directory, and structure is provided to collect those tools, then the entire directory may be distributed as a workbench.


En otras palabras, las macros, los módulos y las ambientes de trabajo son esencialmente lo mismo, piezas de código Python que amplían la instalación base. Las macros suelen ser cortas y se centran en una sola tarea, los módulos suelen proporcionar nuevas funciones o interfaces, y las ambientes de trabajo son colecciones de herramientas (botones, menús) e interfaces gráficas para realizar tareas relacionadas.
In other words, macros, modules, and workbenches are essentially the same thing, pieces of Python code that extend the base installation. Macros are usually short and focused on a single task, modules usually provide new functions or interfaces, and workbenches are collections of tools (buttons, menus) and graphical interfaces to perform related tasks.


If a workbench is sufficiently developed and is well documented, it may be included as one of the base [[workbenches|workbenches]] in FreeCAD.
Si un ambiente de trabajo está suficientemente desarrollado y está bien documentado, puede ser incluido como uno de los [[workbenches/es|Ambientes de trabajo]] base en FreeCAD.


== Instalación ==
== Instalación ==

Revision as of 17:11, 31 October 2021

Introducción

En FreeCAD y en esta documentación, un complemento es cualquier componente que no es parte de la instalación base, pero que puede ser añadido al sistema por ciertos métodos.

Diferentes tipos

Existen aproximadamente tres tipos de addons:

  • Macro: breve fragmento de código Python que proporciona una nueva herramienta o funcionalidad en un único archivo que termina en .FCMacro.
  • Módulo: un único archivo fuente de Python, o una colección de archivos de Python, que amplía el software de alguna manera. Los módulos no definen necesariamente un "ambiente de trabajo" gráfico, pero pueden proporcionar una característica de apoyo, por ejemplo, una biblioteca que realiza la conversión de formatos, o el código que modifica la interfaz gráfica.
  • Ambiente de trabajo: colecciones de archivos Python que proporcionan Comandos Gui relacionados. (herramientas) centradas en un tema concreto, por ejemplo, herramientas para diseñar armarios, o herramientas para trabajar con arquitectura, o herramientas para diseñar barcos, etc. Estos bancos de trabajo suelen definir nuevas barras de herramientas donde los comandos se colocan como botones.

Las macros se instalan en el directorio Macro/ del usuario, mientras que los módulos y los ambientes de trabajo están en el directorio Mod/.

$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/

Las macros suelen comenzar como una forma de simplificar o automatizar la tarea de dibujar o editar un objeto concreto. Si muchas de estas macros se reúnen dentro de un directorio, y se proporciona una estructura para recoger esas herramientas, entonces todo el directorio puede distribuirse como un ambiente de trabajo.

En otras palabras, las macros, los módulos y las ambientes de trabajo son esencialmente lo mismo, piezas de código Python que amplían la instalación base. Las macros suelen ser cortas y se centran en una sola tarea, los módulos suelen proporcionar nuevas funciones o interfaces, y las ambientes de trabajo son colecciones de herramientas (botones, menús) e interfaces gráficas para realizar tareas relacionadas.

Si un ambiente de trabajo está suficientemente desarrollado y está bien documentado, puede ser incluido como uno de los Ambientes de trabajo base en FreeCAD.

Instalación

A partir de FreeCAD 0.17, la forma recomendada de instalar los complementos es con el Gestor complementos.

Sin embargo, la instalación manual sigue siendo posible.