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.
Geliştirmekte olduğunuz eklentiyi bir çekme isteği olarak GitHub depomuza göndermeyi planlıyorsanız, lütfen ilk önce katkıda bulunma yönergelerimizi okuyun.
Bu depoda yeni eklenti fikrinizle ilgili mevcut bir GitHub sorunu yoksa, lütfen bir tane oluşturun. Ancak, özellik fikrinizle ilgili zaten bir sorun varsa, eklentiyi geliştirme niyetinizi belirten bir yorum bırakmanızı öneririz. Bu, diğer katkıda bulunanların eklentinin kabul edilip edilemeyeceği veya daha fazla tartışma gerekip gerekmediği konusunda geri bildirimde bulunmalarını sağlayacaktır.
Ancak, kişisel kullanım için bir eklenti oluşturuyorsanız, bu kılavuzla ilerleyebilirsiniz.
1. Adım: Eklenti ile ilgili temel bilgiler hakkında bilgi edinin
Terminolojiye aşina olmak için bu makaleyi okuduğunuzdan emin olun.
Adım 2: Depoyu çatallayın/klonlayın
Kaynak kodunu yerel olarak indirmek için bu yönergeleri takip edin.
3. Adım: Uzantıyı Chrome’a yükleyin
Not: Eklentiler üzerinde çalışmak için Chrome önerilir. Yine de, eklentilerin Firefox ve Edge’de de çalışması bekleniyor.
Artık dosya sisteminizde uzantıya sahip olduğunuza göre, chrome://extensions
a gidin ve “geliştirici modu"nu açın.
“Paketlenmemiş yükle"ye tıklayın, ardından Scratch Eklentileri’nin 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"ı güvenle görmezden gelebilirsiniz. Bu, Firefox tarafından gerekli görülen tanınmayan bir bildirim anahtarı için yalnızca bir uyarıdır.
4. Adım: Eklentiniz ne hakkında?
Ş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ı?
5. Adım: Eklenti için bir klasör oluşturun
Bir dosya gezgini kullanarak Scratch Eklentileri’nin 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.
6. Adım: Bir manifest eklentisi ekleyin
Eklenti manifesti, Scratch Eklentileri’ne 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": "Eklenti adının olduğu yere destansı yer tutucu metni",
"description": "Merhaba Dünya! Bu yer tutucu metnini bir açıklama ile değiştirmek gerçekten akıllıca olur.",
"tags": ["community"],
"enabledByDefault": false
}
Manifest dosyasında neler bildirebileceğiniz hakkında daha fazla bilgi için bu makaleye bakın.
7. Adım: Scratch Eklentileri’ne eklentinizin kimliğinin ne olduğunu söyleyin
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.
8. Adım: Merhaba dünya
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’ni yeniden yükleyin.
Şimdi, Scratch Eklentileri 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.
9. Adım: Eğlenceli kısım, kod!
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 Eklentileri uzantısını yenilediğinizden emin olun.
Eklentinizin ne yapmasını istediğinize bağlı olarak, şimdi şu wiki sayfalarını kontrol etmelisiniz:
10. Adım: Eklentinizi özelleştirilebilir yapın
İsterseniz eklentinizi özelleştirilebilir hâle 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, userscript’lerden kullanıcı seçeneklerine nasıl erişileceğini öğrenmek için addon.settings belgelerine bakın.
11. Adım: Eklentinizi yayınlamadan önce
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.
12. Adım: Bir pull request gönderin!
Katkı yapma kılavuzumuzdaki adımları takip edin. Basitçe söylemek gerekirse, eğer hâlihazırda yapmadıysanız depoyu çatallayın, yeni eklentinizi kaydedin ve bir PR gönderin! Size bazı değişiklikler istediğimizi bildiren bir yanıt gönderebileceğimizi aklınızda bulundurun, ancak kabul edilebilir bir düzeyde olduğu sürece eklentinizi kabul edeceğiz.
Yorumlar
Davranış kurallarına uyduğunuzdan emin olun. Bu yorum bölümünü GitHub Tartışmalarında görebilir, yorumunuzu düzenleyebilir ve kaldırabilirsiniz.