Addon/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "==Instalacja==")
 
(11 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


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


W programie FreeCAD i w tej dokumentacji '''Dodatek''' to dowolny komponent, który nie jest częścią podstawowej instalacji, ale który można dodać do systemu za pomocą określonych metod.
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.


<span id="Different_types"></span>
== Different types ==
==Różne rodzaje==


Istnieją trzy rodzaje dodatków:
There are three types of addons:
* [[Macros|Macros]]: short snippet of [[Python|Python]] code that provides a new tool or functionality in a single file ending with {{incode|.FCMacro}}.
* [[Macros/pl|Makrodefinicje]]: krótki wycinek kodu środowiska [[Python/pl|Python]], który dostarcza nowe narzędzie lub funkcjonalność w pojedynczym pliku o rozszerzeniu {{incode|.FCMacro}}.
* [[External_workbenches|Workbenches]]: 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/pl|Środowiska pracy]]: zbiory plików środowiska Python, które zapewniają powiązane [[Gui_Command/pl|polecenia GUI]] ''(narzędzia)'' skupione wokół konkretnego tematu, na przykład narzędzia do projektowania szafek, lub narzędzia do pracy z architekturą, lub narzędzia do projektowania łodzi, itp. Te środowiska zazwyczaj definiują nowe paski narzędzi, w których [[Gui_Command/pl|polecenia]] umieszczone jako przyciski.
* [[Preference_Packs|Preference Packs]]: distributable collections of user preferences. {{Version|0.20}}
* [[Preference_Packs/pl|Pakiety preferencji]]: dystrybuowane zbiory preferencji użytkownika. {{Version/pl|0.20}}


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


The recommended way to install addons is with the [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]].
Zalecanym sposobem na instalację dodatków jest [[File:Std_AddonMgr.svg|24px]] [[Std_AddonMgr/pl|Menedżer dodatków]].


Ale w przypadku makrodefinicji i środowisk pracy możliwa jest również instalacja ręczna:
But for macros and workbenches manual installation is also possible:
* [[How_to_install_macros|How to install macros]]
* [[How_to_install_macros/pl|Jak zainstalować makrodefinicje]]
* [[Installing_more_workbenches|Installing more workbenches]]
* [[Installing_more_workbenches/pl|Instalacja większej ilości środowisk pracy]]


<span id="Information_for_developers"></span>
== Information for developers ==
==Informacja dla programistów==


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.
Jeśli opracowałeś Środowisko pracy lub makrodefinicję i chcesz zobaczyć je w Menedżerze dodatków, przeczytaj jak to zrobić na stronach repozytorium: ''([https://github.com/FreeCAD/FreeCAD-addons/ FreeCAD-addons] i [https://github.com/FreeCAD/FreeCAD-macros/ FreeCAD-macros])''. Jeśli dodasz swoje makro do strony [[Macros_recipes/pl|Przepisy na makropolecenia]], nie będziesz miał już nic innego do zrobienia, zostanie ono automatycznie przechwycone przez Menadżer dodatków.


Zobacz również:
=== Python workbenches ===
* [[Workbench_creation/pl#Dystrybucja|Dystrybucja środowiska pracy stworzonego w Python]].

* [[Workbench_creation/pl#Dystrybucja_2|Dystrybucja środowiska pracy stworzonego w 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 17:52, 6 February 2023

Wprowadzenie

W programie FreeCAD i w tej dokumentacji Dodatek to dowolny komponent, który nie jest częścią podstawowej instalacji, ale który można dodać do systemu za pomocą określonych metod.

Różne rodzaje

Istnieją trzy rodzaje dodatków:

  • Makrodefinicje: krótki wycinek kodu środowiska Python, który dostarcza nowe narzędzie lub funkcjonalność w pojedynczym pliku o rozszerzeniu .FCMacro.
  • Środowiska pracy: zbiory plików środowiska Python, które zapewniają powiązane polecenia GUI (narzędzia) skupione wokół konkretnego tematu, na przykład narzędzia do projektowania szafek, lub narzędzia do pracy z architekturą, lub narzędzia do projektowania łodzi, itp. Te środowiska zazwyczaj definiują nowe paski narzędzi, w których polecenia są umieszczone jako przyciski.
  • Pakiety preferencji: dystrybuowane zbiory preferencji użytkownika. dostępne w wersji 0.20

Instalacja

Zalecanym sposobem na instalację dodatków jest Menedżer dodatków.

Ale w przypadku makrodefinicji i środowisk pracy możliwa jest również instalacja ręczna:

Informacja dla programistów

Jeśli opracowałeś Środowisko pracy lub makrodefinicję i chcesz zobaczyć je w Menedżerze dodatków, przeczytaj jak to zrobić na stronach repozytorium: (FreeCAD-addons i FreeCAD-macros). Jeśli dodasz swoje makro do strony Przepisy na makropolecenia, nie będziesz miał już nic innego do zrobienia, zostanie ono automatycznie przechwycone przez Menadżer dodatków.

Zobacz również: