Omówienie
Każdy plik PicoPixel ma własną bibliotekę: kolory, czcionki, obrazy, animacje klatkowe i komponenty, zebrane w panelu Assets. Sama w sobie ta biblioteka należy do jednego pliku. Opublikowanie pliku zmienia ją w coś, czego mogą używać członkowie zespołu: podłącz ją z innego pliku, a jej zasoby pojawią się obok zasobów tego pliku.
Ten przewodnik wyjaśnia, czym jest biblioteka, co dokładnie robi Publish (i równie ważne, czego nie robi), jak publikować i podłączać biblioteki oraz gdzie je znaleźć. Najważniejsza rzecz do zapamiętania:
Publikowanie nie upublicznia Twojej pracy. Publish sprawia, że biblioteka pliku jest dostępna ponownie tylko dla Twojego zespołu, czyli członków Twojego obszaru roboczego PicoPixel. Nigdy nie jest publikowana w internecie, nigdy nie trafia na publiczną listę i nigdy nie jest widoczna dla nikogo spoza zespołu. Jedyne sposoby, w jakie treść opuszcza zespół, to działania, które Ty wykonujesz świadomie, opisane na końcu przewodnika.
Czym jest biblioteka
Biblioteka to zestaw zasobów zapisanych w pliku, z których można korzystać wielokrotnie. W panelu Assets zobaczysz własne zasoby pliku pod local library; zawsze tam jest i otwiera się domyślnie.
Gdy podłączysz inną bibliotekę zespołu do pliku, pojawi się jako druga, osobno nazwana sekcja poniżej lokalnej biblioteki, z nagłówkiem będącym nazwą pliku biblioteki (np. Animation Examples). Po podłączeniu panel Assets pokazuje więc zarówno własne zasoby pliku, jak i zasoby podłączonej biblioteki, obok siebie i gotowe do przeciągnięcia.
Pomyśl o tym jak o dwóch półkach w tej samej szafce: local library to zasoby utworzone w bieżącym pliku, a każda podłączona biblioteka to półka pożyczona z innego pliku zespołu. Możesz brać z obu bez opuszczania projektu.
Co może zawierać biblioteka
Publikacja biblioteki obejmuje wszystkie zasoby widoczne w panelu Assets tego pliku. PicoPixel grupuje zasoby w tych sekcjach:
- Images, statyczne grafiki dodane do pliku.
- Animated images, wieloklatkowe animowane grafiki.
- Components, widżety LVGL wielokrotnego użytku (zobacz niżej).
- Colors, zapisane próbki kolorów.
- Fonts, czcionki dodane i przekonwertowane do użycia na urządzeniu.
Opublikuj plik, a każdy z tych zasobów będzie dostępny do ponownego wykorzystania przez zespół, bez kopiowania między plikami.
Czym jest komponent
Component to klocek wielokrotnego użytku złożony z jednego albo wielu widżetów. Przycisk czy etykieta to pojedynczy widżet. Komponent może łączyć kilka widżetów i warstw, na przykład kartę z tytułem, ikoną i wartością. Całość wstawiasz na ekran jako jeden element.
Każdy komponent ma main instance, czyli główny egzemplarz. Wprowadzone w nim zmiany można zastosować we wszystkich kopiach komponentu, również w innych plikach korzystających z biblioteki. Dzięki temu łatwiej zachować spójność interfejsu: tworzysz element raz, używasz go w wielu miejscach i aktualizujesz u źródła.
Jeśli na kolejnych ekranach odtwarzasz ten sam nagłówek, kafel z pomiarem czy przełącznik z opisem, zapisz go jako komponent. Wtedy jego wygląd na wszystkich ekranach będzie spójny.
Publikowanie pliku jako biblioteki
Publikacja oznacza plik jako bibliotekę dostępną dla zespołu.
- Otwórz dialog Libraries. Z panelu Assets użyj przycisku Add library (gdy plik ma już podłączone biblioteki albo komponenty, będzie brzmiał Manage library).
- Na karcie LIBRARIES znajdź LIBRARIES IN THIS FILE. Zobaczysz File library, czyli bibliotekę bieżącego pliku, z przyciskiem Publish obok.
- Kliknij Publish.
Przycisk zmieni się na Unpublish, potwierdzając, że plik jest teraz współdzieloną biblioteką, którą zespół może podłączać. PicoPixel dodaje też mały znaczek biblioteki do pliku: zobaczysz go w prawym górnym rogu nagłówka obszaru roboczego oraz na karcie pliku w Dashboard, więc łatwo rozpoznać pliki opublikowane.
Po kliknięciu Unpublish PicoPixel poprosi o potwierdzenie wycofania biblioteki. PicoPixel najpierw kopiuje zasoby biblioteki do każdego pliku, który jej używał, więc pliki zależne nie tracą nagle tego, na czym polegały.
Znajdowanie bibliotek zespołu
Opublikowane biblioteki są zebrane w jednym miejscu dla całego zespołu.
- Otwórz Dashboard.
- W lewym pasku bocznym pod Sources kliknij Libraries.
Na tej stronie znajdziesz biblioteki opublikowane w aktualnie wybranym zespole. Aby zobaczyć biblioteki innego zespołu, przełącz się na niego. To katalog, który członkowie zespołu przeglądają, aby zobaczyć, co można ponownie wykorzystać.
Używanie biblioteki w innym pliku
Opublikowaną bibliotekę można podłączyć w dowolnym pliku zespołu.
- Otwórz plik, w którym chcesz budować.
- W panelu Assets kliknij Add library (albo Manage library), aby otworzyć dialog Libraries.
- W sekcji SHARED LIBRARIES znajdź bibliotekę; pole Search shared libraries pomaga przy długiej liście. Kliknij + obok niej, aby ją podłączyć.
Podłączona biblioteka pojawi się teraz w panelu Assets jako własna nazwana sekcja, pod local library. Przeciągaj jej komponenty, obrazy, kolory i czcionki prosto do projektu.
Aktualizowanie podłączonej biblioteki
Gdy właściciel zmieni komponent lub kolor w bibliotece, aktualizacja nie zostanie automatycznie zastosowana w Twoim pliku. Karta UPDATES w dialogu Libraries wyświetla podłączone biblioteki z nowszymi zmianami, a przycisk Update stosuje je do pliku, gdy będziesz gotowy. Jeśli nic się nie zmieniło, karta po prostu powie, że nie ma nic do aktualizacji.
Prywatność: nic tutaj nigdy nie staje się publiczne
Tę część warto powtórzyć, bo słowo Publish brzmi szerzej, niż naprawdę działa.
Publikowanie biblioteki udostępnia ją zespołowi i nikomu innemu. Dostęp jest uwierzytelniony i ograniczony do zespołu: nie ma publicznego linku, publicznej listy ani sposobu, aby ktoś spoza zespołu dostał się do opublikowanej biblioteki. "Published" oznacza tutaj wyłącznie dostępność dla członków Twojego zespołu.
Utworzone przez Ciebie materiały mogą trafić poza zespół na dwa sposoby. Oba wymagają Twojego świadomego działania:
- Eksportujesz i wysyłasz plik
.picopixelsamodzielnie. Z menu obszaru roboczego możesz użyć Export.picopixel, co pobiera plik na komputer. To Ty decydujesz, czy wyślesz plik e-mailem lub udostępnisz go komuś w inny sposób. Dzieje się to poza PicoPixel. - Zgłaszasz projekt zespołowi PicoPixel do publikacji. Jeśli chcesz udostępnić projekt szerszej społeczności PicoPixel, prześlij go do sprawdzenia pod
app.picopixel.io/#/settings/submit-template. Zespół sprawdza każde zgłoszenie, zanim coś zostanie opublikowane w galerii społeczności. Zobacz Jak przesłać szablon, aby poznać wymagania formularza i prawa, których udzielasz.
Poza tymi dwoma świadomymi krokami pliki i biblioteki zostają w zespole.
Szablony społeczności i gotowe biblioteki
Nie musisz zaczynać od zera. Galeria szablonów PicoPixel ma rosnącą kolekcję szablonów, zestawów UI, przykładów, sprite'ów, animacje klatkowe i pełnych plików aplikacji tworzonych przez zespół PicoPixel oraz społeczność. Każdy z nich to zwykły plik .picopixel, który możesz otworzyć, dostosować i użyć jako punkt startowy własnego projektu.
Każdy otwarty szablon może też stać się biblioteką: opublikuj go, a zespół zyska dostęp do jego komponentów, czcionek, kolorów i obrazów bez tworzenia ich od nowa. To najszybszy sposób na start nowego projektu albo dodanie dopracowanych elementów do istniejącego.
Instrukcję krok po kroku znajdowania, importowania i dostosowywania szablonów znajdziesz w Jak używać szablonów PicoPixel, zestawów UI i pełnych aplikacji.
Dokąd dalej
- Jak przesłać szablon, udostępnij projekt szerszej społeczności PicoPixel
- Czym jest sprite?, twórz animowane widżety z wieloma stanami i zapisuj je jako komponenty
- Praca z czcionkami, dodawaj i konwertuj czcionki udostępniane przez bibliotekę
- Praca z widżetem LVGL Animated Image, twórz animacje klatkowe do ponownego użycia między plikami
