Blockly utilizza alcuni strumenti e librerie per lo sviluppo, tra cui Git, npm e Closure Compiler. Questa sezione fornisce alcune descrizioni di base di ogni strumento, nonché link a dove trovare ulteriori informazioni su ogni strumento.
Usiamo molti di questi strumenti tramite gli script. Potrebbe non essere necessario eseguirli direttamente. Conoscere i nomi può comunque essere utile per il debug, l'invio di richieste di funzionalità o problemi.
Git
Git è un sistema di controllo della versione che utilizziamo per tenere traccia e gestire le modifiche ai file.
GitHub
GitHub è una piattaforma di hosting per il controllo delle versioni, la collaborazione e la distribuzione di codice open source. Git tiene traccia dei file; GitHub offre interfacce fluide per la revisione del codice, il monitoraggio dei problemi e la visualizzazione della cronologia delle modifiche.
Per iniziare: se non hai mai utilizzato Git e GitHub, segui i tutorial della quickstart di GitHub per acquisire dimestichezza con le nozioni di base.
Nodo
Node.js è un modo per eseguire JavaScript sul server (anziché in un browser). npm (vedi di seguito) viene eseguito sul nodo.
npm
npm è costituito da due elementi:
- Uno strumento a riga di comando che utilizziamo per installare le dipendenze ed eseguire script.
- Un registro online in cui pubblichiamo il nostro codice, in modo che altri sviluppatori possano usare facilmente Blockly.
Per iniziare: Installa nodo e npm.
Compilatore di chiusura
Closure Compiler è uno strumento per velocizzare il download e l'esecuzione di JavaScript. Lo utilizziamo per combinare tutti i file JavaScript in un'unica libreria e anche per controllare la sintassi e i tipi.
Per iniziare: non è necessario installare o eseguire direttamente il compilatore Closure, poiché lo installiamo ed eseguiamo tramite npm.
Scopri di più: chiusura della documentazione del compilatore sui tipi JavaScript e sulle annotazioni dei tipi.
ESLint
ESLint è un analizzatore statico che rileva problemi con il codice JavaScript. Lo utilizziamo per definire e applicare uno stile coerente in tutto il nostro codebase. I piccoli problemi con il codice (punti e virgola mancanti, spaziatura incoerente e così via) vengono spesso chiamati lint. ESLint viene eseguito automaticamente quando ci invii una richiesta di pull. Puoi anche eseguirla localmente.
Per iniziare: sia in Blockly core che in blockly-samples, puoi eseguire
ESLint con npm run lint. Molti editor di codice hanno anche integrazioni
ESLint per visualizzare i problemi durante la digitazione.
Scopri di più: ogni regola ESLint dispone di una pagina di documentazione che descrive la regola e fornisce esempi di codice corretto e non corretto.
Moca
Mocha è un framework di test JavaScript. Lo utilizziamo per eseguire test nel browser e su Node.js (per i casi d'uso headless).
Per iniziare: sia in Blockly core che in blockly-samples, puoi eseguire i nostri
test Mocha con npm run test. Nel core di Blockly, verranno eseguiti anche altri test.
I test Mocha di Blockly sono definiti nella directory test/mocha.
Scopri di più: Mocha consente agli sviluppatori di definire gli hook, che consentono di definire funzioni di configurazione e di eliminazione centralizzate per i test.
Chai
Chai è una libreria di asserzioni che utilizziamo nei nostri test Mocha.
Scopri di più: Chai ha diversi "tipi" di sintassi, per facilitare l'integrazione con i progetti esistenti. Blockly utilizza il gusto assert.