sfsymbol-generator

Narzędzie do automatycznego generowania zasobów SF Symbol dla projektów Xcode. Przekształca pliki SVG na gotowe katalogi .symbolset z poprawnym formatem Contents.json i wektorami. Idealne, gdy chcesz dodać własne ikony do aplikacji iOS — obsługuje zarówno proste konwersje, jak i zaawansowane wstrzykiwanie do szablonów SF Symbols. Wymaga SVG z viewBox i ścieżkami wektorowymi; preferuje kształty wypełnione bez obrysu.

1. Przygotuj plik SVG zawierający viewBox i kształty oparte na ścieżkach wektorowych (paths). Jeśli używasz prostokątów, zostaną one automatycznie przekonwertowane; inne kształty powinny być wcześniej zamienione na ścieżki. Preferuj wypełnione kształty bez obrysów, aby uniknąć artefaktów.

2. Umieść plik SVG w dostępnej lokalizacji na dysku, np. /Users/admin/Desktop/moja-ikona.svg.

3. Uruchom skrypt generujący z szablonu: ./scripts/generate-from-template.js nazwa.ikony /ścieżka/do/pliku.svg. Skrypt automatycznie znajdzie szablon SF Symbols w katalogu Assets.xcassets/Symbols lub użyje wbudowanego szablonu.

4. Opcjonalnie wskaż własny szablon SF Symbols jako trzeci argument: ./scripts/generate-from-template.js nazwa.ikony /ścieżka/do/pliku.svg /ścieżka/do/szablonu.svg.

5. Jeśli chcesz zmienić domyślną lokalizację katalogu zasobów, ustaw zmienną środowiskową SFSYMBOL_ASSETS_DIR przed uruchomieniem skryptu.

6. Skrypt waliduje SVG, oblicza granice ścieżek, centruje je w marginesach szablonu SF Symbols, wstrzykuje wektory do wariantów (Ultralight/Regular/Black) i tworzy folder nazwa.ikony.symbolset w katalogu Symbols projektu Xcode.