Developer hub/pl: Difference between revisions
(Created page with "===Wewnętrzne===") |
No edit summary |
||
(20 intermediate revisions by 2 users not shown) | |||
Line 33: | Line 33: | ||
[[Packaging/pl|Paczkowanie]] polega na pobraniu skompilowanych binariów i plików źródłowych Python programu FreeCAD i rozpowszechnieniu ich w celu wykorzystania w konkretnym systemie. |
[[Packaging/pl|Paczkowanie]] polega na pobraniu skompilowanych binariów i plików źródłowych Python programu FreeCAD i rozpowszechnieniu ich w celu wykorzystania w konkretnym systemie. |
||
* [[Linux_packaging|Linux |
* [[Linux_packaging/pl|Paczkowanie w Linux OS]] |
||
** [[Debian_development|Debian development]] |
** [[Debian_development/pl|Debian development]] |
||
** [[Debian_Unstable|Debian Unstable]] |
** [[Debian_Unstable/pl|Debian Unstable]] |
||
** [[Git_buildpackage|Git buildpackage]] |
** [[Git_buildpackage/pl|Git buildpackage]] |
||
⚫ | |||
* [[MacOS_packaging|MacOS packaging]] |
* [[MacOS_packaging|MacOS packaging]] |
||
⚫ | |||
<span id="Build_Support_Tools"></span> |
|||
=== Build Support Tools === |
|||
===Narzędzia wspomagające tworzenie wydania=== |
|||
* |
* [[FreeCAD_Build_Tool/pl|FreeCAD Narzędzie do kompilacji]]. |
||
** [[Workbench_creation| |
** [[Workbench_creation/pl|Tworzenie Środowiska pracy]] dla programu FreeCAD. |
||
* [[Debugging| |
* [[Debugging/pl|Debugowanie]] FreeCAD. |
||
* [[Testing| |
* [[Testing/pl|Testowanie]] FreeCAD. |
||
* [[ |
* [[Compiling_(Speeding_up)/pl|Kompilacja (przyspieszamy)]] FreeCAD. |
||
* [[Continuous_Integration/pl|Ciągła integracja]]. |
|||
* [[Continuous Integration|Continuous Integration]] |
|||
<span id="Modifying_FreeCAD"></span> |
|||
=== |
===Modyfikacja programu FreeCAD=== |
||
* Zrozumienie [[The_FreeCAD_source_code/pl|kodu źródłowego FreeCAD]]. |
|||
* Understanding [[The FreeCAD source code|The FreeCAD source code]] |
|||
* [[Tracker# |
* [[Tracker/pl#Przesyłanie_łatek|Przesyłanie łatek]]. |
||
* |
* Dodawanie [[Gui_Command/pl|funkcjonalności]] do programu FreeCAD lub środowiska pracy. |
||
* [[Branding| |
* [[Branding/pl|FreeCAD jako produkt obcej marki]] czyli ''jak nadać programowi FreeCAD unikalny wygląd''. |
||
* [[Artwork| |
* [[Artwork/pl|Opracowanie graficzne]], które wykonaliśmy dla programu FreeCAD, a które możesz dowolnie wykorzystać. |
||
* [[Artwork_Guidelines| |
* [[Artwork_Guidelines/pl|Wytyczne dotyczące grafiki]] standardy dla ikon. |
||
* [[Localisation| |
* [[Localisation/pl|Tłumaczenia dla FreeCAD]]. |
||
* [[Extra_python_modules/pl|Dodatkowe moduły Python]], czyli ''jak rozszerzyć funkcjonalność pythona w ramach FreeCADa''. |
|||
* [[Extra python modules|Extra python modules]], or ''how to extend python functionality within FreeCAD'' |
|||
* [[ |
* [[Google_Summer_of_Code_2023|Google Summer of Code]] zaangażuj się poprzez program wsparcia studentów Google. |
||
* [[Fine-tuning| |
* [[Fine-tuning/pl|Dostrajanie parametrów]] pokazuje różne opcje i przełączniki parametrów, które mogą pokonać problemy |
||
* [[Wrapping_a_Cplusplus_class_in_Python| |
* [[Wrapping_a_Cplusplus_class_in_Python/pl|Zawijanie klasy Cplusplus w środowisku Python]] pokazuje, jak stworzyć w Pythonie wrapper dla klasy C++ |
||
* [[NewFeatureCheckList_C++|Lista kontrolna dodawania funkcji do środowiska pracy w języku C++]] stanowi pomoc dla współtwórców. |
|||
* [[Translating_an_external_workbench/pl|Tłumaczenie interfejsu zewnętrznych środowisk pracy]]. |
|||
* [[Translating an external workbench|Translating an external workbench]] |
|||
<span id="Module_developer's_guide"></span> |
|||
=== Module developer's guide === |
|||
===Przewodnik dla twórców modułów=== |
|||
[https://github.com/qingfengxia/FreeCAD_Mod_Dev_Guide FreeCAD Mod Dev Guide]: |
[https://github.com/qingfengxia/FreeCAD_Mod_Dev_Guide FreeCAD Mod Dev Guide]: To jest ebook w trakcie pisania na platformie GitHub, proszę rozwidlić i wysłać pull request, aby wnieść swój wkład. |
||
Rozdziały: |
|||
Chapters: |
|||
* Przegląd i architektura oprogramowania. |
|||
* Overview and Software Architecture |
|||
* Struktura kodu źródłowego. |
|||
* Source code structure |
|||
* |
* Baza i moduł App. |
||
* Moduł GUI. |
|||
* Gui module |
|||
* Paczkowanie w Pythonie. |
|||
* Python wrapping |
|||
* Modułowa konstrukcja. |
|||
* Modular design |
|||
* |
* Analiza źródeł modułu MES ''(mieszane C++ i Python)''. |
||
* |
* Rozwój modułu CFD ''(czysty Python)''. |
||
* Testowanie i debugowanie modułu. |
|||
* Module testing and debugging |
|||
* |
* Współtworzenie kodu za pomocą git. |
||
Najnowszy PDF może być pobrany z [https://github.com/qingfengxia/FreeCAD_Mod_Dev_Guide/tree/master/pdf tego repo git]. |
|||
<span id="Internals"></span> |
<span id="Internals"></span> |
||
Line 89: | Line 93: | ||
====Dokumentacja OpenCascade==== |
====Dokumentacja OpenCascade==== |
||
OpenCascade to platforma programistyczna do modelowania powierzchniowego i bryłowego 3D, wymiany danych CAD oraz wizualizacji, głównie w postaci bibliotek C++. |
|||
OpenCascade is a software development platform for 3D surface and solid modeling, CAD data exchange, and visualization, mostly in the form of C++ libraries. |
|||
* [http://opencascade.wikidot.com/romansarticles |
* [http://opencascade.wikidot.com/romansarticles Poradniki Romana Lygina]. |
||
* [https://dev.opencascade.org/cdoc/overview/html/index.html |
* [https://dev.opencascade.org/cdoc/overview/html/index.html Pełna dokumentacja online]. |
||
* [https://dev.opencascade.org/doc/refman/html/index.html |
* [https://dev.opencascade.org/doc/refman/html/index.html Podręcznik referencyjny]. |
||
* [http://opencascade.wikidot.com |
* [http://opencascade.wikidot.com Wiki dla openCascade] ''(obecnie zawiera ?chiński spam)''. |
||
<span id="File_format"></span> |
<span id="File_format"></span> |
||
===Format plików==== |
====Format plików==== |
||
[[File_Format_FCStd| |
[[File_Format_FCStd/pl|Format pliku FCStd]]. Pliki tworzone za pomocą FreeCAD to pliki {{incode|.zip}}, które zawierają geometrię [https://en.wikipedia.org/wiki/Boundary_representation BREP], a także dane XML opisujące dokument. |
||
<span id="Sketcher_solver"></span> |
<span id="Sketcher_solver"></span> |
||
====Solver szkicownika==== |
====Solver szkicownika==== |
||
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=36355 |
* [https://forum.freecadweb.org/viewtopic.php?f=10&t=36355 Broszura dotycząca architektury solvera szkicownika] ''(wątek na forum)'', [https://github.com/abdullahtahiriyo/FreeCADBooks/tree/master/FreeCAD_Solver_Architecture źródło] w serwisie GuitHub. |
||
* [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Sketcher/App/planegcs/ PlaneGCS |
* [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Sketcher/App/planegcs/ Solver PlaneGCS] w kodzie źródłowym FreeCAD; ważne pliki to [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Sketcher/App/planegcs/GCS.cpp GCS.cpp] i [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Sketcher/App/planegcs/SubSystem.cpp SubSystem.cpp] |
||
* [https://forum.freecadweb.org/viewtopic.php?f=9&t=29192 |
* [https://forum.freecadweb.org/viewtopic.php?f=9&t=29192 Kilka ostatnich ulepszeń szkicownika]. |
||
Solwer szkicownika nie jest doskonały, ponieważ istnieją pewne problemy z precyzją numeryczną podczas używania dużych wartości, zobacz wątek na forum [https://forum.freecadweb.org/viewtopic.php?f=10&t=40502 Przygoda z naprawianiem solvera szkicownika dla dużych szkiców]. |
|||
Opracowanie nowej architektury solvera mogłoby poprawić sposób jego wykorzystania zarówno w środowisku pracy [[Sketcher_Workbench/pl|Szkicownik]], jak i przy składaniu brył 3D. Zobacz stronę [https://forum.freecadweb.org/viewtopic.php?f=20&t=40525 Reimplementacja wiązań solvera]. |
|||
<span id="Roadmap"></span> |
<span id="Roadmap"></span> |
Revision as of 11:45, 26 March 2023
To jest miejsce, które należy odwiedzić, jeśli chcesz przyczynić się do rozwoju programu FreeCAD.
Te strony są we wczesnej fazie rozwoju. Jeśli nie możesz znaleźć informacji, której szukasz, lub znalazłeś przydatne informacje gdzieś, gdzie nie zamieściliśmy linków, zostaw komentarz na forum, a ktoś się tym zajmie (lub jeśli jesteś odważny, dlaczego nie edytować tej strony bezpośrednio!).
Dokumentacja programisty
Dokumentacja dla programisty składa się z następujących części:
Kompilacja programu FreeCAD
- repozytorium GitHub. Jeśli jesteś nowy w git, przeczytaj Zarządzanie kodem źródłowym
- kompilacja z użyciem Docker
- kompilacja w systemie Linux
- Kompilacja w systemie MacOS
- kompilacja w systemie Windows
- Szczegóły licencji o licencjach programu FreeCAD.
- Biblioteki zewnętrzne
- Narzędzia zewnętrzne
- Uruchomienie i konfiguracja
- Dokumentacja źródłowa
- Użyj bug tracker, gdy masz problem lub myślisz, że mogłeś znaleźć błąd
Przygotowanie pakietów
Paczkowanie polega na pobraniu skompilowanych binariów i plików źródłowych Python programu FreeCAD i rozpowszechnieniu ich w celu wykorzystania w konkretnym systemie.
Narzędzia wspomagające tworzenie wydania
- FreeCAD Narzędzie do kompilacji.
- Tworzenie Środowiska pracy dla programu FreeCAD.
- Debugowanie FreeCAD.
- Testowanie FreeCAD.
- Kompilacja (przyspieszamy) FreeCAD.
- Ciągła integracja.
Modyfikacja programu FreeCAD
- Zrozumienie kodu źródłowego FreeCAD.
- Przesyłanie łatek.
- Dodawanie funkcjonalności do programu FreeCAD lub środowiska pracy.
- FreeCAD jako produkt obcej marki czyli jak nadać programowi FreeCAD unikalny wygląd.
- Opracowanie graficzne, które wykonaliśmy dla programu FreeCAD, a które możesz dowolnie wykorzystać.
- Wytyczne dotyczące grafiki standardy dla ikon.
- Tłumaczenia dla FreeCAD.
- Dodatkowe moduły Python, czyli jak rozszerzyć funkcjonalność pythona w ramach FreeCADa.
- Google Summer of Code zaangażuj się poprzez program wsparcia studentów Google.
- Dostrajanie parametrów pokazuje różne opcje i przełączniki parametrów, które mogą pokonać problemy
- Zawijanie klasy Cplusplus w środowisku Python pokazuje, jak stworzyć w Pythonie wrapper dla klasy C++
- Lista kontrolna dodawania funkcji do środowiska pracy w języku C++ stanowi pomoc dla współtwórców.
Przewodnik dla twórców modułów
FreeCAD Mod Dev Guide: To jest ebook w trakcie pisania na platformie GitHub, proszę rozwidlić i wysłać pull request, aby wnieść swój wkład.
Rozdziały:
- Przegląd i architektura oprogramowania.
- Struktura kodu źródłowego.
- Baza i moduł App.
- Moduł GUI.
- Paczkowanie w Pythonie.
- Modułowa konstrukcja.
- Analiza źródeł modułu MES (mieszane C++ i Python).
- Rozwój modułu CFD (czysty Python).
- Testowanie i debugowanie modułu.
- Współtworzenie kodu za pomocą git.
Najnowszy PDF może być pobrany z tego repo git.
Wewnętrzne
Dokumentacja OpenCascade
OpenCascade to platforma programistyczna do modelowania powierzchniowego i bryłowego 3D, wymiany danych CAD oraz wizualizacji, głównie w postaci bibliotek C++.
- Poradniki Romana Lygina.
- Pełna dokumentacja online.
- Podręcznik referencyjny.
- Wiki dla openCascade (obecnie zawiera ?chiński spam).
Format plików
Format pliku FCStd. Pliki tworzone za pomocą FreeCAD to pliki .zip
, które zawierają geometrię BREP, a także dane XML opisujące dokument.
Solver szkicownika
- Broszura dotycząca architektury solvera szkicownika (wątek na forum), źródło w serwisie GuitHub.
- Solver PlaneGCS w kodzie źródłowym FreeCAD; ważne pliki to GCS.cpp i SubSystem.cpp
- Kilka ostatnich ulepszeń szkicownika.
Solwer szkicownika nie jest doskonały, ponieważ istnieją pewne problemy z precyzją numeryczną podczas używania dużych wartości, zobacz wątek na forum Przygoda z naprawianiem solvera szkicownika dla dużych szkiców.
Opracowanie nowej architektury solvera mogłoby poprawić sposób jego wykorzystania zarówno w środowisku pracy Szkicownik, jak i przy składaniu brył 3D. Zobacz stronę Reimplementacja wiązań solvera.
Plan rozwoju
FreeCAD, choć użyteczny w pewnych obszarach, jest na początku długiej drogi do głównego nurtu CAD. Jest jeszcze wiele do zrobienia aby osiągnąć stan, w którym będziemy mogli konkurować z oprogramowaniem komercyjnym.
Społeczność
- IRC channel ,zsynchronizowany z gitter channel
- Forum programistów
- Uznanie
- Jak zacząć
- Instalacja: Pobieranie programu, Windows, Linux, Mac, Dodatkowych komponentów, Docker, AppImage, Ubuntu Snap
- Podstawy: Informacje na temat FreeCAD, Interfejs użytkownika, Profil nawigacji myszką, Metody wyboru, Nazwa obiektu, Edytor ustawień, Środowiska pracy, Struktura dokumentu, Właściwości, Pomóż w rozwoju FreeCAD, Dotacje
- Pomoc: Poradniki, Wideo poradniki
- Środowiska pracy: Strona Startowa, Architektura, Assembly, CAM, Rysunek Roboczy, MES, Inspekcja, Siatka, OpenSCAD, Część, Projekt Części, Punkty, Inżynieria Wsteczna, Robot, Szkicownik, Arkusz Kalkulacyjny, Start, Powierzchnia 3D, Rysunek Techniczny, Test Framework, Web