vcpkg telepítése

Áttekintés

• klasszikus módú

vcpkg install [options] <package>...

• Jegyzék mód

vcpkg install [options]

Leírás

Portcsomagok létrehozása és telepítése.

Klasszikus mód

klasszikus módbanez az ige portcsomagokat ad hozzá a telepített könyvtár meglévő készletéhez (alapértelmezés szerint a vcpkg gyökér alatt installed/). Ez szükségessé teheti a meglévő csomagok eltávolítását és újraépítését, ami sikertelen lehet.

Csomag szintaxisa

portname[feature1,feature2]:triplet

A tripla nélküli csomaghivatkozásokat automatikusan az alapértelmezett cél hármasminősíti. A core explicit módon nem listázó csomaghivatkozások az összes alapértelmezett funkciót jelentik.

Jegyzék mód

Jegyzék módbanez a parancs beállítja a telepített címtár at a vcpkg.json jegyzékfájl által megadott állapotra, szükség szerint csomagokat adhat hozzá, távolíthat el vagy újraépíthet.

Beállítások

Az összes vcpkg-parancs támogatja gyakori beállításokat.

--allow-unsupported

Ahelyett, hogy nem támogatott porton áll meg, folytassa egy figyelmeztetéssel.

Alapértelmezés szerint a vcpkg nem hajlandó végrehajtani egy olyan telepítési tervet, amely a "supports" záradékán kívüli triplatelepítést tartalmaz. A csomag "supports" záradéka leírja, hogy egy csomagnak milyen platformokra kell épülnie. Ez a jelző arra utasítja a vcpkg-t, hogy figyelmeztessen arra, hogy a build leállása helyett várhatóan sikertelen lesz.

--clean-after-build

Az egyes csomagok létrehozása után tisztítsa meg a buildeket, csomagokat és letöltéseket.

Ez a beállítás ugyanazzal a hatással rendelkezik, mint a --clean-buildtrees-after-build, --clean-downloads-after-buildés --clean-packages-after-buildátadása.

--clean-buildtrees-after-build

Az egyes csomagok létrehozása után törölje az összes alkönyvtárat a buildtrees ideiglenes almappájából.

A buildtrees almappában (például buildtrees/zlib/config-x64-windows-out.log) lévő összes legfelső szintű fájl megmarad. Minden alkönyvtár törlődik.

--clean-downloads-after-build

Az egyes csomagok létrehozása után törölje a downloads/ mappából az összes felderítetlen objektumot.

A downloads/ mappában lévő összes legfelső szintű fájl törlődik. A kinyert eszközöket megtartjuk.

--clean-packages-after-build

Az egyes csomagok létrehozása után törölje az ideiglenes almappát.

A beépített csomag csomag almappája (például packages/zlib_x64-windows) a telepítés után törlődik.

--dry-run

Nyomtassa ki a telepítési tervet, de ne távolítsa el vagy telepítse a csomagokat.

A telepítési terv felsorolja az összes telepített csomagot és szolgáltatást, valamint azokat a csomagokat, amelyeket el kell távolítani és újra kell létrehozni.

--editable

• klasszikus mód csak

Szerkeszthető buildek végrehajtása a parancssorban található összes közvetlenül hivatkozott csomaghoz.

Amikor a vcpkg portokat hoz létre, minden alkalommal törli és kinyeri a forráskódot, hogy a bemenetek pontosak legyenek. Erre azért van szükség, hogy a Jegyzék mód pontosan frissítse a telepített tartalmat, valamint a bináris gyorsítótárazást, hogy a gyorsítótárazott tartalom helyes legyen.

A --editable jelző átadása letiltja ezt a viselkedést, és megőrzi a buildtrees/ mappában lévő kinyert forrásokra vonatkozó módosításokat. Ez segít a javítások gyors fejlesztésében azáltal, hogy nem kell fájlokat írni az egyes módosításokra.

A szerkeszthető buildek során kinyert források nem rendelkeznek .clean/ utótagtal a címtár nevére, és a későbbi nem szerkeszthető buildek nem törlik.

--enforce-port-checks

Sikertelen telepítés, ha egy port problémákat észlelt, vagy elavult funkciót próbál használni.

Alapértelmezés szerint a vcpkg több ellenőrzést futtat a beépített csomagokon, és figyelmeztetéseket küld, ha bármilyen problémát észlel. Ez a jelző hibaként frissíti ezeket a figyelmeztetéseket.

--x-feature=<feature>

Jegyzet

Ez a szakasz a vcpkg egy kísérleti funkcióját ismerteti, amely bármikor megváltozhat vagy eltávolítható.

• Jegyzék mód csak

Adjon meg egy további funkciót, a vcpkg.json a függőségek telepítéséhez.

Alapértelmezés szerint csak "dependencies" és a "default-features" függőségei lesznek telepítve.

--head

• klasszikus mód csak

Kérje meg a parancssorban kifejezetten hivatkozott összes csomagot, hogy lekérje az összeállításkor rendelkezésre álló legújabb forrásokat.

Ez a jelző csak ideiglenes tesztelésre szolgál, és nem éles vagy hosszú távú használatra készült. Ez letiltja bináris gyorsítótárazási az összes kifejezetten hivatkozott csomaghoz és azok függőihez, mivel a vcpkg nem tudja pontosan nyomon követni az összes bemenetet.

--keep-going

Az első hiba után folytassa a telepítési tervet.

Alapértelmezés szerint a vcpkg leáll az első csomag buildelési hibájánál. Ez a jelző arra utasítja a vcpkg-t, hogy folytassa a telepítési terv más részeinek létrehozását és telepítését, amelyek nem függenek a sikertelen csomagtól.

--x-no-default-features

Jegyzet

Ez a szakasz a vcpkg egy kísérleti funkcióját ismerteti, amely bármikor megváltozhat vagy eltávolítható.

• Jegyzék mód csak

Ne telepítse az alapértelmezett szolgáltatásokat a legfelső szintű jegyzékből.

Ha a install Jegyzék módban használja, alapértelmezés szerint a "default-features" felsorolt funkciók összes függősége telepítve lesz. Ez a jelző letiltja ezt a viselkedést, így csak a --x-feature által kifejezetten engedélyezett funkciók lesznek telepítve.

--no-downloads

Csomag létrehozásakor megakadályozza, hogy a portok új eszközöket töltsenek le a buildelés során.

Alapértelmezés szerint a portok igény szerinti forráskódot és eszközöket szereznek be az internetről (eszköz gyorsítótárazási). Ez a paraméter letiltja a letöltéseket, és csak a számítógépen korábban letöltött és gyorsítótárazott eszközökre korlátozza a portokat.

--only-downloads

Próbálja meg letölteni a telepítési tervhez szükséges összes eszközt buildek nélkül.

Ha ezt a lehetőséget adta meg, a vcpkg addig futtatja a csomag összes buildjét, amíg meg nem indítja az első nem letöltött külső folyamathívást. A legtöbb port az első külső folyamathívás (általában a buildelési rendszer) előtt hajtja végre az összes letöltést, így ez az eljárás letölti az összes szükséges eszközt. Az eljárást nem követő portok nem töltik le előre az eszközeiket.

--only-binarycaching

Megtagadhatja a buildek végrehajtását. Csak bináris gyorsítótárakból.

Ez a jelző megakadályozza, hogy a vcpkg igény szerint végezzen buildeket, és sikertelen lesz, ha egy csomag nem található bináris gyorsítótárakban.

--recurse

• klasszikus mód csak

A csomagok újraépítését igénylő telepítési terv jóváhagyása.

A telepített csomagok funkcióinak módosításához a vcpkg-nek el kell távolítania és újra kell építenie a csomagot. Mivel ez a hiba lehetséges, és kevesebb csomaggal hagyja el a telepítési fát, mint a felhasználó, a felhasználónak jóvá kell hagynia a csomagokat újraépítő terveket a jelző átadásával.

--x-write-nuget-packages-config

Jegyzet

Ez a szakasz a vcpkg egy kísérleti funkcióját ismerteti, amely bármikor megváltozhat vagy eltávolítható.

Egy NuGet-packages.configformátumú fájlt ír ki bináris gyorsítótárazási.

Ez a beállítás a --dry-run együtt használható a bináris gyorsítótárazással szükséges NuGet-csomagok listájának beszerzéséhez anélkül, hogy csomagokat kellene létrehoznia vagy telepítenie. Ez lehetővé teszi a NuGet parancssor külön meghívását speciális forgatókönyvek esetén, például alternatív protokollok használatával a .nupkg fájlok beszerzéséhez.

--no-print-usage

Tiltsa le a telepítés végén kinyomtatott használati szöveg létrehozását.