Yerel Olarak Yükleme ve Test Etme

Önceden derlenmiş bir geliştirme paketi veya zip bırakma ile derlenmiş bir presence'ı Nowly uzantısına yükleyin.

nowly build <slug>'dan sonra bile bu paketi bir tarayıcıya sokmanız gerekir. İki yerel yükleme yöntemi vardır. Hiçbiri Nowly API'siyle konuşmaz.

1. Önceden derlenmiş uzantı (nowly extension)

İlk kurulum için kullanılan yol budur. CLI, Chrome veya Firefox geliştirme derlemesini indirir ve derlenmiş presence'ınızı içine gömer.

nowly build youtube
nowly extension youtube             # Chrome (varsayılan)
nowly extension youtube --firefox
nowly extension youtube --f         # Firefox takma adı

Birden fazla slug geçebilirsiniz:

nowly extension youtube github figma --firefox

Tarayıcı seçenekleri birlikte kullanılamaz. Chrome'u açıkça seçmek için --chrome / --c kullanın.

Ardından:

• Chrome: chrome://extensions adresini açın, Geliştirici modunu etkinleştirin ve Paketlenmemişi yükle → dist/extension-dev seçin
• Firefox: about:debugging#/runtime/this-firefox adresini açın, This Firefox seçin, Load Temporary Add-on... tıklayın ve dist/extension-dev-firefox/manifest.json seçin

Presence, uzantı başlatıldığında dev-presences.json dosyasından kurulur. Kodu değiştirdikten sonra yeniden derleyin, nowly extension <slug> komutunu tekrar çalıştırın ve uzantıyı yeniden yükleyin.

CDN yerine yerel bir derleme kullanmak için:

nowly extension youtube --chrome --from ../nowly/apps/extension/dist/chrome
nowly extension youtube --firefox --from ../nowly/apps/extension/dist/firefox

Tam Nowly Monorepo'su

nowly'yi klonlayıp pnpm repos komutunu çalıştırdıysanız (presences'ı packages/presences içine klonlar), derlenmiş her presence'ı uzantıya gömebilirsiniz:

nowly build youtube
pnpm build:extension:dev --bundled

apps/extension/dist/chrome'u paketlenmemiş olarak yükleyin. Her yeniden derlemeden sonra yeniden yükleyin.

2. Zip bırakma (nowly pack)

Nowly zaten paketlenmemiş bir geliştirme derlemesi olarak yüklüyken bunu kullanın. Chrome Web Mağazası'ndan yapılan mağaza kurulumları imzasız zip'leri reddeder. Yalnızca presence'ı yeniden derlersiniz, tüm uzantıyı değil.

nowly pack youtube

Bu komut presence'ı derler, ardından dist/presences/youtube/'u dist/packs/youtube.zip olarak zipler. Zip en azından metadata.json ve bundle.js içermelidir. İç içe klasörler sorun değildir.

Ardından yan panelde:

1. Ayarlar → Gelişmiş'i açın
2. Geliştirici modunu etkinleştirin (paketlenmemiş derlemelerde her zaman açıktır)
3. Hata Ayıklama'yı genişletin
4. .zip dosyasını bırakın (veya göz atarak seçin)

Presence, yerel bir kaynak olarak kurulur. Paketlenmemiş önyükleme budaması onu kaldırmaz. İmzasız zip'ler yalnızca paketlenmemiş bir derlemede kabul edilir (Paketlenmemişi yükle). Ayarlar'daki geliştirici modu anahtarı yalnızca Hata Ayıklama arayüzünü gösterir; bir mağaza derlemesinde zip kurulumuna izin vermez. Mağaza derlemeleri hâlâ API'den imzalı bir sürüm gerektirir.

Her kod değişikliğinden sonra:

nowly pack youtube

Yeni zip'i tekrar bırakın. Uzantının kendisini değiştirmediğiniz sürece paketlenmemiş uzantıyı yeniden yüklemenize gerek yoktur.

Hangi Yöntem Seçilmeli

| Durum | Yöntem | |---|---| | İlk kurulum veya tarayıcıda Nowly yok | nowly extension <slug> | | Nowly zaten yüklü, bir presence üzerinde yineleme yapılıyor | nowly pack <slug>, ardından zip'i bırakın | | Tam nowly monorepo'sunda çalışıyorsunuz | pnpm build:extension:dev --bundled |

Ayrıca bkz. CLI.