Core'a Katkıda Bulunun

Blockly çekirdek deposunda, Blockly tabanlı tüm uygulamaları çalıştırmak için gereken kod bulunur.

Bilinmesi Gerekenler

Burada, bir PR oluşturmak için bilmeniz gereken bloklar halinde çekirdekle ilgili bilgilere hızlı bir genel bakış sunulmaktadır.

  • Çalışma kol geliştirme bölümüdür ve tüm PR'ler geliştirme yerine yapılmalıdır.
  • Pull isteği şablonunu istenen bilgilerle doldurmanız gerekir.
  • Kod, Google'ın TypeScript Stil Kılavuzu'na uygun olmalıdır.
  • Kaydetme mesajlarınızda ve pull isteği başlıklarında geleneksel kaydetmeleri kullanın.
  • Çevrilebilmesi için, kullanıcının görebildiği dizelerin /msg/messages.js dosyasında olması gerekir. Dünyanın% 6'sından azı ana dili İngilizcedir.
  • Bloklardaki metinler genellikle küçük harfle yazılmalıdır (çoğu programlama dilindeki anahtar kelimelerde olduğu gibi).
  • Geriye dönük uyumluluğu koruyun. Piyasada pek çok Engelleme uygulaması vardır. Diğerlerini bozmayın.

  • Tüm yeni kod dosyalarının önünde Apache Lisansı v2.0 olmalıdır:

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

Değişiklik Yapma ve Doğrulama

  1. Bağımlılıkları yüklemek için npm install komutunu çalıştırın.
  2. Oyun alanını çalıştıran bir sunucu başlatmak için npm run start komutunu çalıştırın. Mevcut davranışı test etmek için bu sayfayı kullanabilirsiniz. Daha fazla bilgi için playground sayfasını ziyaret edin.
  3. Kodda gerekli değişiklikleri yapın.
  4. Sunucuyu çalışır durumda bıraktıysanız değişikliklerinizi görmek için sayfayı yenileyin. Aksi takdirde, sunucuyu yeniden başlatıp kodun beklendiği gibi davrandığını ve konsolda hata veya uyarı olmadığını doğrulayın.
  5. npm run build komutunu çalıştırın ve derleme hatası olmadığından emin olun.
  6. Otomatik testler yazma. Bunlar genellikle tests/mocha dizinindeki mocha testleridir ancak sizden başka test türleri de isteyebiliriz.
  7. Kodu biçimlendirmek ve bazı hata analizi sorunlarını otomatik olarak düzeltmek için npm run format komutunu çalıştırın.
  8. Otomatik testleri çalıştırmak için npm test komutunu çalıştırın. Bu komut ayrıca eslint işletim sistemini de çalıştırır.
  9. Hata analizi hataları varsa otomatik olarak düzeltilebilen sorunları düzeltmek için npm run lint:fix komutunu çalıştırın. Kalan hata analizi uyarılarını veya hatalarını giderin.
  10. Tüm testlerde başarılı olursa yaptığınız değişikliklerle geliştirme karşı bir PR açmaya hazırsınız demektir.