Blockly Geliştirici Araçları, özel blok oluşturma, araç kutunuzu oluşturma ve web Blockly çalışma alanınızı yapılandırma gibi Blockly yapılandırma sürecinin bazı bölümlerini otomatikleştiren web tabanlı bir geliştirici aracıdır.
Aracı kullanan Blockly geliştirici süreci üç bölümden oluşur:
- Block Factory ve Block Exporter'ı kullanarak özel bloklar oluşturun.
- Workspace Factory'i kullanarak bir araç kutusu ve varsayılan çalışma alanı oluşturun.
- Workspace Factory'ı (şu anda yalnızca web'de kullanılabilen bir özellik) kullanarak çalışma alanınızı yapılandırın.
Fabrika sekmesini engelleme
Blok Fabrikası sekmesi, özel bloklar için blok tanımları ve blok kodu oluşturucular oluşturmanıza yardımcı olur. Bu sekmede özel blokları kolayca oluşturabilir, değiştirebilir ve kaydedebilirsiniz.
Blok tanımlama
Bu videoda, bir blok tanımlama adımları ayrıntılı olarak açıklanmaktadır. Kullanıcı arayüzü güncel değildir ancak vurguladığı blok özellikleri hâlâ geçerlidir.
Kitaplığı yönetme
Bloklara adlarıyla referans verilir. Bu nedenle, oluşturmak istediğiniz her bloğun benzersiz bir adı olmalıdır. Kullanıcı arayüzü bu durumu zorunlu kılar ve yeni bir bloğu "kaydederken" veya mevcut bir bloğu "güncellerken" bunu net bir şekilde gösterir.
Daha önce kaydettiğiniz bloklar arasında geçiş yapabilir veya Kitaplık düğmesini tıklayarak yeni bir boş blok oluşturabilirsiniz. Mevcut bir bloğun adını değiştirmek, benzer tanımlara sahip birden fazla blok oluşturmanın başka bir yoludur.
Kitaplıkları dışa ve içe aktarma
Bloklar, tarayıcının yerel depolama alanına kaydedilir. Tarayıcının yerel depolama alanını temizlediğinizde engellemeleriniz silinir. Bloklarınızı süresiz olarak kaydetmek için kitaplığınızı indirmeniz gerekir. Engelleme kitaplığınız, XML dosyası olarak indirilir. Bu dosyayı içe aktararak engelleme kitaplığınızı, dosyayı indirdiğiniz zamanki durumuna ayarlayabilirsiniz. Bir blok kitaplığı içe aktardığınızda mevcut kitaplığınızın yerini aldığını unutmayın. Bu nedenle, önce dışa aktarmanız önerilir.
İçe aktarma ve dışa aktarma özellikleri, farklı özel blok gruplarını yönetmenin ve paylaşmanın da önerilen yoludur.
İhracat Edeni Engelle sekmesi
Bloklarınızı tasarladıktan sonra, bunları bir uygulamada kullanmak için blok tanımlarını ve oluşturucu taslaklarını dışa aktarmanız gerekir. Bu işlem, Blok Dışa Aktarımcısı sekmesinde yapılır.
Engelleme kitaplığınızda depolanan her blok, Engelleyici'de gösterilir. Dışa aktarmak için bloku tıklayarak seçin veya seçimini kaldırın. Kitaplığınızdaki tüm blokları seçmek istiyorsanız "Seç" → "Blok Kitaplığında Depolanan Tüm" seçeneğini kullanın. Araç kutunuzu Workspace Factory sekmesini kullanarak oluşturduysanız veya çalışma alanınızı yapılandırdıysanız "Seç" → "Workspace Factory'da Kullanılan Tüm Bloklar"ı tıklayarak kullandığınız tüm blokları da seçebilirsiniz.
Dışa aktarma ayarları, hangi oluşturulmuş dili hedeflemek istediğinizi ve seçili bloklar için tanımları, oluşturucu taslaklarını veya her ikisini de isteyip istemediğinizi seçmenize olanak tanır. Bunları seçtikten sonra dosyalarınızı indirmek için "Dışa aktar"ı tıklayın.
Workspace Factory sekmesi
Workspace Fabrikası, bir çalışma alanındaki araç kutusunu ve varsayılan blok grubunu yapılandırmayı kolaylaştırır. "Araç Kutusu" ve "Çalışma Alanı" düğmelerini kullanarak araç kutusunu düzenleme ve çalışma alanını başlatma arasında geçiş yapabilirsiniz.
Araç kutusu oluşturma
Bu sekme, Araç Kutusu için XML oluşturmanıza yardımcı olur. Bu dokümanda, araç kutusu özelliklerine aşina olduğunuz varsayılmaktadır. Burada düzenlemek istediğiniz bir araç kutusu XML'iniz varsa "Düzenlemek için yükle"yi tıklayarak yükleyebilirsiniz.
Kategorisi olmayan araç kutusu
Birkaç bloğunuz varsa ve bunları kategori olmadan görüntülemek istiyorsanız bunları çalışma alanına sürüklemeniz yeterlidir. Bloklarınız, önizlemedeki araç kutusunda görünür.
Kategorileri içeren araç kutusu
Kategorilerde reklam blokları göstermek istiyorsanız "+" düğmesini tıklayın ve yeni kategori için açılır menüyü seçin. Bu işlem, kategori listenize seçip düzenleyebileceğiniz bir kategori ekler. Tek bir standart Blockly kategorisi (Mantık, Döngüler vb.) eklemek için "Standart Kategori"yi veya tüm standart Blockly kategorilerini eklemek için "Standart Araç Kutusu"nu seçin. Kategorileri yeniden sıralamak için ok düğmelerini kullanın.
Seçilen kategorinin adını veya rengini değiştirmek için "Kategoriyi Düzenle" açılır menüsünü kullanın. Bir bloğu çalışma alanına sürüklediğinizde bu blok, seçili kategoriye eklenir.
Gelişmiş bloklar
Varsayılan olarak, standart bloklardan herhangi birini veya kitaplığınızdaki blokları araç kutusuna ekleyebilirsiniz. JSON'da tanımlanmış ve kitaplığınızda bulunmayan bloklarınız varsa bunları "Özel Blokları İçe Aktar" düğmesini kullanarak içe aktarabilirsiniz.
Bazı bloklar birlikte kullanılmalıdır veya varsayılan değerler içermelidir. Bu işlem gruplar ve gölgeler ile yapılır. Düzenleyicide bağlı olan tüm bloklar, araç kutusuna grup olarak eklenir. Başka bir bloğa bağlı bloklar, alt bloğu seçip "Gölge Oluştur" düğmesini tıklayarak da gölge bloklara dönüştürülebilir. Not: Yalnızca değişken içermeyen alt bloklar gölge blok olarak değiştirilebilir.
Araç kutularına bir değişken veya işlev bloğu ekleyecekseniz kullanıcıların bloğu tam olarak kullanabilmesi için araç kutunuza bir "Değişkenler" veya "İşlevler" kategorisi ekleyin. "Değişkenler" veya "İşlevler" kategorileri hakkında daha fazla bilgi edinin.
Çalışma alanını yapılandırma (web için Blockly)
Çalışma alanınızın farklı bölümlerini yapılandırmak için "Workspace Factory" sekmesine gidip "Workspace"i seçin.
Workspace Seçenekleri'ni belirleyin
Yapılandırma seçenekleri için farklı değerler ayarlayın ve sonucu önizleme alanında görün. Izgara veya yakınlaştırma'yı etkinleştirdiğinizde yapılandırabileceğiniz daha fazla seçenek gösterilir. Ayrıca, kategori kullanmaya geçiş genellikle daha karmaşık bir çalışma alanı gerektirir. İlk kategorinizi eklediğinizde otomatik olarak bir çöp kutusu ve kaydırma çubukları eklenir.
Çalışma alanına önceden yüklenmiş bloklar ekleme
Bu işlem isteğe bağlıdır ancak çalışma alanında bir blok grubu göstermek istiyorsanız gerekli olabilir:
- Uygulama yüklendiğinde.
- Bir etkinlik (seviye atlama, yardım düğmesini tıklama vb.) tetiklendiğinde.
Önizlemede çalışma alanınızda görmek için blokları düzenleme alanına sürükleyin. Engelleme grupları oluşturabilir, engellemeleri devre dışı bırakabilir ve seçtiğiniz belirli engellemeleri gölge engelleme haline getirebilirsiniz.
Bu blokları XML olarak dışa aktarabilirsiniz (aşağıya bakın). Çalışma alanınızı oluşturduktan hemen sonra Blockly.Xml.domToWorkspace
ile kullanıcıları çalışma alanınıza ekleyin:
var xmlText = '<xml xmlns="https://developers.google.com/blockly/xml">' +
'<block type="math_number"></block></xml>';
Blockly.Xml.domToWorkspace(Blockly.utils.xml.textToDom(xmlText), workspace);
Bu örnek kod, çalışma alanına tek bir math_number
bloğu ekler.
Dışa aktarılıyor
Workspace Factory, aşağıdaki dışa aktarma seçeneklerini sunar:
- Başlangıç Kodu: Özelleştirilmiş Blockly çalışma alanınızı beslemek için başlangıç HTML'si ve JavaScript'i oluşturur.
- Araç kutusu: Araç kutunuzu belirtmek için XML oluşturur.
- Workspace Blokları: Çalışma alanına yüklenebilecek XML oluşturur.