Sana Özel'e Katkıda Bulunun

Blockly Samples; eklentiler, codelab'ler ve örnek kodlar dahil olmak üzere temel deponun parçası olmayan Blockly ile ilgili ekstra içerik içerir. Bunların her biri hakkında daha fazla bilgi için Depo Yapısı sayfasına göz atın.

Bilinmesi Gerekenler

Aşağıda, bir PR oluşturmak için bilmeniz gereken blok halinde örneklerle ilgili bilgilere hızlı bir genel bakış verilmiştir.

  • Çalışan dal ana daldır ve tüm PR'ler ana dala karşı yapılmalıdır.
  • Bağımsız eklenti düzeyinde değil,npm install öğesini bloklu örneklerin kök düzeyinde çalıştırın. Blok örnekler bir monorepodur. Yani aynı depoda birden fazla paket içerir. Kök düzeyinde yükleme, Lerna ile monorepo'yu yönetme iş akışının bir parçasıdır.
  • Kod, kullanılan dile bağlı olarak Google'ın JavaScript Stil Kılavuzu'na veya 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.

  • 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 bloklu örneklerin kök düzeyinde npm install çalıştırın.
  2. Eklentinin test sayfasını çalıştıran bir sunucu oluşturmak ve başlatmak için eklentinin dizininde npm run start komutunu çalıştırın. Bu sayfayı bir eklentinin mevcut davranışını görmek için kullanabilirsiniz. Yeni bir eklenti ekliyorsanız de diğer kullanıcıların eklentinizin yaptıklarını görebilmesi için bu sayfayı kullanışlı bir test sayfası yapmanız gerekir. Daha fazla bilgi için playground sayfasını ziyaret edin.
  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ıp eklentinin beklendiği gibi davrandığını ve konsolda herhangi bir 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. test/ dizinine otomatik mocha testleri yazın.
  7. Otomatik testleri çalıştırmak için npm run test komutunu çalıştırın.
  8. Hata analizi hatalarını düzeltmek için npm run lint:fix komutunu çalıştırın. Kalan uyarı veya hataları giderin.
  9. Otomatik biçimlendiriciyi çalıştırmak için npm run format komutunu çalıştırın.
  10. Tüm testlerde başarılı olursa yaptığınız değişikliklerle birlikte ana ile ilgili bir PR açmaya hazırsınız demektir.