Inizia a contribuire a Blockly

Blockly è open source e viene gestito principalmente da un piccolo team. Accogliamo con favore i contributi degli sviluppatori esterni al team principale. Senza la nostra community, non potremmo creare tutte le funzionalità richieste o correggere tutti i bug segnalati. Questa sezione contiene guide generali che possono esserti utili, soprattutto se non hai mai sviluppato progetti open source.

Per informazioni specifiche su Blockly da leggere prima di dare un contributo, consulta le sezioni Contributo al core e Contributo agli esempi.

Quale repository?

Un repository contiene tutti i file di un singolo progetto. Blockly ha due repository: blockly core e blockly-samples.

Blockly core è il repository della libreria Blockly. Utilizza questo repository se vuoi apportare una modifica al comportamento principale di Blockly in modo che venga applicata a tutti gli utenti della libreria.

Esempi di Blockly è il repository per esempi, plug-in e codelab. Utilizza questo repository se vuoi creare o modificare un plug-in, scrivere un codelab o creare o modificare un esempio.

Storia passo passo

Questi sono i passaggi generali che seguirai ogni volta che apporti una modifica.

  1. Installa Git e Node seguendo i link nella sezione Strumenti.
  2. Crea un fork e clona il repository. GitHub offre un ottimo tutorial su come creare un fork di un repository. Per applicarlo a Blockly, sostituisci ogni istanza di octocat/Spoon-Knife con RaspberryPiFoundation/blockly o RaspberryPiFoundation/blockly-samples, a seconda del repository in cui vuoi lavorare.
  3. Sincronizza la forchetta. GitHub fornisce anche un tutorial per sincronizzare un fork.
  4. Dai un'occhiata al ramo principale. Nel core di Blockly, questo è il ramo develop. In blockly-samples questo è il ramo master.
  5. Installa le dipendenze e gli strumenti di creazione eseguendo npm install nella directory principale.
  6. Crea un nuovo ramo eseguendo git checkout -b myBranchName in un terminale. Il nome deve aiutarti a ricordare a cosa stai lavorando.
  7. Apporta le modifiche.
  8. Convalida le modifiche seguendo la guida per core o samples.
  9. Salva le modifiche con git commit -am "fix: My commit message". Scopri di più sui messaggi di commit.
  10. Esegui il push delle modifiche su GitHub con git push origin myBranchName.
  11. Apri una richiesta di pull quando il codice è pronto. Un membro del team di Blockly esaminerà le modifiche e le incorporerà in Blockly se vengono approvate. Per saperne di più, consulta Procedura di revisione delle PR.