Przejdź do głównej treści
Fabled

Twórca modułu

Rozwiązywanie problemów z interfejsem CLI modułu

Odwzoruj błędy sprawdzania poprawności, archiwizacji, uwierzytelniania, sieci i przeglądu na bezpieczny następny krok.

Weryfikacja nie powiodła się

  • Uruchom moduł sprawdzania poprawności. --json i użyj kodu błędu oraz wskaźnika JSON, aby znaleźć pole manifestu lub zasobu.
  • Jeśli brakuje manifestu, zmień jego nazwę na fabled.module.json. Usuń starszy plik fabled-module.json, jeśli oba istnieją.
  • Zaktualizuj zadeklarowane bajty i sha256 każdego zasobu po edycji. pakiet modułów sprawdza te deklaracje i oblicza ostateczny skrót archiwum; nie przepisuje deklaracji źródłowych.
  • Sprawdź składnię identyfikatora pakietu/wydawcy, dokładne wersje semantyczne, obsługiwane kombinacje miejsca docelowego/gniazda, zgodę na możliwości, znaczniki ustawień regionalnych, odniesienia do wkładu i ciągłe migracje.

Inspekcja archiwum nie powiodła się

Odtwórz artefakt za pomocą pakietu modułów. Narzędzia ZIP ogólnego przeznaczenia mogą dodawać kompresję, komentarze, metadane platformy, łącza, zduplikowane/kolidujące wielkości liter nazwy lub deskryptory danych odrzucane przez bezpieczny profil. Trzymaj archiwum poniżej 5 MiB, każdy wpis poniżej 1 MiB, a liczba wpisów na poziomie 128 lub mniej.

Logowanie lub zapisanie danych uwierzytelniających nie powiodło się

  • Wygeneruj nowy kod w Koncie → Bezpieczeństwo. Kody tracą ważność po 120 sekundach i działają jednorazowo.
  • Wklej tylko dokładny identyfikator URI fabled://module-cli lub 43-znakowy kod. Nie podawaj tego jako argumentu.
  • Wyloguj się z CLI i zaloguj ponownie, jeśli sesja wygasła, została odrzucona lub używa starego formatu wersji 1. Ponów nieudane unieważnienie na serwerze przed usunięciem ważnego pliku poświadczeń. Usunięcie starego pliku nie unieważnia jego sesji Firebase.
  • W systemie POSIX ustaw katalog nadrzędny na prywatną własność/uprawnienia, a plik danych uwierzytelniających na 0600. W systemie Windows użyj ścieżki prywatnego profilu użytkownika chronionej przez listę ACL.
  • W środowisku lokalnym ustaw FABLED_API_URL na odpowiedni backend pętli zwrotnej i wygeneruj kod na lokalnej stronie konta Fabled. CLI nie wymaga klucza internetowego Firebase. Nadal używaj originu API wybranego podczas parowania.

Publikowanie lub sprawdzanie nie powiodło się

  • 401/403: zaloguj się ponownie lub potwierdź, że dostarczony token automatyzacji ma dostęp do wydawcy/zgłoszenia.
  • 409: nie wymyślaj nowego identyfikatora żądania po niepewnej odpowiedzi. Spróbuj ponownie użyć tego samego artefaktu z wydrukowanym --request-id; prawdziwy niezmienny konflikt wymaga nowej wersji lub poprawionej przestrzeni nazw.
  • 413: zmniejsz zadeklarowane aktywa i przepakuj poniżej limitu 5 MiB.
  • CHANGES_REQUESTED: przeczytaj uwagi recenzenta, automatyczne ustalenia i ostrzeżenia w statusie modułu --json, zmień projekt, zwiększ wersję niemodyfikowalną, zatwierdź, spakuj i prześlij ponownie.
  • Prawidłowe polecenie CLI może być nadal niedostępne, gdy jego brama usługi beta jest wyłączona. Tego problemu nie można rozwiązać poprzez osłabienie manifestu lub poświadczeń.

Moduł został pobrany, ale nie działa

  • Nabycie przyznaje jedynie uprawnienia. Otwórz bibliotekę kont, wybierz opcję Zainstaluj, zaakceptuj dokładnie oferowane warunki wydania, a następnie wybierz opcję Aktywuj dla kwalifikującego się modułu kierowanego na konto.
  • Jeśli instalacja jest niedostępna, potwierdź, że pakiet i wydanie są aktywne i sprawdzone, uprawnienia są aktywne i bramka wdrażania instalacji jest włączona.
  • Jeśli opcja Aktywuj jest niedostępna, sprawdź zaakceptowaną wersję, zgodność hosta, zależności, zasady środowiska wykonawczego, podpisy i bramkę wdrożenia aktywacji.
  • Aby aktywować moduł społeczności w kampanii, sprawdź wdrożenie odpowiedniego backendu, zaakceptowanie warunków dokładnie zainstalowanego wydania oraz aktywne uprawnienie ADMIN_GRANT lub FREE_ACQUISITION. Tylko konkretny właściciel kampanii może aktywować lub wyłączać moduły.