CLI

Użyj CLI Nowly, aby tworzyć, budować, walidować i testować obecności lokalnie.

CLI Nowly jest publikowane na npm jako @nowly/cli. Zainstaluj je globalnie:

pnpm i -g @nowly/cli

Tryb interaktywny

Uruchom CLI bez argumentów, aby otworzyć interaktywne menu:

nowly

Tworzenie obecności

nowly init "Netflix"

Interaktywne pytanie sprawdza, czy Discord już obsługuje platformę, jeśli użytkownik połączy swoje konto. Powoduje to zapisanie discordNative w metadata.json. Możesz też przekazać je ręcznie:

nowly init "Spotify" --discord-native

Budowanie obecności

Zbuduj wszystkie obecności:

nowly build

Zbuduj jedną obecność:

nowly build youtube

Przebuduj przy zmianach plików (przeładuj rozpakowane rozszerzenie po każdym przebudowaniu lub ponownie upuść plik zip, jeśli używasz pack):

nowly build youtube --watch
nowly pack youtube --watch

Testowanie obecności lokalnie

Istnieją dwa sposoby wczytania zbudowanej obecności bez API Nowly. Pełny przewodnik: Wczytywanie i testowanie lokalne.

Gotowe rozszerzenie

Jeśli tylko sklonowałeś repozytorium presences (typowy przypadek dla współtwórców), użyj nowly extension, aby uzyskać gotowy build deweloperski bez pełnego monorepo nowly:

nowly build youtube
nowly extension youtube             # Chrome (domyślnie)
nowly extension youtube --firefox
nowly extension youtube --f         # Alias Firefox

Pobierany jest odpowiedni deweloperski build Chrome lub Firefox z CDN, wbudowywane są wymienione obecności i zapisywany jest plik dev-presences.json. Następnie:

1. Chrome: Otwórz chrome://extensions, włącz Tryb programisty i wybierz Wczytaj rozpakowane → dist/extension-dev
2. Firefox: Otwórz about:debugging#/runtime/this-firefox, wybierz This Firefox, kliknij Load Temporary Add-on... i wybierz dist/extension-dev-firefox/manifest.json

Po edycji obecności przebuduj ją, uruchom ponownie nowly extension <slug> i przeładuj rozszerzenie.

Użyj --chrome / --c dla Chrome lub --firefox / --f dla Firefoksa. Opcji nie można używać jednocześnie.

Aby użyć konkretnego lokalnego buildu rozszerzenia zamiast wersji z CDN, przekaż --from:

nowly extension youtube --chrome --from ../nowly/apps/extension/dist/chrome
nowly extension youtube --firefox --from ../nowly/apps/extension/dist/firefox

Upuszczenie pliku zip

Jeśli Nowly jest już wczytane jako rozpakowany build deweloperski, spakuj obecność i upuść ją w panelu debugowania:

nowly pack youtube

Zip jest zapisywany do dist/packs/youtube.zip. Upuść go w Ustawienia → Zaawansowane → Debugowanie. Niepodpisane pliki zip działają tylko na rozpakowanych buildach, a nie na instalacjach ze sklepu Chrome Web Store. Tryb programisty ujawnia UI debugowania.

Jeśli masz pełne monorepo

Jeśli sklonowałeś samo nowly i uruchomiłeś pnpm repos (klonuje presences do packages/presences), możesz zbudować rozszerzenie ze wszystkimi obecnościami bezpośrednio:

pnpm build:extension:dev --bundled

Po każdej zmianie przebuduj zmienioną obecność, a następnie rozszerzenie:

nowly build youtube
pnpm build:extension:dev --bundled

Przeładuj w chrome://extensions - obecność jest już zainstalowana i gotowa do użycia.

Lista obecności

nowly list

Walidacja metadanych

nowly validate