Bu doküman, daha önce Blockly'yi çatallayan ve kitaplığa yama uygulamadan Blockly'nin yeni sürümüne güncelleme yapmak isteyen geliştiricilere yöneliktir. Bu göz korkutucu bir görev gibi görünse de, süreci daha yönetilebilir hale getirmek için atabileceğiniz birkaç adım vardır.
Çatallandırmayı Anlama
Anahat Blockly'yi kullanmak, Blockly'nin yakın zamanda yayınlanan bir sürümünü kullandığınız ve tüm özelleştirmelerinizde maymun yama yapmadan herkese açık Blockly API'leri kullandığınız anlamına gelir. Çatalın serbest bırakılması, ana hat API'leriyle çatalınızın özel işlevlerini uygulamak için yapmanız gereken bir işlemdir.
Basit Çatal Kaldırma Durumları
Aşağıda, çatallamanıza yol açabilecek iki yaygın neden ve ana ağa nasıl dönebileceğinize ilişkin çözümler verilmiştir:
- Blockly kodunu değiştirmeden kendi bloklarınızı ve oluşturucularınızı oluşturdunuz: Bu durumda çatallama işlemini geri almak için özel bloklarınızı ve oluşturucularınızı Blockly deposundan kendi uygulamanızın koduna taşıyabilirsiniz. Bu durumda, Blockly sürümünüzü güncelleyebilirsiniz.
- Herhangi bir Blockly kodu değiştirmeden Blockly ad alanına özel işlevler eklediniz: Örneğin, yalnızca kendi uygulamanız tarafından kullanılan özel alanlar veya yardımcı yöntemler eklediniz. Bu durumda çatallama işlemini geri almak için bu özel kodu, Blockly deposunun dışındaki kendi uygulamanıza taşıyın. Bu işlemin ardından Blockly sürümünüzü güncelleyebilirsiniz.
Kapsamlı Çatal Kaldırma Kılıfı
Çatallı işlevselliği belirleme
Kullanıcıların çatalladığını gördüğümüz son neden, şu anda üretime dahil olmadığını fark ettikleri özel işlevler oluşturmak için Blockly'ye yama uygulamak. Çatalınız önemli ölçüde eskiyse ihtiyaç duyduğunuz işlevleri eklenti olarak veya çekirdek olarak zaten eklemiş olabiliriz. Çatalınıza hangi özellikleri eklediğinizi bilmek, hangi özellikleri güncellemeniz gerektiğine dair bir yol haritası sağlayabilir.
Mimariyi anlama
Çatala özgü API'ları kullanan özellikleri anladıktan sonra şunları göz önünde bulundurun:
- Çatalı kullanan her özellik için bunu Blockly API'leri kullanarak çoğaltmanın bir yolu var mı?
- Bu özelliği Blockly API'lerini kullanarak çoğaltamıyorsanız lütfen forum üzerinden bize ulaşın veya GitHub'da sorun bildirin. Ekibimiz daha sonra özelleştirmenizi etkinleştirmek için API'lerin eklenmesini araştıracaktır.
Çatallanma yöntemini belirleyin
Bir sonraki adım, çatalı kullanan özellikler için yeni Blockly tabanlı mimariyi uygulama sürecine başlamaktır. Bu konuda uygulayabileceğiniz iki temel yaklaşım vardır:
- Blockly'yi yeni sürüme geçirin ve hangi araların bozulduğunu görün: Kodunuzda güncellenmesi gereken alanları anında görürsünüz. Geliştirme sürecinde yol göstermesi için bunu özel davranışla birlikte kullanabilirsiniz.
- Özelliklerinizi Blockly'den ayırmak için kodunuzu yeniden düzenleme: Bu, hangi özelliklerin çatalınıza özel olduğunu ve hangilerinin Blockly'den geldiğini derinlemesine anlamanızı gerektirir. Kodunuz tamamen ayrıldıktan sonra Blockly'nin eski sürümünü en son sürümle değiştirin ve kalan entegrasyon sorunlarını düzeltin.
Kaydedilen İlerleme
Gelecekte bir Blockly geliştiricisi olarak uymanız gereken birkaç kural:
- Genel olarak, Blockly ad alanına yeni sınıflar eklememeniz gerekir. Özel alanları veya diğer kaydedilebilir sınıfları, Blockly deposu içinde ya da Blockly ad alanında bildirmeden kaydedebilirsiniz.
- Kendi uygulamanızı derlemek için Blockly'nin derleme araçlarını kullanmamalısınız. Derleme araçlarımızı herkese açık API'nin bir parçası olarak değerlendirmeyiz. Bu nedenle, bu araçlarda uygulamanızın bozulmasına neden olacak değişiklikler yapabiliriz. Bunu yapmak isterseniz başvurunuzu derlemek sizin sorumluluğunuzdadır.
Bize Ulaşın
Blockly, BlocklyForum aracılığıyla her zaman kullanılabilir! Çoğaltma işlemi sırasında herhangi bir sorunla karşılaşırsanız burada yayınlayabilirsiniz. Size yardımcı olabiliriz.