avalonia-zafiro-development
Reguły i konwencje dla tworzenia aplikacji Avalonia z toolkitem Zafiro
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill definiujący obowiązkowe standardy i zasady zachowania dla rozwoju aplikacji cross-platform z użyciem Avalonia UI i Zafiro. Zawiera wytyczne dotyczące funkcyjno-reaktywnego MVVM, bezpiecznej obsługi błędów za pomocą typów Result, niezależności ViewModeli od platformy oraz maksymalnego wykorzystania abstrakcji Zafiro. Dokumentacja obejmuje zasady architektoniczne, konwencje nazewnictwa, reguły reaktywne oraz gotowe wzorce implementacyjne.
Jak używać
Zapoznaj się z czterema filarami podejścia: funkcyjno-reaktywnym MVVM, bezpieczeństwem i przewidywalnością poprzez Result types, niezależnością ViewModeli od platformy Avalonia oraz pierwszeństwem Zafiro — te zasady stanowią fundament każdego projektu.
Przed napisaniem kodu przeszukaj istniejący kod źródłowy w poszukiwaniu podobnych implementacji lub dostępnych helperów Zafiro, aby uniknąć duplikacji i konsekwentnie stosować już ustalone wzorce.
Jeśli brakuje ci helpera, zamiast wpisywać złożoną logikę inline, zaproponuj nową metodę rozszerzającą, którą będzie można ponownie wykorzystać w innych miejscach projektu.
Stosuj DynamicData operators zamiast zwykłych Rx do budowania reaktywnych pipelinów — to zapewnia lepszą wydajność i czytelność kodu.
Zapoznaj się z dokumentacją zawartą w repozytorium: przeczytaj Core Technical Skills & Architecture, Naming & Coding Standards, Avalonia, Zafiro & Reactive Rules, Zafiro Shortcuts oraz Common Patterns, aby w pełni zrozumieć konwencje projektu.
Stosuj jawną obsługę błędów z użyciem Result types zamiast wyjątków do kontroli przepływu, a upewnij się, że ViewModele są całkowicie niezależne od Avalonia — używaj kompozycji zamiast dziedziczenia.