Başlarken
Geliştirici modunu aç, şablondan bir eklenti oluştur ve kaydettikçe adada gör.
Gerekenler
- Adanotch (bu belgedeki sürümle aynı ya da daha yeni)
- Node.js 22.18 veya üstü (testler
.tsdosyalarını doğrudan çalıştırır) ve npm - Bir editör; VS Code otomatik tamamlamayı
adanotch/adanotch.d.tsdosyasından alır
Geliştirici modunu aç
Adanotch › Ayarlar › Geliştirici'de Geliştirici modunu aç. Aynı sayfadaki Terminal komutu › Kur düğmesi adanotch komutunu /usr/local/bin'e kurar.
adanotch --helpEklentiyi oluştur
adanotch init hava-durumu --name "Hava Durumu"
cd hava-durumu
npm installinit çalışan bir örnek eklenti, testleri, tip tanımlarını ve manifest şemasını yazar. Kimliği (local.<kullanıcı>.hava-durumu) kendisi üretir; istersen --id ile ver.
Geliştirme döngüsünü başlat
İki terminal aç:
npm run watch # src/ değiştikçe dist/index.js'i yeniden derleradanotch dev # eklentiyi Adanotch'a yükler, her kayıtta yeniler, console çıktısını gösterirsrc/index.ts'i değiştirip kaydet; ada birkaç yüz milisaniye içinde güncellenir. Hatalar src/index.ts:12:5 gibi kaynak satırıyla görünür.
Kur
Bitirdiğinde Ayarlar › Eklentiler › Eklenti yükle… ile klasörü ya da adanotch build ile ürettiğin .adanotchext dosyasını seç. Adanotch eklentiyi kendi kütüphanesine kopyalar, izinleri sana sorar ve sonraki açılışlarda da yükler.
Klasör
| Dosya | Ne işe yarar |
|---|---|
manifest.json | Kimlik, izinler, yenilenme sıklığı, ayarlar. Manifest |
src/index.ts | Eklentinin kodu |
test/index.test.ts | Node'da çalışan testler. Test |
dist/index.js | Derlenmiş hali; Adanotch bunu çalıştırır |
adanotch/ | API tipleri, manifest şeması, test kiti ve runtime |
icon.png | İsteğe bağlı simge |
adanotch/ klasörünü elle değiştirme
Bu klasör Adanotch'un sürümüne bağlıdır. Adanotch'u güncellediğinde adanotch init --types ile yenile; kendi kodun etkilenmez.
npm komutları
| Komut | Ne yapar |
|---|---|
npm run build | dist/index.js'i esbuild ile üretir (kaynak haritasıyla) |
npm run watch | Kaydettikçe yeniden derler |
npm test | Testleri Adanotch'un kendi runtime'ıyla çalıştırır |
npm run typecheck | Kaynak ve testlerde tip denetimi |
npm run lint | adanotch lint: manifest, izinler, eksik network: alan adları |
npm run package | adanotch build: paylaşılabilir .adanotchext |
Sıradaki adım: kodun ne zaman çalıştığını anlamak için Yaşam döngüsü.