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.

2. Adım: Depoyu çatallayın/klonlayın

Veya isterseniz ZIP olarak indirin. Başka bir deyişle, kaynak kodunu yerel olarak indirmeniz yeterlidir.

3. Adım: Uzantıyı Chrome’a yükleyin

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: görsel 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.

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 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.

6. Adım: Bir manifest eklentisi ekleyin

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.

7. Adım: Scratch Eklentilere 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 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.

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 Eklentiler 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 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.

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!

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.


Bu sayfayı geliştirin

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.