Współtworzenie fragmentów

Przykłady Blockly zawierają dodatkowe treści związane z Blockly, które nie są częścią głównego repozytorium, w tym wtyczki, Codelabs i przykładowy kod. Więcej informacji o każdej z nich znajdziesz na stronie struktury repozytorium.

Co musisz wiedzieć

Oto krótki przegląd faktów o blockly-samples, które musisz znać, aby utworzyć PR.

  • Gałąź robocza to master, a wszystkie PR powinny być tworzone w gałęzi master.
  • Uruchom npm install na poziomie głównym w blockly-samples,a nie na poziomie poszczególnych wtyczek. Blockly-samples to repozytorium mono, co oznacza, że zawiera ono wiele pakietów w tym samym repozytorium. Instalowanie na poziomie katalogu głównego jest częścią procesu zarządzania repozytorium mono za pomocą Lerna.
  • Kod musi być zgodny ze Style Guidem JavaScript lub Style Guidem TypeScript Google, w zależności od używanego języka.
  • W wiadomościach o zatwierdzeniach i tytułach prośby o przechwycenie używaj tradycyjnych zatwierdzeń.

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

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

Wprowadzanie i weryfikowanie zmiany

  1. Uruchom npm install na poziomie głównym blockly-samples, aby zainstalować zależności.
  2. Uruchom npm run start w katalogu wtyczki, aby skompilować i uruchomić serwer z testową stroną wtyczki. Możesz użyć tej strony, aby sprawdzić obecne działanie wtyczki. Jeśli dodajesz nową wtyczkę, musisz utworzyć tę stronę testową, aby inni użytkownicy mogli sprawdzić, do czego służy. Więcej informacji znajdziesz na stronie playground.
  3. Wprowadź w kodzie wtyczki wszelkie niezbędne zmiany.
  4. Jeśli serwer jest uruchomiony, zmiany zostaną załadowane automatycznie. W przeciwnym razie uruchom ponownie serwer i sprawdź, czy wtyczka działa zgodnie z oczekiwaniami i czy w konsoli nie ma żadnych błędów ani ostrzeżeń.
  5. Uruchom npm run build i upewnij się, że nie ma błędów kompilacji.
  6. Napisać automatyczne testy Mocha w katalogu test/.
  7. Aby przeprowadzić testy zautomatyzowane, kliknij npm run test.
  8. Uruchom npm run lint:fix, aby naprawić błędy lint. Usuń pozostałe ostrzeżenia lub błędy.
  9. Uruchom npm run format, aby uruchomić automatyczny formatowanie.
  10. Jeśli wszystkie testy zostaną zaliczone, możesz otworzyć PR w gałęzi master z wprowadzonymi zmianami.