CLI

Gunakan CLI Nowly untuk mencipta, membina, mengesahkan dan menguji presence secara setempat.

CLI Nowly diterbitkan sebagai @nowly/cli di npm. Pasangnya secara global:

pnpm i -g @nowly/cli

Mod Interaktif

Jalankan CLI tanpa hujah untuk membuka menu interaktif:

nowly

Mencipta Presence

nowly init "Netflix"

Gesaan interaktif bertanya sama ada Discord sudah menyokong platform tersebut jika pengguna memautkan akaun mereka. Itu menulis discordNative dalam metadata.json. Anda juga boleh menghantarnya terus:

nowly init "Spotify" --discord-native

Membina Presence

Bina semua presence:

nowly build

Bina satu presence:

nowly build youtube

Bina semula apabila fail berubah (muatkan semula sambungan tanpa pek selepas setiap pembinaan semula, atau jatuhkan semula zip jika anda menggunakan pack):

nowly build youtube --watch
nowly pack youtube --watch

Menguji Presence Secara Setempat

Terdapat dua cara untuk memuatkan presence yang telah dibina tanpa API Nowly. Panduan penuh: Muat dan Uji Secara Tempatan.

Sambungan prabina

Jika anda hanya mengklon repositori presences (kes biasa untuk penyumbang), gunakan nowly extension untuk mendapatkan binaan pembangunan yang sedia dimuat tanpa monorepo nowly penuh:

nowly build youtube
nowly extension youtube             # Chrome (lalai)
nowly extension youtube --firefox
nowly extension youtube --f         # Alias Firefox

Ini memuat turun binaan pembangunan Chrome atau Firefox yang sepadan daripada CDN, membundel presence yang disenaraikan dan menulis dev-presences.json. Kemudian:

1. Chrome: Buka chrome://extensions, hidupkan Mod pembangun, kemudian pilih Muat tanpa pek → dist/extension-dev
2. Firefox: Buka about:debugging#/runtime/this-firefox, pilih This Firefox, klik Load Temporary Add-on..., kemudian pilih dist/extension-dev-firefox/manifest.json

Selepas menyunting presence, bina semula, jalankan semula nowly extension <slug> dan muat semula sambungan.

Gunakan --chrome / --c untuk Chrome dan --firefox / --f untuk Firefox. Pilihan ini tidak boleh digunakan bersama.

Untuk menggunakan binaan sambungan tempatan tertentu dan bukannya daripada CDN, hantar --from:

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

Jatuhan zip

Jika Nowly sudah dimuatkan sebagai binaan pembangunan tanpa pek, pek presence dan jatuhkannya dalam panel Nyahpepijat:

nowly pack youtube

Zip ditulis ke dist/packs/youtube.zip. Jatuhkannya pada Tetapan → Lanjutan → Nyahpepijat. Zip yang tidak ditandatangani hanya berfungsi pada binaan tanpa pek, bukan pemasangan Chrome Web Store. UI Nyahpepijat hanya dipaparkan dalam mod pembangun.

Jika anda mempunyai monorepo penuh

Jika anda mengklon nowly itu sendiri dan menjalankan pnpm repos (yang mengklon presences ke dalam packages/presences), anda boleh membina sambungan dengan semua presence disertakan terus:

pnpm build:extension:dev --bundled

Bina semula presence yang diubah kemudian sambungan selepas setiap perubahan:

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

Muat semula di chrome://extensions - presence sudah dipasang dan sedia digunakan.

Senaraikan Presence

nowly list

Sahkan Metadata

nowly validate