Debugowanie społecznościowego oprogramowania sprzęgającego

Oprogramowanie sprzęgające społeczności możesz debugować na 2 sposoby:

  1. Włączanie rozszerzonych komunikatów o błędach
  2. Logowanie odpowiednich danych o uruchomieniu

Z tego przewodnika dowiesz się, jak skutecznie korzystać z tych funkcji.

Włączanie i wyłączanie funkcji debugowania

Funkcja isAdminUser() powinna zwracać wartość true, jeśli bieżący użytkownik powinien widzieć komunikaty debugowania i zrzuty stosu. Jeśli isAdminUser() zwróci wartość false (fałsz) lub nie zostanie zdefiniowana i wystąpi błąd, użytkownik zobaczy ogólny komunikat o błędzie.

Wskazówki dotyczące debugowania

  • Zaprojektuj isAdminUser() tak, aby zawsze zwracał wartość true dla deweloperów.
  • Użyj getEffectiveUser() w połączeniu z listą bezpiecznych adresów e-mail zaufanych użytkowników, aby łatwo dodawać lub usuwać użytkowników, którzy powinni widzieć pełne szczegóły błędu. Jest to szczególnie przydatne, gdy użytkownik napotka błąd, który sprawia problemy z odtworzeniem treści.
  • Zacznij liberalnie korzystać z metody newDebugError() w przypadku niezmienników, które powinny być prawdziwe. Może to pomóc w znalezieniu ewentualnych problemów w przyszłości.

Rejestrowanie skryptu Apps Script

Apps Script udostępnia różne mechanizmy logowania, w tym wbudowane Apps Script Logger, Stackdriver Logging i Stackdriver Error Reporting. Możesz też spróbować zalogować się w Arkuszu Google. Proaktywne logowanie może pomóc w szybkim identyfikowaniu przyczyn błędów, ale uważaj, aby nie rejestrować poufnych danych użytkownika.