Dai il tuo contributo

Il repository principale Blockly contiene il codice necessario per eseguire qualsiasi applicazione basata su Blockly.

Cose da sapere

Ecco una breve panoramica degli aspetti di Blockly Core che devi conoscere per creare una PR.

  • Il ramo operativo è develop e tutte le PR devono essere presentate in contrasto con lo sviluppo.
  • Devi compilare il modello di richiesta di pull con le informazioni richieste.
  • Il codice deve essere conforme alla Guida allo stile TypeScript di Google.
  • Utilizza compet convenzionali nei messaggi di commit e nei titoli delle richieste di pull.
  • Le stringhe visibili all'utente devono trovarsi nel file /msg/messages.js per poter essere tradotte. Meno del 6% della popolazione mondiale parla inglese come lingua madre.
  • In genere, il testo nei blocchi deve essere tutto in minuscolo (proprio come le parole chiave nella maggior parte dei linguaggi di programmazione).
  • Mantenere la compatibilità con le versioni precedenti. Esistono molte app Blockly, non rovinare quelle degli altri.

  • Tutti i nuovi file di codice devono avere il prefisso della Licenza Apache 2.0:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

Apportare e verificare una modifica

  1. Esegui npm install per installare le dipendenze.
  2. Esegui npm run start per avviare un server che esegue il parco giochi. Puoi utilizzare questa pagina per testare il comportamento esistente. Per ulteriori informazioni, consulta la pagina playground.
  3. Apporta le modifiche necessarie al codice.
  4. Se il server è in esecuzione, aggiorna per vedere le modifiche. In caso contrario, riavvia il server e verifica che il codice funzioni come previsto e che non siano presenti errori o avvisi nella console.
  5. Esegui npm run build e assicurati che non ci siano errori di build.
  6. Scrivere test automatici. In genere, si tratta di test relativi alla mocha nella directory tests/mocha, ma potremmo chiederti altri tipi di test.
  7. Esegui npm run format per formattare il codice e risolvere automaticamente alcuni problemi di lint.
  8. Esegui npm test per eseguire i test automatici. Viene eseguito anche eslint.
  9. Se sono presenti errori lint, esegui npm run lint:fix per correggere i problemi che possono essere corretti automaticamente. Risolvi eventuali avvisi o errori lint rimanenti.
  10. Se tutti i test vengono superati, puoi aprire un PR contro lo sviluppo con le tue modifiche.