ተጠቃሚዎች ከZinnector® CLI ጋር የሚያጋጥሟቸው ትክክለኛ ስህተቶች፣ የእያንዳንዳቸው ትርጉም እና መፍትሔው። እያንዳንዱ ምዝገባ የሚያዩትን ትክክለኛ ጽሁፍ ይጠቅሳል፣ ስለዚህ በዚህ ገጽ ላይ ሊፈልጉት ይችላሉ። የእርስዎ እዚህ ከሌለ፣ ያልተሳካውን ትዕዛዝ በZINNECTOR_DEBUG=1 ያሂዱ እና ከውጤቱ፣ ከእርስዎ node --version እና ከስርዓተ ክወናዎ ጋር በ github.com/Zinn-Digital/zinnector/issues ላይ ችግር (issue) ይክፈቱ።
የruntime ጭነቱን ከተቀበሉ በኋላ ወዲያውኑ "spawn EINVAL" (Windows)
በZinnector® 0.1.0 እና 0.1.1 ውስጥ ያለ ሳንካ። በWindows ላይ የruntime ጫኚው npm.cmdን በስም ያስኬድ ነበር፣ እና Node ለCVE-2024-27980 መፍትሔ ከሰጠበት ጊዜ ጀምሮ ያለ ሼል የ.cmd ፋይልን ለማስነሳት ፈቃደኛ አልነበረም — ስለዚህ 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 ማስጠንቀቂያውን የሚያትመው ፓኬጁ engines: >=24.18.1 ብሎ ስለሚያውጅ ነው፤ ጭነቱ በማንኛውም ሁኔታ ይጠናቀቃል፣ ነገር ግን zinnector በኋላ ላይ ግራ በሚያጋባ ሁኔታ ከመክሸፍ ይልቅ መጀመርን አይቀበልም (exit code 78)። የአሁኑን LTS ከ nodejs.org ይጫኑ — በWindows ላይ 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 runtime ቀድመው የተገነቡ ባይነሪዎቻቸው ለNode 24 እና 25 ብቻ የሚገኙ ቤተኛ ሞጁል አለው። በአዲስ Node ላይ (ከሴፕቴምበር 2026 ጀምሮ፣ 26 እና ከዚያ በላይ) ጫኚው ከምንጭ ወደ ማጠናቀር (compiling) ይመለሳል፣ ይህም በተለመደው የWindows ማሽን ላይ ለVisual Studio ጥያቄ በማቅረብ ይጠናቀቃል። በ0.1.2 ተስተካክሏል፡ Zinnector® ማንኛውንም ነገር ከማውረዱ በፊት ይህንን ይገነዘባል እና ለruntime ብቻ የሚሆን Node 24 ያመጣል — ወደ 30 ሜባ ገደማ፣ ከnodejs.org checksums ጋር የተረጋገጠ — ስለዚህ ምንም ነገር አይጠናቀርም። ካሻሻሉ በኋላም አሁንም ካዩት፣ ከበፊቱ በከፊል የተጠናቀቀው ጭነት መጀመሪያ እንዲወገድ zinnector dev --reset-runtimeን ያሂዱ።
npm ሲያጸዳ ከእሱ የሚመጡ የ"EPERM" ማስጠንቀቂያዎች (Windows)
npm ለማስወገድ በሚሞክርበት ጊዜ የጸረ-ቫይረስ ስካነር ወይም የፍለጋ መረጃ ጠቋሚ (indexer) በruntime node_modules ስር ፋይል ክፍት አድርጎ መያዙ ነው። በሚቀጥለው zinnector dev ላይ ጭነቱ ከንጹህ ማውጫ እንደገና ይሞከራል፤ መከሰቱ ከቀጠለ፣ zinnector dev --reset-runtime መጀመሪያ ሙሉውን የruntime ማውጫ ያስወግዳል እና እንደገና ይጭናል።
"the local playground runtime could not be installed"
መልዕክቱ የnpmን የራሱን የመጨረሻ መስመሮች እና Zinnector® ያሄደውን ትክክለኛ ትዕዛዝ ያካትታል፣ ስለዚህ እርስዎ እራስዎ ማስኬድ እና ሙሉውን ውጤት ማየት ይችላሉ። የተለመዱት ምክንያቶች የአውታረ መረብ ወይም የproxy ችግር ናቸው — runtime የሚመጣው በእርስዎ የራስዎ npm ነው፣ ስለዚህ npm config set proxy … እና የregistry mirror ተግባራዊ ይሆናሉ — ወይም በከፊል የተጠናቀቀ የቀድሞ ጭነት ነው፣ ይህም በ--reset-runtime የሚጸዳ ነው።
"the local playground exited before it was ready"፣ ወይም በጭራሽ ዝግጁ አይሆንም
የruntimeን የራሱን ውጤት ለማየት zinnector dev --verboseን ያሂዱ። ቀድሞውኑ አገልግሎት ላይ የዋለ ወደብ (port) የተለመደው ነው፡ zinnector dev --port 9401፣ ወይም በzinnector.json ውስጥ portን ያዘጋጁ። የተጫነ ነገር ግን የማይነሳ runtime፡ zinnector dev --reset-runtime። የመጀመሪያው ማስነሳት WordPressንም እራሱን ያወርዳል፣ ስለዚህ በዝግታ ግንኙነት ላይ ጥቂት ደቂቃዎችን ይስጡት፤ CLIው ከመቆም ይልቅ የጊዜ ማብቂያ ሪፖርት ከማድረጉ በፊት እስከ አምስት ደቂቃ ድረስ ይጠብቃል።
በpush ላይ "this project is not a git repository"
ዝርጋታዎች (deploys) የሚከናወኑት ከማከማቻ (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 ገዳይ የሆነውን ስህተት እራሱን ያሳያል።
ተዛማጅ