د Zinnector® ستونزه هوارول

د خلکو لخوا د Zinnector® CLI کارولو پر مهال مخ ته راغونکي اصلي تېروتنې، د هرې یوې مانا او د هغې حل لاره. هر ننوتنه هغه دقیق متن ښيي چې تاسو به یې وینئ، ترڅو تاسو په دې پاڼه کې د هغې لټون وکوئ. که ستاسو تېروتنه دلته نه وي، ناکامه شوې قومانده د ZINNECTOR_DEBUG=1 سره پرمخ یوسي او د محصول، ستاسو د node --version او عملیاتي سیسټم سره یوځای په github.com/Zinn-Digital/zinnector/issues کې یوه ستونزه (issue) پرانیزئ.

د رن ټایم (runtime) د نصبولو له منلو سم وروسته (په وینډوز کې) "spawn EINVAL"

په Zinnector® 0.1.0 او 0.1.1 کې یو بګ. په وینډوز کې د رن ټایم نصبونکي د npm.cmd نوم په واسطه چلاوه، او Node د CVE-2024-27980 لپاره د خپل فکس راهیسې پرته له شیل څخه د .cmd فایل سپاون (spawn) کول رد کړي دي — نو د Y ځواب ورکولو څخه یوه ثانیه وروسته نصب کول کریش شول. په 0.1.2 کې حل شوی: npm اوس د node npm-cli.js په توګه چلیږي، کوم چې په هر پلیټ فارم کې یو شان دی او هېڅ شیل ته اړتیا نه لري. npm install -g zinnector@latest او بیا بیا zinnector dev اجرا کړئ.

د نصبولو پر مهال "npm WARN EBADENGINE"، یا "Zinnector® needs Node 24 or newer"

ستاسو Node د 24 څخه زوړ دی. npm دا خبرداری چاپوي ځکه چې کڅوړه (package) engines: >=24.18.1 اعلانوي؛ نصب کول په هر صورت بشپړیږي، مګر zinnector بیا د دې پر ځای چې وروسته په یو څه ګمراه کوونکي ډول ناکام شي، د پیل کولو څخه انکار کوي (د وتلو کوډ 78). د nodejs.org څخه اوسنی LTS نصب کړئ — په وینډوز کې winget install OpenJS.NodeJS.LTS، په macOS کې brew install node@24 — تایید کړئ چې node --version د v24 یا لوړ چاپوي، او Zinnector® بیا نصب کړئ.

"gyp ERR!"، "Building from source with node-gyp"، یا "You need to install Visual Studio"

د WordPress رن ټایم یو اصلي موډول لري چې د هغې مخکې جوړ شوي بائنریز یوازې د Node 24 او 25 لپاره شتون لري. په نوي Node کې (د 26 او پورته، د 2026 د سپتمبر تر میاشتې پورې) د هغې نصب کونکی د سرچینې څخه د کامپل کولو په لور ګرځي، کوم چې په عادي وینډوز ماشین کې د Visual Studio غوښتنې سره پای ته رسیږي. په 0.1.2 کې حل شوی: Zinnector® د هغې له ډاونلوډ کولو دمخه دا کشف کوي او یوازې د رن ټایم لپاره د Node 24 اخلي — شاوخوا 30 MB، د nodejs.org د چک سمونو په وړاندې تایید شوی — نو هېڅکله هم هېڅ شی نه کامپلیږي. که تاسو لاهم د لوړولو وروسته دا ووینئ، نو zinnector dev --reset-runtime اجرا کړئ ترڅو د مخکیني نیمګړي نصب شوي شیان لومړی لرې شي.

د npm څخه "EPERM" خبرداري پداسې حال کې چې دا پاکول ترسره کوي (وینډوز)

نږدې تل دا د انټي ویروس سکینر یا د لټون انډیکسر وي چې د رن ټایم د node_modules لاندې یو فایل پرانیستی ساتي پداسې حال کې چې npm د هغې د لیرې کولو هڅه کوي. په راتلونکي zinnector dev کې نصب کول له پاک ډایرکټري څخه بیا هڅه کیږي؛ که دا دوام وکړي، zinnector dev --reset-runtime لومړی ټول رن ټایم ډایرکټري لرې کوي او بیا نصب کوي.

"the local playground runtime could not be installed"

پیغام د npm خپل وروستي لیکې او هغه دقیق قومانده لري چې Zinnector® چلولې ده، ترڅو تاسوخپله هم هغه چلولی شئ او بشپړ محصول وګورئ. معمول لاملونه د شبکې یا پراکسي ستونزه ده — رن ټایم ستاسو د خپل npm سره اخیستل کیږي، نو npm config set proxy … او د راجستر عکس پلي کیږي — یا یو نیمګړی پخوانی نصب، کوم چې --reset-runtime پاکوي.

"the local playground exited before it was ready"، یا دا هېڅکله چمتو نه شي

د رن ټایم د خپل محصول د لیدلو لپاره zinnector dev --verbose اجرا کړئ. لا دمخه په کارول شوي پورټ کې عام دی: zinnector dev --port 9401، یا په zinnector.json کې port وټاکئ. یو رن ټایم چې نصب شوی مګر بوټ نه شي: zinnector dev --reset-runtime. لومړی بوټ پخپله WordPress هم ډاونلوډ کوي، نو په ورو اتصال کې دې ته څو دقیقې وخت ورکړئ؛ CLI د ځنډ راپور ورکولو پر ځای د ځنډ وخت (timeout) څخه مخکې تر پنځو پورې انتظار باسي.

د پش پر مهال "this project is not a git repository"

ډپلایس د ریپوزیتوري څخه پرمخ وړل کیږي، نو zinnector push یو داسې ته اړتیا لري چې یو ریموټ ولري چې پلیټ فارم ورته لاسرسی ومومي. git init && git add -A && git commit -m initial، خپل د GitHub یا GitLab ریموټ اضافه کړئ، او بیا د دې لپاره چې دا له سایټ سره وصل کړئ zinnector link اجرا کړئ.

سایټ د ډپلای کولو وروسته سپین دی

zinnector check اجرا کړئ. په لسو کې نېسې ځلې دا د PHP نسخې واټن دی — تاسو په داسې PHP جوړ کړی چې د سلاټ له چلیدو څخه نوی دی — او راپور ښيي چې کومې نسخې ته باید د zinnector php <version> په واسطه سلاټ بدل شي، یا د کوم په وړاندې چې باید پرمختګ وکړي د zinnector dev --php <version>. zinnector logs --error پخپله فیتل (fatal) ښيي.

اړوند

• پیل کول · سیمه ییز پرمختګ · ډپلای کول · د قوماندې حواله