Core'a katkıda bulunma

Blockly çekirdek deposu, Blockly tabanlı herhangi bir uygulamayı çalıştırmak için gereken kodu içerir.

Bilmeniz gerekenler

Aşağıda, Blockly çekirdeği hakkında bilmeniz gereken bazı önemli noktalar yer almaktadır.

  • Çalışma dalı main'dir ve tüm çekme istekleri main'e karşı yapılmalıdır.
  • Çekme isteği şablonunu istenen bilgilerle doldurmanız gerekir.
  • Kod, Google'ın TypeScript Stil Kılavuzu'na uygun olmalıdır.
  • Commit mesajlarınızda ve çekme isteği başlıklarınızda conventional commits'i kullanın.
  • Kullanıcı tarafından görülebilen dizeler, çevrilebilmeleri için /msg/messages.js dosyasında olmalıdır. Dünyanın% 6'sından daha azı İngilizceyi ana dili olarak konuşuyor.
  • Bloklardaki metinler genellikle tamamen küçük harflerden oluşmalıdır (tıpkı çoğu programlama dilindeki anahtar kelimeler gibi).
  • Geriye dönük uyumluluğu koruyun. Piyasada çok sayıda Blockly uygulaması var. Diğer herkesin uygulamasını bozmayın.

  • Yeni kod dosyalarının önüne Apache Lisansı v2.0 eklenmelidir:

    /**
 *   @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. Demo alanını çalıştıran bir sunucuyu 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ına göz atın.
  3. Kodda gerekli değişiklikleri yapın.
  4. Sunucuyu çalışır durumda bıraktıysanız değişikliklerinizi görmek için yenileyin. Aksi takdirde, sunucuyu yeniden başlatın ve kodun beklendiği gibi çalıştığını, 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 yazın. Bunlar genellikle tests/mocha dizinindeki mocha testleri olur ancak sizden başka türde testler de isteyebiliriz.
  7. Kodu biçimlendirmek ve bazı lint 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 işlem eslint da çalıştırır.
  9. Lint hataları varsa otomatik olarak düzeltilebilen sorunları gidermek için npm run lint:fix komutunu çalıştırın. Kalan tüm lint uyarılarını veya hatalarını düzeltin.
  10. Tüm testler başarılı olursa değişikliklerinizi içeren bir çekme isteği oluşturup main dalına gönderebilirsiniz.