Core'a katkıda bulunma

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

Bilinmesi gerekenler

PR oluşturmak için bilmeniz gereken Blockly çekirdeğiyle ilgili bilgilere buradan hızlıca göz atabilirsiniz.

  • Çalışma şubesi develop'dir ve tüm PR'ler develop'e göre yapılmalıdır.
  • İstekte bulunulan bilgileri içeren bir çekme isteği şablonu doldurmanız gerekir.
  • Kod, Google'ın TypeScript Stil Kılavuzu'na uygun olmalıdır.
  • Commit mesajlarınızda ve çekme isteklerinizin başlıklarında geleneksel commit kullanın.
  • Kullanıcı tarafından görülebilen dizelerin çevrilebilmesi için /msg/messages.js dosyasında bulunması gerekir. Dünya nüfusunun% 6'sından azı İngilizceyi ana dili olarak konuşur.
  • Bloklardaki metinler genellikle küçük harflerden oluşmalıdır (çoğu programlama dilinde olduğu gibi anahtar kelimeler de küçük harflerle yazılır).
  • Geriye dönük uyumluluğu koruma Çok çok Blockly uygulaması var. Diğer kullanıcıların uygulamalarını bozmayın.

  • Yeni kod dosyalarının önüne Apache Lisansı 2.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'ü çalıştırın.
  2. Demo'yu çalıştıran bir sunucu başlatmak için npm run start dosyasını ç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 sayfayı yenileyin. Aksi takdirde, sunucuyu yeniden başlatın ve kodun beklendiği gibi davrandığını ve konsolda hata veya uyarı olmadığını doğrulayın.
  5. npm run build dosyasını çalıştırın ve derleme hatası olmadığından emin olun.
  6. Otomatik testler yazın. Bunlar genellikle tests/mocha dizininde bulunan mocha testleridir ancak sizden başka test türleri de isteyebiliriz.
  7. Kodu biçimlendirmek ve bazı lint sorunlarını otomatik olarak düzeltmek için npm run format'ü çalıştırın.
  8. Otomatik testleri çalıştırmak için npm test'ü çalıştırın. Bu işlem eslint'ü de çalıştırır.
  9. Hata ayıklama hataları varsa otomatik olarak düzeltilebilecek sorunları düzeltmek için npm run lint:fix'ü çalıştırın. Kalan lint uyarılarını veya hatalarını giderin.
  10. Tüm testler başarılı olursa değişikliklerinizle birlikte develop için bir PR açmaya hazırsınız demektir.