Bu doküman, daha önce Blockly'yi çatallamış ve kitaplığa yama uygulamadan Blockly'nin son sürümüne güncellemek isteyen geliştiriciler için hazırlanmıştır. Bu, göz korkutucu bir görev gibi görünse de süreci daha kolay yönetilebilir hale getirmek için uygulayabileceğiniz birkaç adım vardır.
Çatal oluşturmayı kaldırmayı anlama
Ana hat Blockly'yi kullanmak, Blockly'nin yakın zamanda yayınlanan bir sürümünü kullandığınız ve tüm özelleştirmelerinizin, monkeypatching olmadan herkese açık Blockly API'lerini kullandığı anlamına gelir. Çatalınızın özel işlevini ana hat API'leriyle uygulamak için yapmanız gereken işlem, çataldan ayrılma işlemidir.
Basit Ayrılma Durumları
Dal oluşturmanızın iki yaygın nedeni ve ana kanala geri dönmeyle ilgili çözümler aşağıda verilmiştir:
- Herhangi bir Blockly kodunu değiştirmeden kendi bloklarınızı ve üreticilerinizi oluşturduysanız: Bu durumda, çatal oluşturma işlemini geri almak için özel bloklarınızı ve üreticilerinizi Blockly deposundan kendi uygulamanızın koduna taşımanız yeterlidir. Ardından Blockly sürümünüzü güncelleyebilirsiniz.
- Herhangi bir Blockly kodunu değiştirmeden Blockly ad alanına özel işlev eklediyseniz: Örneğin, yalnızca kendi uygulamanız tarafından kullanılan özel alanlar veya yardımcı yöntemler eklediyseniz. Bu durumda çatal oluşturmayı kaldırmak için bu özel kodu Blockly deposunun dışındaki kendi uygulamanıza taşıyın. Ardından Blockly sürümünüzü güncelleyebilirsiniz.
Kapsamlı Ayrılma Destek Kaydı
Çatallanmış işlevleri belirleme
Kullanıcıların çatallama işleminin son nedeni, Blockly'de o sırada ana akışa dahil edilmediğini düşündükleri özel işlevler oluşturmak için Blockly'de yama yapmaktır. Çatalınız güncel değilse ihtiyacınız olan işlevi eklenti olarak veya temel sürüme zaten eklemiş olabiliriz. Çatalınızda hangi özellikleri eklediğinizi bilmek, güncellemeniz gereken özellikleri belirlemenize yardımcı olabilir.
Mimarisi anlama
Çatallamaya özgü API'leri kullanan özellikleri anladıktan sonra şunları göz önünde bulundurun:
- Çatallanan her özellik için Blockly API'lerini kullanarak bu özelliğin kopyasını oluşturmanın bir yolu var mı?
- Blockly API'lerini kullanarak özelliği yeniden oluşturamıyorsanız lütfen forum üzerinden bize ulaşın veya GitHub'da sorun bildirin. Ardından ekibimiz, özelleştirmenizi etkinleştirmek için API ekleme seçeneğini araştırır.
Ayrılma yolunuzu belirleyin
Bir sonraki adım, çatal kullanarak özellikler için yeni Blockly tabanlı mimariyi uygulama sürecine başlamaktır. İki temel yaklaşımı kullanabilirsiniz:
- Blockly'yi yükseltme ve hangi sorunların ortaya çıktığını görme: Kodunuzda güncellenmesi gereken alanları hemen görürsünüz. Geliştirme sürecinize yön vermek için bu bilgileri, özel davranış olduğunu bildiğiniz bilgilerle birlikte kullanabilirsiniz.
- Özelliklerinizi Blockly'den ayırmak için kodunuzu yeniden yapılandırın: Bu işlem için hangi özelliklerin çatalınızda özel olduğunu ve hangilerinin Blockly'den geldiğini derinlemesine anlamanız gerekir. Kodunuz tamamen ayrıldıktan sonra eski Blockly sürümünüzü en son sürümle değiştirin ve kalan tüm entegrasyon sorunlarını düzeltin.
Kaydedilen İlerleme
Gelecekte Blockly geliştiricisi olarak uymanız gereken birkaç kural aşağıda verilmiştir:
- Genel olarak, Blockly ad alanına yeni sınıflar eklememelisiniz. Özel alanları veya kaydedilebilir diğer sınıfları Blockly deposunda ya da Blockly ad alanında tanımlamadan kaydedebilirsiniz.
- Kendi uygulamanızı derlemek için Blockly'nin derleme araçlarına güvenmemelisiniz. Derleme araçlarımızı herkese açık API'nin bir parçası olarak kabul etmiyoruz. Bu nedenle, uygulamanızı bozabilecek değişiklikler yapabiliriz. Uygulamanızı derlemek isterseniz bu işlem sizin sorumluluğunuzdadır.
Ulaşma
Blockly ekibine Blockly Forumu üzerinden ulaşabilirsiniz. Ayrılma işlemi sırasında herhangi bir sorunla karşılaşırsanız buraya yazabilirsiniz. Size yardımcı olabiliriz.