Pierwsze kroki w współtworzeniu Blockly

Blockly jest oprogramowaniem open source i jest głównie obsługiwany przez niewielki zespół. Zapraszamy deweloperów spoza głównego zespołu do zgłaszania uwag. Bez pomocy społeczności nie bylibyśmy w stanie tworzyć wszystkich żądanych funkcji ani naprawiać wszystkich zgłoszonych błędów. Ta sekcja zawiera ogólne przewodniki, które mogą być przydatne, zwłaszcza jeśli dopiero zaczynasz zajmować się tworzeniem oprogramowania open source.

Informacje dotyczące Blockly, które należy przeczytać przed wniesieniem wkładu, znajdziesz w sekcji Wnoszenie wkładu do Core i Wnoszenie wkładu do przykładów.

Które repozytorium?

Repozytorium zawiera wszystkie pliki pojedynczego 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, która będzie dotyczyć wszystkich użytkowników biblioteki.

Przykłady w Blockly to repozytorium przykładów, wtyczek i laboratoriów kodu. Użyj tego repozytorium, jeśli chcesz utworzyć lub zmodyfikować wtyczkę, napisać laboratorium kodu lub utworzyć lub zmodyfikować przykład.

Krok po kroku

Oto ogólne czynności, które należy wykonać, aby wprowadzić zmianę.

  1. Zainstaluj Git i Node, korzystając z linków w sekcji Narzędzia.
  2. Utwórz rozwidlenie i sklonuj repozytorium. GitHub udostępnia świetny samouczek na temat tworzenia kopii repozytorium. Aby zastosować go w Blockly, wystarczy zastąpić wszystkie wystąpienia octocat/Spoon-Knife wartościami google/blockly lub google/blockly-samples, w zależności od tego, z którego repozytorium chcesz korzystać.
  3. Zsynchronizuj swoją gałąź. W GitHubie znajdziesz też samouczek dotyczący synchronizowania gałęzi pochodnej.
  4. Sprawdź gałąź główną. W Blockly Core jest to gałąź develop. W 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 pomóc Ci zapamiętać, nad czym pracujesz.
  7. Wprowadź zmiany.
  8. Sprawdź poprawność zmian,postępując zgodnie z instrukcjami dotyczącymi jądra lub próbek.
  9. Zapisz zmiany, klikając git commit -am "fix: My commit message". Więcej informacji o komunikatach zatwierdzania
  10. Prześlij zmiany do GitHuba za pomocą git push origin myBranchName.
  11. Gdy kod będzie gotowy, otwórz prośbę o przechwycenie. Członek zespołu Blockly sprawdzi Twoje zmiany i je złączy z Blockly, jeśli zostaną zatwierdzone. Więcej informacji znajdziesz w artykule Proces sprawdzania treści promocyjnych.