Pierwsze kroki w współtworzeniu Blockly

Blockly to projekt open source, który jest utrzymywany głównie przez niewielki zespół. Cieszymy się z pomocy deweloperów spoza głównego zespołu. Bez naszej społeczności nie bylibyśmy w stanie wdrożyć wszystkich zgłaszanych funkcji ani naprawić wszystkich zgłaszanych błędów. Ta sekcja zawiera ogólne przewodniki, które mogą być przydatne, zwłaszcza jeśli dopiero zaczynasz przygodę z rozwojem oprogramowania typu open source.

Informacje dotyczące Blockly, które warto przeczytać przed przesłaniem propozycji, znajdziesz w sekcjach Współtworzenie podstawowych funkcji i Współtworzenie przykładów.

Które repozytorium?

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

Blockly core to repozytorium biblioteki Blockly. Użyj tego repozytorium, jeśli chcesz wprowadzić zmianę w podstawowym działaniu Blockly w sposób, który będzie dotyczyć wszystkich użytkowników biblioteki.

Przykłady Blockly to repozytorium przykładów, wtyczek i ćwiczeń z programowania. Skorzystaj z tego repozytorium, jeśli chcesz utworzyć lub zmodyfikować wtyczkę, napisać codelab albo utworzyć lub zmodyfikować przykład.

Krok po kroku

To ogólne kroki, które należy wykonać przy każdej zmianie.

  1. Zainstaluj Git i Node, korzystając z linków w sekcji Narzędzia.
  2. Utwórz rozwidlenie i sklonuj repozytorium. GitHub ma świetny samouczek na temat tworzenia forka repozytorium. Aby zastosować go w przypadku Blockly, zastąp wszystkie wystąpienia ciągu octocat/Spoon-Knife ciągiem RaspberryPiFoundation/blockly lub RaspberryPiFoundation/blockly-samples, w zależności od tego, w którym repozytorium chcesz pracować.
  3. Zsynchronizuj forka. GitHub udostępnia też samouczek dotyczący synchronizowania rozwidlenia.
  4. Sprawdź główną gałąź. W bibliotece Blockly Core jest to gałąź develop. W repozytorium blockly-samples jest to gałąź master.
  5. Zainstaluj zależności i narzędzia do kompilacji, uruchamiając npm install w katalogu głównym.
  6. Utwórz nową gałąź, uruchamiając git checkout -b myBranchName w terminalu. Nazwa powinna pomagać Ci pamiętać, nad czym pracujesz.
  7. Wprowadź zmiany.
  8. Sprawdź zmiany,postępując zgodnie z przewodnikiem dotyczącym podstawowych lub przykładowych danych.
  9. Zapisz zmiany za pomocą git commit -am "fix: My commit message". Więcej informacji o komunikatach zatwierdzenia
  10. Przekaż zmiany do GitHuba za pomocą polecenia git push origin myBranchName.
  11. Gdy kod będzie gotowy, otwórz żądanie scalenia. Członek zespołu Blockly sprawdzi Twoje zmiany i w razie ich zatwierdzenia włączy je do Blockly. Więcej informacji znajdziesz w artykule Proces sprawdzania PR.