Ugrás a fő tartalomhoz

Prepros projekt hozzáadási probléma megoldása (Windows 11 + WSL2)

Hiba leírása​

A Prepros alkalmazás Windows 11 alatt nem tud közvetlenül projektként hozzáadni olyan mappákat, amelyek UNC (Universal Naming Convention) útvonallal rendelkeznek. Ez különösen akkor fordul elő, ha a projektmappa egy WSL2 (Windows Subsystem for Linux 2) környezetben található, mivel annak útvonala Windows alól UNC formátumban érhető el

(pl. \\wsl$\Ubuntu\home\felhasználóneved\projekt).

A Prepros által megjelenített hibaüzenet: "Folder with a UNC path can not be added as a project. Use 'Map Network Drive' to assign a drive letter to the folder." (UNC útvonallal rendelkező mappa nem adható hozzá projektként. Használd a 'Hálózati meghajtó társítása' funkciót, hogy meghajtóbetűt rendelj a mappához.)

A mklink /j paranccsal történő próbálkozás esetén a következő hiba jelentkezhet: "Local volumes are required to complete the operation." (Helyi kötetek szükségesek a művelet befejezéséhez.) Ez azért van, mert a junction pointok csak helyi NTFS fájlrendszeren belüli mappák között működnek.

Megoldások​

A probléma megoldására két fő módszer létezik: a hálózati meghajtó társítása, vagy szimbolikus link létrehozása. Mindkettő lehetővé teszi, hogy a Prepros "helyi" útvonalként kezelje a WSL2 mappát.

1. Megoldás: hálózati meghajtó társítása (ajánlott)​

Ez a legegyszerűbb és a Prepros által is javasolt módszer. Egy meghajtóbetűt (pl. Z:) rendelünk a WSL2 mappához, így az Windows alól helyi meghajtóként jelenik meg. Lépések:

  1. Nyisd meg a Fájlkezelőt (File Explorer):
    • Kattints a tálcán lévő mappa ikonra, vagy nyomd meg a Windows billentyű + E billentyűkombinációt.
  2. Navigálj a "This PC" (Ez a gép) elemre:
    • A bal oldali navigációs panelen válaszd ki a "This PC" elemet.
  3. Indítsd el a "Hálózati meghajtó társítása" funkciót:
    • A felső menüszalagon kattints a "..." (három pont) ikonra, majd válaszd a "Map network drive" (Hálózati meghajtó társítása) lehetőséget. (Előfordulhat, hogy közvetlenül is megjelenik a "Map network drive" gomb a szalagon.)
  4. Konfiguráld a hálózati meghajtót:
    • Meghajtó (Drive): Válassz egy szabad meghajtóbetűt a legördülő menüből (pl. Z:).
    • Mappa (Folder): Írd be a WSL2 mappád UNC útvonalát.
      • Hogyan találd meg a WSL2 mappa UNC útvonalát?
        • Nyisd meg a Fájlkezelőt Windowsban.
        • A bal oldali navigációs panelen görgess le a "Linux" szekcióhoz.
        • Kattints az általad használt Ubuntu disztribúcióra (pl. "Ubuntu").
        • Navigálj a projektmappádhoz (pl. var\www vagy home\felhasználóneved\projektmappa).
        • Amikor a mappában vagy, kattints a Fájlkezelő címsorába, és másold ki az ott megjelenő UNC útvonalat (pl. \\wsl$\Ubuntu\var\www).
    • Jelöld be a "Reconnect at sign-in" (Újracsatlakozás bejelentkezéskor) négyzetet, ha szeretnéd, hogy a meghajtó automatikusan csatlakozzon minden bejelentkezéskor.
    • Kattints a "Befejezés" (Finish) gombra.
  5. Add hozzá a Prepros-hoz:
    • Most már a Preprosban a társított meghajtóbetűs útvonalat (pl. Z:\var\www) használhatod a projekt hozzáadásakor.

Ez a módszer egy "virtuális" mappát hoz létre a Windows fájlrendszerében, amely a WSL2 mappára mutat. Ez kissé összetettebb, mint a hálózati meghajtó társítása, de hasznos lehet bizonyos speciális esetekben.

Fontos: A mklink /j (junction point) parancs nem működik hálózati útvonalakkal (beleértve a WSL2 útvonalakat is). Helyette a mklink /d (szimbolikus könyvtárlink) parancsot kell használni.

Lépések:

  1. Nyisd meg a Parancssort (CMD) vagy a PowerShellt rendszergazdaként:
    • Keresd meg a "cmd" vagy "powershell" kifejezést a Start menüben.
    • Kattints jobb gombbal a találatra, és válaszd a "Futtatás rendszergazdaként" (Run as administrator) lehetőséget.
  2. Hozd létre a szimbolikus linket:

    • Írd be a következő parancsot, és nyomd meg az Entert:

      mklink /d C:\helyi_projekt_elérés \\wsl$\Ubuntu\var\www

      Magyarázat:

      • mklink /d: Ez a parancs szimbolikus könyvtárlinket hoz létre. A /d kapcsoló jelzi, hogy könyvtárra vonatkozik, és hálózati útvonalakat is támogat.
      • C:\helyi_projekt_elérés: Ez lesz az a mappa útvonal, amit a Preprosban projektként meg fogsz adni. Válassz egy beszédes nevet, ami illeszkedik az igényeidhez (pl. C:\wsl-projekt).
      • \\wsl$\Ubuntu\var\www: Ez a WSL2 (Ubuntu) környezetben lévő valós projektmappa UNC útvonala. Győződj meg róla, hogy ez az útvonal pontos!
  3. Ellenőrizd a linket:
    • A Fájlkezelőben navigálj a C:\ meghajtóra. Látnod kell a helyi_projekt_elérés mappát (vagy amit Te adtál neki), amelynek ikonja egy kis nyilat tartalmaz, jelezve, hogy szimbolikus linkről van szó.
  4. Add hozzá a Prepros-hoz:
    • Most már a Preprosban a szimbolikus link útvonalát (pl. C:\helyi_projekt_elérés) adhatod meg projektmappaként.

Összefoglalás​

A Prepros és a WSL2 közötti együttműködéshez elengedhetetlen, hogy a WSL2-ben tárolt projektmappa Windows számára "helyi" útvonalként legyen elérhető. Erre a hálózati meghajtó társítása a legegyszerűbb és legajánlottabb módszer. Ha valamilyen okból mégis szimbolikus linkre van szükséged, ne feledd, hogy a mklink /d parancsot használd a mklink /j helyett hálózati útvonalakhoz.