Sana Özel'e içerik ekleme

Blockly örnekleri, eklentiler, codelab'ler ve örnek kod gibi temel depoda yer almayan Blockly ile ilgili ek içerikler barındırır. Bunların her biri hakkında daha fazla bilgi için Depo Yapısı sayfasına bakın.

Bilmeniz gerekenler

PR oluşturmak için bilmeniz gereken blockly-samples ile ilgili gerçeklere dair kısa bir genel bakışı aşağıda bulabilirsiniz.

  • Çalışma dalı main'dir ve tüm çekme istekleri main'e karşı yapılmalıdır.
  • Run npm install komutunu tek tek eklenti düzeyinde değil, blockly-samples'ın kök düzeyinde çalıştırın. Blockly-samples, tek depolu bir sistemdir. Yani aynı depoda birden fazla paket içerir ve kök düzeyinde yükleme, Lerna ile tek depolu sistemi yönetme iş akışının bir parçasıdır.
  • Kod, kullanılan dile bağlı olarak Google'ın JavaScript Stil Kılavuzu veya 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.

  • 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 blockly-samples'ın kök düzeyinde çalıştırın.
  2. Eklentinin test sayfasını çalıştıran bir sunucu oluşturup 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 diğer kullanıcıların eklentinizin ne yaptığını görebilmesi için bu sayfayı faydalı bir test sayfası haline getirmeniz gerekir. Daha fazla bilgi için deneme alanı sayfasına göz atı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 ç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. test/ dizininde otomatik mocha testleri yazın.
  7. Otomatik testleri çalıştırmak için npm run test komutunu çalıştırın.
  8. Lint hatalarını düzeltmek için npm run lint:fix komutunu çalıştırın. Kalan uyarıları veya hataları düzeltin.
  9. Otomatik biçimlendiriciyi çalıştırmak için npm run format komutunu çalıştırın.
  10. Tüm testler başarılı olursa değişikliklerinizi içeren bir çekme isteği oluşturup main dalına gönderebilirsiniz.