Core'a Katkıda Bulunun

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 Core ile ilgili bilgilere buradan hızlıca göz atabilirsiniz.

  • Çalışma kolu geliştirmedir ve tüm halkla ilişkiler geliştirmeye karşı 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.
  • Taahhüt mesajlarınızda ve çekme isteklerinin başlıklarında geleneksel taahhütler kullanın.
  • Kullanıcı tarafından görülebilen dizelerin çevrilebilmesi için /msg/messages.js dosyasında olması gerekir. Dünyanın% 6'sından azı ana dili olarak İngilizce konuşuyor.
  • Bloklardaki metinler genellikle küçük harf olmalıdır (çoğu programlama dilindeki anahtar kelimeler gibi).
  • 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. Demoyu çalıştıran bir sunucu başlatmak için npm run start'ü ç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 komutunu çalıştırın ve yapı 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 komutunu ç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.