Addon/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(7 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
== Introduzione ==
== Introduzione ==


In FreeCAD e in questa documentazione, un addon è un componente che non fa parte dell'installazione di base di FreeCAD, ma che può essere aggiunto al sistema con determinati metodi.
In FreeCAD e in questa documentazione, un addon è un componente che non fa parte dell'installazione di base di FreeCAD, ma che può essere aggiunto al sistema con determinati metodi.


<span id="Different_types"></span>
==I diversi tipi==
==I diversi tipi==


<div class="mw-translate-fuzzy">
Esistono tre tipi di componenti aggiuntivi:
Esistono tre tipi di componenti aggiuntivi:
* Le [[Macros/it|Macro]]: brevi frammenti di codice [[Python/it|Python]] che forniscono un nuovo strumento o funzionalità in un singolo file che termina con {{incode|.FCMacro}}.
* Le [[Macros/it|Macro]]: brevi frammenti di codice [[Python/it|Python]] che forniscono un nuovo strumento o funzionalità in un singolo file che termina con {{incode|.FCMacro}}.
* I Moduli: un singolo file sorgente Python o una raccolta di file Python che estende il software in qualche modo. I moduli non definiscono necessariamente un "ambiente di lavoro" grafico ma possono fornire una funzione di supporto, ad esempio una libreria che esegue la conversione di formati o un codice che modifica l'[[interface/it|interfaccia]] grafica.
* Gli [[External_workbenches/it|Ambienti]]: raccolte di file Python che forniscono [[Gui_Command/it|comandi GUI]] (strumenti) correlati, centrati su un argomento particolare, ad esempio strumenti per progettare cabine o strumenti per lavorare con l'architettura o strumenti per progettare barche, ecc. Questi ambienti di lavoro di solito definiscono nuove barre degli strumenti in cui sono posizionati i pulsanti dei [[Gui_Command/it|comandi]].
* Gli [[External_workbenches/it|Ambienti]]: raccolte di file Python che forniscono [[Gui_Command/it|comandi GUI]] (strumenti) correlati, centrati su un argomento particolare, ad esempio strumenti per progettare cabine o strumenti per lavorare con l'architettura o strumenti per progettare barche, ecc. Questi ambienti di lavoro di solito definiscono nuove barre degli strumenti in cui sono posizionati i pulsanti dei [[Gui_Command/it|comandi]].
* [[Preference_Packs/it|Pacchetti Preferenze]]: raccolte distribuibili di preferenze utente. {{Version/it|0.20}}
</div>


<span id="Installation"></span>
== Installazione ==
== Installazione ==


Il modo consigliato per installare i componenti aggiuntivi è con l'[[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/it|Addon Manager]].
<div class="mw-translate-fuzzy">
A partire da FreeCAD 0.17, il modo consigliato per installare i componenti aggiuntivi è tramite [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/it|Addon Manager]].
</div>


Ma per le macro e gli ambienti di lavoro è anche possibile l'installazione manuale:
<div class="mw-translate-fuzzy">
L'installazione manuale è ancora possibile.
* [[How to install macros/it|Come installare le macro]]
* [[How to install macros/it|Come installare le macro]]
* [[Installing more workbenches/it|Installare ambienti aggiuntivi]]
* [[Installing more workbenches/it|Installare ambienti aggiuntivi]]
</div>


<span id="Information_for_developers"></span>
== Information for developers ==
==Informazioni per gli sviluppatori==


If you have developed a macro or workbench, and want to see it included in the Addon manager, read how to do so on the repository pages: ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] and [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). If you add your macro to the [[Macros_recipes|Macros recipes]] page, there is nothing else to do, it will automatically be picked up by the Addon manager.
Se avete sviluppato un workbench o una macro e volete vederlo incluso in Addon manager, leggete come farlo nelle pagine del repository ([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] e [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros]). Se aggiungete la vostra macro a [[Macros recipes|Raccolta di macro]], non dovete fare nient'altro, essa verrà automaticamente selezionata da Addon manager.


Vedere anche:
=== Python workbenches ===
* [[Workbench_creation/it#Distribuzione|Distribuzione di un workbench Python]]

* [[Workbench_creation/it#Distribuzione_2|Distribuzione di un workbench C++]]
For Python workbenches, you don't need any specific approval to have your workbench added to the Addon Manager. In addition, because your Addon is outside the FreeCAD source code, you can choose the license you want. If you request for your workbench to be added to the Addon Manager's default list (we will not add any new workbench without a request from its authors), either by asking so on the forum or by opening an issue on the [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] repository, your code will stay on your own git repository, we will just add it as a submodule to the [https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] repository. Of course, before adding your workbench, we will take a look at it and make sure there is nothing potentially problematic with it. For more details about structuring your Addon, including information about metadata used by the Addon Manager, see [[Workbench_creation|Workbench creation]].

=== C++ workbenches ===

If you develop a workbench in C++, it cannot be run directly by users and must be compiled first. You then have two options, either you provide precompiled versions of your workbench yourself, for the different operating systems, or you should request to have your code merged into the FreeCAD source code. For that, you should use the LGPL license (or a fully compatible license like MIT or BSD), and you must present your new tools to the community in the [https://forum.freecadweb.org FreeCAD forum] for review. Once your code has been tested and approved, you should fork the FreeCAD repository, if not done yet, create a new branch, push your code to it, and open a pull request so that your branch is merged into the main repository.





Latest revision as of 21:50, 10 June 2023

Introduzione

In FreeCAD e in questa documentazione, un addon è un componente che non fa parte dell'installazione di base di FreeCAD, ma che può essere aggiunto al sistema con determinati metodi.

I diversi tipi

Esistono tre tipi di componenti aggiuntivi:

  • Le Macro: brevi frammenti di codice Python che forniscono un nuovo strumento o funzionalità in un singolo file che termina con .FCMacro.
  • Gli Ambienti: raccolte di file Python che forniscono comandi GUI (strumenti) correlati, centrati su un argomento particolare, ad esempio strumenti per progettare cabine o strumenti per lavorare con l'architettura o strumenti per progettare barche, ecc. Questi ambienti di lavoro di solito definiscono nuove barre degli strumenti in cui sono posizionati i pulsanti dei comandi.
  • Pacchetti Preferenze: raccolte distribuibili di preferenze utente. disponibile dalla versione 0.20

Installazione

Il modo consigliato per installare i componenti aggiuntivi è con l' Addon Manager.

Ma per le macro e gli ambienti di lavoro è anche possibile l'installazione manuale:

Informazioni per gli sviluppatori

Se avete sviluppato un workbench o una macro e volete vederlo incluso in Addon manager, leggete come farlo nelle pagine del repository (FreeCAD-addons e FreeCAD-macros). Se aggiungete la vostra macro a Raccolta di macro, non dovete fare nient'altro, essa verrà automaticamente selezionata da Addon manager.

Vedere anche: