Contribuire ai Samples

Blockly Samples contiene contenuti aggiuntivi correlati a Blockly che non fanno parte del repository principale, tra cui plug-in, codelab e codice di esempio. Per ulteriori dettagli su ciascuno di questi, consulta la pagina Struttura del repository.

Cose da sapere

Ecco una breve panoramica dei fatti su blockly-samples che devi conoscere per creare una PR.

  • Il ramo di lavoro è master e tutte le PR devono essere effettuate rispetto a master.
  • Esegui npm install a livello di radice di blockly-samples,non a livello di singolo plug-in. Blockly-samples è un monorepo, ovvero contiene più pacchetti nello stesso repository e l'installazione a livello di radice fa parte del flusso di lavoro per la gestione del monorepo con Lerna.
  • Il codice deve essere conforme alle linee guida di stile per JavaScript o alle linee guida di stile per TypeScript di Google, a seconda del linguaggio utilizzato.
  • Utilizza i commit convenzionali nei messaggi dei commit e nei titoli delle richieste pull.

  • 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 a livello di radice di blockly-samples per installare le dipendenze.
  2. Esegui npm run start nella directory di un plug-in per compilare e avviare un server che esegue la pagina di test del plug-in. Puoi utilizzare questa pagina per visualizzare il comportamento esistente di un plug-in oppure, se stai aggiungendo un nuovo plug-in, dovrai creare una pagina di test utile in modo che gli altri possano vedere cosa fa il plug-in. Per maggiori informazioni, consulta la pagina Playground.
  3. Apporta le modifiche necessarie al codice del plug-in.
  4. Se hai lasciato il server in esecuzione, le modifiche verranno caricate automaticamente. In caso contrario, riavvia il server e verifica che il plug-in funzioni come previsto e che non siano presenti errori o avvisi nella console.
  5. Esegui npm run build e assicurati che non siano presenti errori di compilazione.
  6. Scrivi i test mocha automatici nella directory test/.
  7. Esegui npm run test per eseguire i test automatici.
  8. Esegui npm run lint:fix per correggere gli errori di lint. Risolvi eventuali avvisi o errori rimanenti.
  9. Esegui npm run format per eseguire il programma di formattazione automatica.
  10. Se tutti i test sono stati superati, puoi aprire una PR contro master con le modifiche.