Addon: Difference between revisions

From FreeCAD Documentation
({{Userdocnavi{{#translation:}}}} to categorize the page)
(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.)
Line 5: Line 5:


<!--T:2-->
<!--T:2-->
In FreeCAD and in this documentation, an [[addon|addon]] is any component that is not part of the base FreeCAD installation, but that can be added to the system by certain methods.
In FreeCAD and in this documentation, an [[addon|addon]] is any component that is not part of the base installation, but that can be added to the system by certain methods.

== Different types ==


<!--T:3-->
<!--T:3-->
There are two types of addons.
There are roughly three types of addons:
* [[Macros]]: short snippets of [[Python]] code that provide a new tool or functionality.
* [[Macros|Macro]]: short snippet of [[Python|Python]] code that provides a new tool or functionality in a single file ending with {{incode|.FCMacro}}.
* 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]]: collections of tools programmed in Python or C++ that extend FreeCAD in an important way.
* [[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.

Macros as installed under the user's {{incode|Macro/}} directory, while modules and workbenches are under the {{incode|Mod/}} directory.
</translate>
{{Code|lang=bash|code=
$HOME/.FreeCAD/Macro/
$HOME/.FreeCAD/Mod/
}}
<translate>


<!--T:4-->
<!--T:4-->
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, the entire directory may be distributed as a new workbench.
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.


<!--T:5-->
<!--T:5-->
In other words, macros and workbenches are essentially the same thing, pieces of code that extend the base installation. Macros are usually short utilities focused on a single task, while workbenches are collections of organized tools and graphical interfaces to perform related tasks.
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.


<!--T:6-->
<!--T:6-->
If a workbench is sufficiently developed and is well documented, it may be included as one of the base [[workbenches]] in FreeCAD.
If a workbench is sufficiently developed and is well documented, it may be included as one of the base [[workbenches|workbenches]] in FreeCAD.


== Installation == <!--T:7-->
== Installation == <!--T:7-->


<!--T:8-->
<!--T:8-->
Starting from FreeCAD 0.17, the recommended way to install addons is with the [[Addon Manager]].
Starting from FreeCAD 0.17, the recommended way to install addons is with the [[Std_AddonMgr|Addon Manager]].


<!--T:9-->
<!--T:9-->
Manual installation is still possible.
However, manual installation is still possible.
* [[How to install macros]]
* [[How_to_install_macros|How to install macros]]
* [[Installing more workbenches]]
* [[Installing_more_workbenches|Installing more workbenches]]


</translate>
</translate>

Revision as of 06:19, 13 May 2020

Introduction

In FreeCAD and in this documentation, an addon is any component that is not part of the base installation, but that can be added to the system by certain methods.

Different types

There are roughly three types of addons:

  • Macro: short snippet of Python code that provides a new tool or functionality in a single file ending with .FCMacro.
  • 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.
  • Workbench: collections of Python files that provide related 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 commands are placed as buttons.

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.

Installation

Starting from FreeCAD 0.17, the recommended way to install addons is with the Addon Manager.

However, manual installation is still possible.