Przekaż darowiznę

Blockly Samples zawiera dodatkowe treści związane z Blockly, które nie są częścią głównego repozytorium, w tym wtyczki, ćwiczenia z programowania i przykładowy kod. Więcej informacji o każdym z nich znajdziesz na stronie Struktura repozytorium.

Co musisz wiedzieć

Oto krótki przegląd faktów na temat fragmentów blokowych, które musisz znać, aby stworzyć PR.

  • Gałąź działająca to główna, a wszystkie PR powinny być wystawiane względem gałęzi głównej.
  • Uruchom npm install na poziomie głównym blockly-samples,a nie na poziomie poszczególnych wtyczek. Blockly-samples to monorepozytorium, które zawiera wiele pakietów w tym samym repozytorium. Instalacja na poziomie głównym jest częścią przepływu pracy związanej z zarządzaniem monorepozytorium za pomocą Lerna.
  • Kod musi być zgodny ze wskazówkami Google JavaScript Style Guide lub TypeScript Style Guide (w zależności od używanego języka).
  • Używaj zatwierdzeń konwencjonalnych w wiadomościach zatwierdzania i tytułów żądań pull.

  • Wszystkie nowe pliki kodu muszą mieć prefiks Apache License w wersji 2.0:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

Wprowadzanie i potwierdzanie zmiany

  1. Aby zainstalować zależności, uruchom npm install na poziomie głównym fragmentów blokowych.
  2. Uruchom polecenie npm run start w katalogu wtyczki, aby skompilować i uruchomić serwer, na którym jest uruchomiona strona testowa wtyczki. Na tej stronie sprawdzisz dotychczasowe działanie wtyczki. Jeśli dodajesz nową wtyczkę, musisz przygotować jej przydatną stronę testową, na której inni będą mogli zobaczyć, jak działa. Więcej informacji znajdziesz na playground.
  3. Wprowadź niezbędne zmiany w kodzie wtyczki.
  4. Jeśli serwer pozostanie uruchomiony, zmiany zostaną wczytane automatycznie. W przeciwnym razie ponownie uruchom serwer i sprawdź, czy wtyczka działa zgodnie z oczekiwaniami, a w konsoli nie wyświetlają się żadne błędy ani ostrzeżenia.
  5. Uruchom npm run build i upewnij się, że nie ma błędów kompilacji.
  6. Zapisz automatyczne testy mokki w katalogu test/.
  7. Uruchom npm run test, aby uruchomić testy automatyczne.
  8. Uruchom npm run lint:fix, aby naprawić błędy linta. Usuń pozostałe ostrzeżenia i błędy.
  9. Uruchom npm run format, aby uruchomić autoformatowanie.
  10. Jeśli wszystkie testy zakończą się powodzeniem, będzie można otworzyć PR dotyczący mastera ze zmianami.