Inizia a contribuire a Blockly

Blockly è open source ed è gestito principalmente da un piccolo team. Accogliamo con favore i contributi degli sviluppatori esterni al team principale. Senza la nostra community, non potremmo sviluppare tutte le funzionalità richieste o correggere tutti i bug segnalati. Questa sezione contiene guide generali che potrebbero esserti utili, soprattutto se non hai esperienza con lo sviluppo open source.

Per informazioni specifiche su Blockly che devi leggere prima di apportare un contributo, consulta le sezioni Contribuire al progetto principale e Contribuire ai Samples.

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 di base di Blockly in modo che venga applicata a tutti gli utenti della libreria.

Blockly Samples è 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 sample.

Procedura dettagliata

Questi sono i passaggi generali da seguire 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 tutorial eccezionale su come eseguire il fork di un repository. Per applicarlo a Blockly, sostituisci ogni istanza di octocat/Spoon-Knife con google/blockly o google/blockly-samples, a seconda del repository in cui vuoi lavorare.
  3. Sincronizza il fork. GitHub fornisce anche un tutorial per la sincronizzazione di un fork.
  4. Dai un'occhiata al ramo principale. In Blockly Core, questo è il ramo develop. In blockly-samples si tratta del ramo master.
  5. Installa le dipendenze e gli strumenti di compilazione eseguendo npm install nella directory principale.
  6. Crea un nuovo ramo eseguendo git checkout -b myBranchName in un terminal. 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 pull quando il codice è pronto. Un membro del team di Blockly esaminerà le modifiche e le unirà a Blockly se vengono approvate. Per saperne di più, consulta la procedura di revisione delle RP.