mIRC Addon Paketleme: Dağıtıma Hazır Paket Hazırlamak

Bir addon yazdınız, test ettiniz ve paylaşmaya hazırsınız. Son adım, onu başkalarının kolayca kurabileceği bir paket hâline getirmektir. mIRC addon paketleme, teknik olarak basit ama ayrıntı gerektiren bir iştir: Doğru dosyaları doğru düzende bir araya getirmek ve kullanıcıya ne yapacağını açıkça söylemek.

Paket İçeriği

Bir addon paketinde bulunması gerekenler:

Dosya	Gerekli mi?	İçeriği
Ana script dosyası	Evet	Addon kodu
Ek script dosyaları	Varsa	Ayar penceresi, yardımcı fonksiyonlar
Kılavuz dosyası	Evet	Kurulum ve kullanım bilgileri
Değişiklik geçmişi	Önerilir	Sürüm notları
Lisans dosyası	Önerilir	Kullanım koşulları
Simge dosyaları	Varsa	Arayüz grafikleri
Örnek ayar dosyası	Önerilir	Varsayılan ayarlar

Pakete girmemesi gerekenler:

• Kendi test verileriniz.
• Kendi ayar dosyanız (kanal adlarınız, nickiniz).
• Parola içeren hiçbir dosya.
• Geliştirme sırasında oluşan yedek ve geçici dosyalar.
• Log dosyaları.

Bu son liste önemlidir: Kendi ayar dosyanızı pakete koymak, hem kişisel bilgilerinizi paylaşmak hem de kullanıcının addon'u sizin ayarlarınızla çalıştırmasına yol açmak anlamına gelir.

Klasör Yapısı

Paketi tek bir klasör içinde hazırlayın; kullanıcı arşivi açtığında dosyalar dağınık biçimde klasörüne saçılmasın:

addonadi-1.2/
  addonadi.mrc
  addonadi-ayarlar.mrc
  okubeni.txt
  degisiklikler.txt
  lisans.txt
  ornek-ayarlar.ini

Klasör adına sürüm numarasını eklemek, kullanıcının hangi sürümü indirdiğini görmesini sağlar ve farklı sürümleri bir arada tutmayı kolaylaştırır.

Veri dosyaları için bir alt klasör gerekiyorsa, addon'un ilk çalıştığında bu klasörü kendisi oluşturması en temiz yoldur; boş klasörler arşivlerde kaybolabilir.

Kılavuz Dosyası

Kılavuz, paketin en önemli dosyasıdır çünkü kullanıcının ilk okuyacağı şeydir. İyi bir kılavuzun yapısı:

Başlık ve sürüm: Addon adı, sürüm numarası, yazar, tarih.

Ne yapar: İki üç cümlelik açıklama. Kullanıcı bu addon'un işine yarayıp yaramayacağına burada karar verir.

Gereksinimler: Hangi mIRC sürümü, varsa başka bağımlılıklar.

Kurulum: Adım adım, kopyalanabilir komutlarla.

İlk ayarlar: Kurulumdan sonra ne yapılması gerektiği.

Komutlar: Addon'un sunduğu komutların listesi ve açıklamaları.

Ayarlar: Her ayarın ne işe yaradığı.

Kaldırma: Addon'u temiz şekilde kaldırma adımları.

Bilinen sınırlamalar: Yapamadığı şeyler ve bilinen sorunlar. Bunları yazmak güven kazandırır.

İletişim: Geri bildirim veya soru için bir yol.

Kılavuzu düz metin olarak yazmak en güvenlidir: Her sistemde açılır ve biçimlendirme sorunu çıkarmaz.

Kurulumu Kolaylaştırmak

Kullanıcılar kurulum komutunu genellikle kılavuzdan kopyalayıp yapıştırır. Bu yüzden komutu tam ve doğru yazmak önemlidir.

Birden fazla dosya varsa, tek bir ana dosyanın diğerlerini yüklemesi en iyi çözümdür: Kullanıcı tek komut çalıştırır, addon kendi parçalarını yükler. Bu, kurulum hatalarını büyük ölçüde azaltır.

Kurulum sonrası ilk ayarları yapmak için bir komut sunmak da faydalıdır: Addon yüklendiğinde durum penceresine "ayarları yapmak için şu komutu kullanın" mesajı yazmak, kullanıcıyı doğru yere yönlendirir.

Kurulum ayrıntıları için mIRC addon yükleme yazımıza bakın.

Kaldırma Desteği

İyi bir addon, kendini temiz şekilde kaldırmanın yolunu sunar. Bir kaldırma komutu şunları yapmalıdır:

• Kurduğu timer'ları kapatmak.
• Oluşturduğu global değişkenleri silmek.
• Hash tablolarını serbest bırakmak.
• Açtığı özel pencereleri kapatmak.
• Kullanıcıya hangi dosyaları elle silmesi gerektiğini söylemek.
• Kendini script listesinden kaldırmak.

Bu komutu sunmak, kullanıcıların addon'unuzu denemekten çekinmemesini sağlar: Beğenmezlerse temizce kaldırabileceklerini bilirler. Kaldırma ayrıntıları için mIRC addon kaldırma yazımıza bakın.

Temizlik Kontrolü

Paketi hazırlamadan önce son bir kontrol listesi:

1. Parola taraması: Bütün dosyalarda parola geçebilecek ifadeleri arayın.
2. Kişisel bilgi: Kendi nickiniz, kanallarınız, e-posta adresiniz, dosya yollarınız koddan çıkarıldı mı?
3. Test kodları: Denemek için eklediğiniz satırlar kaldırıldı mı?
4. Hata ayıklama satırları: İzleme için eklediğiniz yazdırma komutları temizlendi mi?
5. Sabit dosya yolları: Dosya yolları taşınabilir identifier'larla mı yazılmış?
6. Sürüm numarası: Bütün yerlerde güncel mi?
7. Önek kontrolü: Bütün adlar addon önekini taşıyor mu?
8. Yorumlar: Kişisel notlar veya yarım kalmış açıklamalar var mı?

Bu kontroller atlanırsa en iyi hâlde utanç verici, en kötü hâlde parolanızın sızması gibi ciddi sonuçlar doğar.

Arşivleme

Paketi yaygın bir sıkıştırılmış arşiv biçiminde hazırlayın. Kurulum programı yazmaya gerek yoktur ve genellikle hoş karşılanmaz: Kullanıcılar bir mIRC addon'u için çalıştırılabilir dosya indirmek istemez ve bu güvenlik açısından haklı bir çekincedir.

Arşiv adında addon adı ve sürüm numarası bulunsun. Bu, kullanıcının indirdiği dosyayı sonradan tanımasını sağlar.

Arşivi hazırladıktan sonra farklı bir klasörde açıp kurulumu baştan deneyin: Eksik dosya veya yanlış yol olup olmadığını ancak böyle anlarsınız.

Son Test

Paketi yayımlamadan önce temiz bir mIRC kurulumunda tam bir kurulum testi yapın. İdeal olarak başka bir bilgisayarda veya en azından ayrı bir mIRC klasöründe.

Test adımları: Arşivi açın, kılavuzdaki komutları birebir uygulayın, ilk ayarları yapın, temel işlevleri deneyin ve kaldırma komutunu test edin. Bu test, kılavuzda eksik veya hatalı bir adım olup olmadığını da ortaya çıkarır.

Yayımlama

Paketi nerede paylaşacağınıza karar verin: script arşivleri, forumlar veya kod paylaşım platformları. Kod paylaşım platformları sürüm takibi ve geri bildirim imkânı sunduğu için avantajlıdır.

Yayımlarken paket açıklamasına şunları ekleyin: ne yaptığı, hangi mIRC sürümünü gerektirdiği, kısa bir özellik listesi ve varsa ekran görüntüsü. Ekran görüntüsü, özellikle arayüzü olan addon'larda indirme sayısını belirgin şekilde etkiler.

Dağıtım ve destek konuları için mIRC script paylaşma yazımıza bakın.

Gerçek Bir Senaryo

Bir geliştirici, addon'unu bir arşivde paylaşıyor. Arşivi açan kullanıcılar dosyaların doğrudan mIRC klasörüne saçıldığını ve hangi dosyanın bu addon'a ait olduğunu bilemediklerini bildiriyor. Ayrıca pakette geliştiricinin kendi ayar dosyası var ve addon kurulduğunda geliştiricinin kanallarında çalışmaya başlıyor; bir kullanıcı yanlış kanalda mesaj gönderdiği için uyarı alıyor. Geliştirici paketi yeniden hazırlıyor: Bütün dosyaları sürüm numaralı bir klasöre alıyor, kendi ayar dosyasını çıkarıp yerine boş bir örnek dosya koyuyor, kılavuzu genişletiyor ve bir kaldırma komutu ekliyor. İkinci sürümden sonra kurulum sorunları kesiliyor.

Sonuç

Paketleme, addon'unuzun ilk izlenimini belirler. Dosyaları sürüm numaralı tek bir klasörde toplayın, kılavuzu eksiksiz yazın, kişisel bilgilerinizi ve ayar dosyanızı pakete koymayın, kaldırma desteği sunun ve paketi temiz bir ortamda baştan kurarak test edin. Araç çubuğu özelleştirmesi için sıradaki rehberimiz mIRC toolbar addonu.