Sana Özel'e Katkıda Bulunun

Blockly Örnekleri, eklentiler, kod laboratuvarları ve örnek kod da dahil olmak üzere Blockly ile ilgili ana deponun parçası olmayan ek içerikler içerir. Bunların her biri hakkında daha fazla bilgi için Depo Yapısı sayfasına göz atın.

Bilinmesi gerekenler

PR oluşturmak için bilmeniz gereken blockly-samples ile ilgili bilgilere buradan kısaca göz atabilirsiniz.

  • Çalışma şubesi master'dır ve tüm PR'ler master'a göre yapılmalıdır.
  • npm install'yi tek tek eklenti düzeyinde değil,blockly-samples'in kök düzeyinde çalıştırın. Blockly-samples bir monorepo'dur. Yani aynı depoda birden fazla paket içerir. Monorepo'yu Lerna ile yönetme iş akışının bir parçası olarak kök düzeyinde yükleme yapmanız gerekir.
  • Kod, kullanılan dile bağlı olarak Google'ın JavaScript Stil Kılavuzu'na veya 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.

  • 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 bloklu örneklerin kök düzeyinde npm install komutunu çalıştırın.
  2. Eklentinin test sayfasını çalıştıran bir sunucu oluşturmak ve başlatmak için eklenti dizininde npm run start komutunu çalıştırın. Bir eklentinin mevcut davranışını görmek için bu sayfayı kullanabilirsiniz. Yeni bir eklenti ekliyorsanız diğer kullanıcıların eklentinizin ne yaptığını görebilmesi için bu sayfayı yararlı bir test sayfası haline getirmeniz gerekir. Daha fazla bilgi için playground sayfasına bakın.
  3. Eklentinin kodunda gerekli değişiklikleri yapın.
  4. Sunucuyu çalışır durumda bıraktıysanız değişiklikleriniz otomatik olarak yüklenir. Aksi takdirde, sunucuyu yeniden başlatın ve eklentinin 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. test/ dizininde otomatik mocha testleri yazın.
  7. Otomatik testleri çalıştırmak için npm run test'ü çalıştırın.
  8. Hata ayıklama hatalarını düzeltmek için npm run lint:fix'ü çalıştırın. Kalan uyarıları veya hataları giderin.
  9. Otomatik biçimlendiriciyi çalıştırmak için npm run format'ü çalıştırın.
  10. Tüm testler başarılı olursa değişikliklerinizle master için bir PR açmaya hazırsınız demektir.