Bir Eklenti Oluşturma
Gerekli yazılım: metin düzenleyici, Chrome. Mümkünse, sorunları önlemek için devam etmeden önce mağazadan indirdiğiniz Scratch Eklentileri uzantısını devre dışı bırakın.
1. Adım: Eklenti ile ilgili temel bilgiler hakkında bilgi edinin
Terminolojiye aşina olmak için bu makaleyi okuduğunuzdan emin olun.
Veya isterseniz ZIP olarak indirin. Başka bir deyişle, kaynak kodunu yerel olarak indirmeniz yeterlidir.
Not: Eklentiler üzerinde çalışmak için Chrome önerilir. Yine de eklentilerin Firefox’da da çalışma ihtimali var.
Artık dosya sisteminizde uzantıya sahip olduğunuza göre,
chrome://extensions‘a gidin ve “geliştirici modu"nu etkinleştirin.
“Sıkıştırılmamış’ı yükle"ye tıklayın, ardından Scratch Eklentilerin bulunduğu klasörü seçin. Bununla ilgili sorun yaşıyorsanız,
manifest.json dosyasının bulunduğu klasörü seçtiğinizden emin olun.
İşte bu, uzantıyı yüklediniz! Şuna benzer görünmelidir:
Not: “hatalar” yazdığını güvenle görmezden gelebilirsiniz. Bu, Firefox’un tanınmayan bir “manifest anahtarı” için yalnızca bir uyarıdır.
Şimdi eğlenceli kısım geliyor! Eklentiniz ne yapacak? Kendini açıklayıcı bir eklenti kimliği düşünün (tireler dışında boşluk veya özel karakter koymayın). Anladın mı?
Bir dosya gezgini kullanarak Scratch Eklentilerin dosya sisteminizde bulunduğu klasöre gidin.
addons klasörünü bulun.
Ardından, adı olarak epik eklenti kimliğinizle yeni bir klasör oluşturun.
Eklenti manifesti, Scratch Eklentilerine eklentinizin nasıl çalıştığını söyler. Baş ağrısından kurtulmak için bunu yaptığınızdan emin olun.
Az önce oluşturduğunuz klasörün içinde bir
addon.json dosyası oluşturun.
Bu, kodlamaya başlamak için kullanabileceğiniz bir temeldir, gelecekte değiştirdiğinizden emin olun:
{ "name": "Yer tutucu metin yerine destansı eklenti adı", "description": "Merhaba Dünya! Bu yer tutucu metni bir açıklama ile değiştirmek gerçekten akıllıca olur.", "tags": ["topluluk"], "enabledByDefault": false }
Manifest dosyasında neler bildirebileceğiniz hakkında daha fazla bilgi için bu makaleye bakın.
Scratch Eklentileri kendi başına yeni klasörler bulamaz, bu nedenle adı özel bir dosyaya eklemeniz gerekir.
scratchAddonsFolder/addons/addons.json adresine gidin ve eklentinizin kimliğini diziye ekleyin.
Eklentiniz şu anda hiçbir şey yapmıyor, bu nedenle daha önce yaptığımız her şeyin çalışıp çalışmadığını kontrol etmek için iyi bir zaman.
chrome://extensions‘a gidin ve sayfayı yenileme sembolüne tıklayarak Scratch Eklentileri yeniden yükleyin.
Şimdi, Scratch Eklentiler simgesine sağ basın ve “seçenekler” e tıklayın.
Eklentinizi listede görmelisiniz! Eklentinizi bulduktan sonra etkinleştirin ve sahip olabileceğiniz tüm ayarları yapın.
Devam etmeden önce 1. adımda bağlantısı verilen wiki makalesini okuduğunuzdan emin olun.
İşin eğlenceli kısmı geliyor: Kendi JS veya CSS dosyalarınızı oluşturun! Profesyonel İpucu: Eklentinizde herhangi bir değişiklik yaptıktan sonra, 8. adımda yaptığınız gibi Scratch Eklentiler uzantısını yenilediğinizden emin olun.
Eklentinizin ne yapmasını istediğinize bağlı olarak, şimdi şu wiki sayfalarını kontrol etmelisiniz:
İsterseniz eklentinizi özelleştirilebilir hale getirebilirsiniz! Eklentinizin kullanıcıları ayarları değiştirebilir, sayı girebilir ve çok daha fazlasını yapabilir! Başlamak için eklenti bildiriminde ayarların nasıl bildirileceğine göz atın. Ardından, kullanıcı komut dosyalarından kullanıcı seçeneklerine nasıl erişileceğini öğrenmek için addon.settings belgelerine bakın.
Artık eklentiniz çalıştığına göre, onu eklenti kitaplığına ekleyebileceğimizden emin olalım.
Eklentinizin manifest dosyasının uygun olduğundan emin olun, buradan manifest dosyası hakkında daha fazla bilgi alabilirsiniz. Eklentinizin adına, açıklamasına ve etiketlerine çok dikkat edin.
"enabledByDefault" değerini
false olarak ayarladığınızdan veya satırı kaldırdığınızdan emin olun.
Eklentinizin diğer eklentilerin çalışmasını etkilemediğinden emin olun.
Kodunuzun anlaşılır olduğundan emin olun; Gereksiz yorumlara sahip olması, hiç yorum olmamasından daha iyidir.
Henüz yapmadıysanız, depoyu çatallayın, yeni eklentinizi yapın ve bir Pull Request gönderin! Sizden bazı değişiklikler yapmanızı isteyebileceğimizi unutmayın, ancak eklentinizi minimum düzeyde uygun olduğu sürece muhtemelen kabul edeceğiz.