Zacznij publikować w Blockly

Blockly to oprogramowanie typu open source, obsługiwane głównie przez niewielki zespół. Jesteśmy otwarci na opinie twórców spoza podstawowego zespołu. Nie jesteśmy w stanie stworzyć każdej wymaganej funkcji ani naprawić każdego zgłoszonego błędu bez naszej społeczności. Ta sekcja zawiera ogólne przewodniki, które mogą być przydatne, zwłaszcza jeśli dopiero zaczynasz korzystać z rozwiązań open source.

Szczegółowe informacje na temat Blockly, które warto przeczytać przed darowizną, znajdziesz w sekcjach Twój wkład i Udział w próbkach.

Które repozytorium?

Repozytorium zawiera wszystkie pliki przypisane do jednego projektu. Blockly ma 2 repozytoria: blockly core i blockly samples.

Blockly Core to repozytorium biblioteki Blockly. Użyj tego repozytorium, jeśli chcesz zmienić podstawowe działanie aplikacji Blockly w sposób, który będzie stosowany w przypadku wszystkich użytkowników biblioteki.

Przykłady blokowe to repozytorium z przykładami, wtyczkami i laboratoriami. Użyj tego repozytorium, jeśli chcesz utworzyć lub zmodyfikować wtyczkę, napisać ćwiczenia z programowania lub utworzyć lub zmodyfikować przykład.

Krok po kroku

Są to ogólne kroki, które należy wykonać za każdym razem, gdy wprowadzasz zmianę.

  1. Zainstaluj Git i węzeł, klikając linki w sekcji Narzędzia.
  2. Utwórz rozwidlenie i skopiuj repozytorium. Na GitHubie znajdziesz świetny samouczek o tworzeniu repozytorium. Aby zastosować ją do blokad, po prostu zastąp każde wystąpienie octocat/Spoon-Knife ciągiem google/blockly lub google/blockly-samples, w zależności od repozytorium, w którym chcesz pracować.
  3. Zsynchronizuj rozwidlenie. GitHub zawiera też samouczek dotyczący synchronizowania rozwidlenia.
  4. Zapoznaj się z gałęzią główną W bloku podstawowym jest to gałąź develop. W przykładach blokowych ta gałąź to master.
  5. Zainstaluj zależności i utwórz narzędzia, uruchamiając npm install w katalogu głównym.
  6. Utwórz nową gałąź, uruchamiając git checkout -b myBranchName w terminalu. Nazwa powinna pomóc Ci zapamiętać, nad czym pracujesz.
  7. Wprowadź zmiany.
  8. Sprawdź zmiany zgodnie z przewodnikiem po kluczach lub przykładach.
  9. Zapisz zmiany w git commit -am "fix: My commit message". Więcej informacji o komunikatach zatwierdzania
  10. Przekaż zmiany na GitHubie za pomocą git push origin myBranchName.
  11. Otwórz żądanie pull, gdy kod będzie gotowy. Członek zespołu Blockly sprawdzi Twoje zmiany i scali je w Blockly, jeśli zostaną zatwierdzone. Więcej informacji znajdziesz w artykule o procedurze PR.