Açık kaynak olan Blockly, öncelikli olarak küçük bir ekip tarafından yürütülür. Ana ekibin dışındaki geliştiricilerin katkılarını kabul ediyoruz. Talep edilen her özelliği geliştirmemiz veya topluluğumuz olmadan bildirilen her hatayı düzeltmemiz mümkün değildir. Bu bölüm, özellikle açık kaynak geliştirme konusunda yeniyseniz size yardımcı olabilecek genel kılavuzları içerir.
Katkıda bulunmadan önce okumanız gereken engellemeler hakkında daha fazla bilgi için Temel Katkı ve Örneklere Katkı bölümlerine bakın.
Hangi depo?
depo, tek bir projedeki tüm dosyaları içerir. Blockly'de iki depo bulunur: bloklar halinde çekirdekli ve blok halinde örnekler.
Blockly core, Blockly kitaplığının deposudur. Kitaplıktaki tüm kullanıcılar için geçerli olacak şekilde temel Engelleme davranışında değişiklik yapmak istiyorsanız bu depoyu kullanın.
Blockly samples; örnekler, eklentiler ve codelab'ler için kullanılan depodur. Eklenti oluşturmak veya düzenlemek, codelab yazmak ya da örnek oluşturmak veya değiştirmek istiyorsanız bu depoyu kullanın.
Adım adım
Bunlar, her değişiklik yaptığınızda izleyeceğiniz genel adımlardır.
- Araçlar bölümündeki bağlantıları izleyerek Git ve Node'ı yükleyin.
- Depo çatallayın ve klonlayın. GitHub, bir depo atama ile ilgili harika bir eğitime sahiptir. Engellemeye uygulamak için octocat/Spoon-Knife örneğini, üzerinde çalışmak istediğiniz depoya bağlı olarak google/blockly veya google/blockly-samples ile değiştirmeniz yeterlidir.
- Çatalınızı senkronize edin. GitHub, aynı zamanda çatal senkronizasyonu için bir eğitim de sağlamaktadır.
- Ana şubeye göz atın. Blok temelde bu,
develop
şubesidir. Blok örneklerde bu,master
koludur. - Kök dizinde
npm install
çalıştırarak bağımlılıkları yükleyin ve araçlar oluşturun. - Bir terminalde
git checkout -b myBranchName
çalıştırarak yeni bir dal oluşturun. Ad, ne üzerinde çalıştığınızı hatırlamanıza yardımcı olmalıdır. - Değişikliklerinizi yapın.
- Temel veya örnekler için kılavuzu izleyerek değişikliklerinizi doğrulayın.
git commit -am "fix: My commit message"
ile değişikliklerinizi kaydedin. Kaydetme mesajları hakkında daha fazla bilgi edinin.git push origin myBranchName
ile GitHub'a değişikliklerinizi aktarın.- Kodunuz hazır olduğunda bir pull isteği açın. Blockly ekibinin bir üyesi, değişikliklerinizi inceler ve onaylanırlarsa bloklarınızı Bloly ile birleştirir. Daha fazla bilgi için PR İnceleme Süreci'ne bakın.