Hitilafu ambazo watu hukabiliana nazo kihalisi wanapotumia CLI ya Zinnector®, maana ya kila moja, na suluhisho lake. Kila kipengee kinataja maandishi kamili mtakayoyaona, ili muweze kuyatafuta kwenye ukurasa huu. Ikiwa hitilafu yenu haipo hapa, endesheni amri inayofeli ikiwa na ZINNECTOR_DEBUG=1 na mfungue suala kwenye github.com/Zinn-Digital/zinnector/issues pamoja na matokeo hayo, node --version yenu na mfumo wenu wa uendeshaji.
"spawn EINVAL" mara tu baada ya kukubali usakinishaji wa runtime (Windows)
Hitilafu katika Zinnector® 0.1.0 na 0.1.1. Kwenye Windows kisakinishi cha runtime kiliendesha npm.cmd kwa jina, na Node imekataa kuzalisha faili ya .cmd bila shell tangu marekebisho yake ya CVE-2024-27980 — hivyo usakinishaji ulikwama sekunde moja baada ya ninyi kujibu Y. Imerekebishwa katika 0.1.2: npm sasa inaendeshwa kama node npm-cli.js, ambayo ni sawa kwenye kila jukwaa na haihitaji shell. Endesheni npm install -g zinnector@latest, kisha zinnector dev tena.
"npm WARN EBADENGINE" wakati wa usakinishaji, au "Zinnector® needs Node 24 or newer"
Node yenu ni ya zamani kuliko 24. npm inachapisha onyo kwa sababu kifurushi kinabainisha engines: >=24.18.1; usakinishaji unakamilika hata hivyo, lakini zinnector kisha inakataa kuanza (msimbo wa kutoka 78) badala ya kufeli mahali panapochanganya baadaye. Sakinisheni LTS ya sasa kutoka nodejs.org — winget install OpenJS.NodeJS.LTS kwenye Windows, brew install node@24 kwenye macOS — thibitisheni kuwa node --version inachapisha v24 au ya juu zaidi, na msakinishe Zinnector® tena.
"gyp ERR!", "Building from source with node-gyp", au "You need to install Visual Studio"
Runtime ya WordPress ina moduli asilia ambayo jozi zake zilizoundwa awali zipo kwa ajili ya Node 24 na 25 pekee. Kwenye Node mpya zaidi (26 na kuendelea, kuanzia Septemba 2026) kisakinishi chake kinarudi nyuma kwenye kukusanya kutoka kwenye msimbo chimbuko, jambo ambalo kwenye mashine ya kawaida ya Windows huishia kwenye ombi la Visual Studio. Imerekebishwa katika 0.1.2: Zinnector® hutambua hili kabla ya kupakua chochote na huchukua Node 24 kwa ajili ya runtime pekee — takriban MB 30, iliyothibitishwa dhidi ya jumlasahihisho za nodejs.org — hivyo hakuna kinachokusanywa kamwe. Mkiendelea kuiona baada ya kuboresha, endesheni zinnector dev --reset-runtime ili usakinishaji uliokamilika nusu kutoka awali utupwe kwanza.
Maonyo ya "EPERM" kutoka kwa npm wakati inafanya usafi (Windows)
Karibu kila mara huwa ni kichanganuzi cha kirusi au kielezo cha utafutaji kinachoshikilia faili wazi chini ya node_modules ya runtime wakati npm inapojaribu kuiondoa. Usakinishaji unajaribiwa tena kutoka kwenye saraka safi kwenye zinnector dev inayofuata; ikiwa inaendelea kutokea, zinnector dev --reset-runtime huondoa saraka nzima ya runtime kwanza na kusakinisha tena.
"the local playground runtime could not be installed"
Ujumbe huo unajumuisha mistari ya mwisho ya npm yenyewe na amri kamili ambayo Zinnector® iliendesha, ili muweze kuiendesha ninyi wenyewe na kuona matokeo kamili. Sababu za kawaida ni tatizo la mtandao au proksi — runtime inachukuliwa kwa npm yenu wenyewe, hivyo npm config set proxy … na kioo cha sajili vinatumika — au usakinishaji wa awali uliokamilika nusu, ambao --reset-runtime huufuta.
"the local playground exited before it was ready", au haiko tayari kamwe
Endesheni zinnector dev --verbose ili kuona matokeo ya runtime yenyewe. Mlango ambao tayari unatumika ndio wa kawaida: zinnector dev --port 9401, au wekeni port katika zinnector.json. Runtime iliyosakinishwa lakini isiyowaka: zinnector dev --reset-runtime. Kuwaka kwa mara ya kwanza pia kunapakua WordPress yenyewe, hivyo kwenye muunganisho wa polepole ipeeni dakika chache; CLI inasubiri hadi tano kabla ya kuripoti kuisha kwa muda badala ya kukwama.
"this project is not a git repository" wakati wa ku-push
Upelekaji unaendeshwa kutoka kwenye ghala, hivyo zinnector push inahitaji ghala lenye rimoti ambayo jukwaa linaweza kuifikia. git init && git add -A && git commit -m initial, ongezeni rimoti yenu ya GitHub au GitLab, kisha zinnector link ili kuiunganisha kwenye tovuti.
Tovuti ni nyeupe baada ya upelekaji
Endesheni zinnector check. Mara tisa kati ya kumi huwa ni pengo la toleo la PHP — mliunda kwenye PHP mpya zaidi kuliko ile nafasi inayoendesha — na ripoti inasema ni toleo gani la kubadilishia nafasi hiyo kwa kutumia zinnector php <version>, au lipi la kutengenezea kwa kutumia zinnector dev --php <version>. zinnector logs --error inaonyesha hitilafu mbaya yenyewe.
Yanayohusiana