Addon/es: Difference between revisions

From FreeCAD Documentation
(Created page with "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 ci...")
(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...")
Line 7: Line 7:
== Diferentes tipos ==
== Diferentes tipos ==


There are roughly three types of addons:
Existen aproximadamente tres tipos de addons:
* [[Macros|Macro]]: short snippet of [[Python|Python]] code that provides a new tool or functionality in a single file ending with {{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.
* Module: a single Python source file, or a collection of Python files, that extends the software in some way. Modules don't necessarily define a graphical "workbench" but may provide a supporting feature, for example, a library that performs conversion of formats, or code that modifies the graphical [[interface|interface]].
* [[External_workbenches|Workbench]]: collections of Python files that provide related [[Gui_Command|Gui Commands]] (tools) centered around a particular topic, for example, tools to design cabinets, or tools to work with architecture, or tools to design boats, etc. These workbenches usually define new toolbars where [[Gui_Command|commands]] are placed as buttons.
* [[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.


Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.
Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.

Revision as of 10:42, 5 February 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.

Macros as installed under the user's Macro/ directory, while modules and workbenches are under the Mod/ directory.

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

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.

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 in 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.