Inizia a contribuire a Blockly

Blockly è open source ed è gestito principalmente da un piccolo team. Apprezziamo i contributi degli sviluppatori al di fuori del team principale; non c'è modo di creare tutte le funzionalità richieste o di correggere ogni bug segnalato senza la nostra community. Questa sezione contiene guide generali che potrebbero esserti utili, soprattutto se non hai esperienza con lo sviluppo open source.

Per informazioni specifiche di Blockly che devi leggere prima di dare un contributo, consulta le sezioni Contributo a core e Contributo a esempi.

Quale repository?

Un repository contiene tutti i file per un singolo progetto. Blocchi ha due repository: campioni a blocchi e campioni a blocchi.

Blockly core è il repository per la libreria Blockly. Utilizza questo repository se vuoi apportare una modifica al comportamento principale di Blockly in modo tale che si applichi a tutti gli utenti della libreria.

Esempi blocchi è il repository per esempi, plug-in e codelab. Utilizza questo repository se vuoi creare o modificare un plug-in, scrivere un codelab oppure creare o modificare un campione.

Procedura dettagliata

Questi sono i passaggi generali che devi 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 ha un tutorial eccezionale su come creare un repository. Per applicarla a blocchi, sostituisci semplicemente ogni istanza di octocat/Spoon-Knife con google/blockly o google/blockly-samples, a seconda del repository in cui vuoi intervenire.
3. Sincronizza la forchetta. GitHub fornisce anche un tutorial per sincronizzare un fork.
4. Dai un'occhiata alla filiale principale. Sostanzialmente, è il ramo develop. Negli esempi a blocchi, questo è il ramo master.
5. Installa le dipendenze e crea gli strumenti eseguendo npm install nella directory radice.
6. Crea un nuovo ramo eseguendo git checkout -b myBranchName in un terminale. Il nome dovrebbe aiutarti a ricordare ciò su cui stai lavorando.
7. Apporta le modifiche.
8. Convalida le modifiche, seguendo la guida per core o esempi.
9. Salva le modifiche con git commit -am "fix: My commit message". Scopri di più sui messaggi di commit.
10. Trasferisci le modifiche a GitHub con git push origin myBranchName.
11. Apri una richiesta di pull quando il codice è pronto. Un membro del team di Blockly esaminerà le tue modifiche e unirà in Blockly se verranno approvate. Per ulteriori informazioni, consulta la procedura di revisione delle PR.