Kurz: Instalace a použití balíčků s nástrojem MSBuild v sadě Visual Studio

V tomto kurzu se dozvíte, jak vytvořit program "Hello World" jazyka C++, který používá knihovnu fmt s MSBuild, vcpkg a sadou Visual Studio. Nainstalujete závislosti, nakonfigurujete projekt, sestavíte a spustíte jednoduchou aplikaci.

Požadavky

1. Nastavení vcpkg

  1. Klonování úložiště

    Prvním krokem je klonování úložiště vcpkg z GitHubu. Úložiště obsahuje skripty pro získání spustitelného souboru vcpkg a registru kurátorovaných opensourcových knihoven spravovaných komunitou vcpkg. Provedete to spuštěním tohoto příkazu:

    git clone https://github.com/microsoft/vcpkg.git

    Kurátorovaný registr vcpkg je sada více než 2 000 opensourcových knihoven. Tyto knihovny ověřily kanály kontinuální integrace vcpkg, aby spolupracovaly. I když úložiště vcpkg neobsahuje zdrojový kód pro tyto knihovny, obsahuje recepty a metadata pro sestavení a instalaci v systému.

  2. Spuštění skriptu bootstrap

    Teď, když jste naklonovali úložiště vcpkg, přejděte do vcpkg adresáře a spusťte spouštěcí skript:

    cd vcpkg && bootstrap-vcpkg.bat

    cd vcpkg; .\bootstrap-vcpkg.bat

    cd vcpkg && ./bootstrap-vcpkg.sh

    Skript bootstrap provádí kontroly požadovaných součástí a stáhne spustitelný soubor vcpkg.

    A je to! Vcpkg je nastavena a připravena k použití.

  1. Integrace se sadou Visual Studio MSBuild

    Dalším krokem je povolení integrace vcpkg pro celou uživatele, díky čemuž nástroj MSBuild o instalační cestě vcpkg vcpkg.

    Spustit

    .\vcpkg.exe integrate install

    Výstup bude následující:

    All MSBuild C++ projects can now #include any installed libraries. Linking will be handled automatically. Installing new libraries will make them instantly available.

2. Nastavení projektu sady Visual Studio

  1. Vytvoření projektu sady Visual Studio

    • Vytvoření nového projektu v sadě Visual Studio pomocí šablony Konzolová aplikace

      vytvoření nové konzolové aplikace C++ pro Windows

    • Pojmenujte projekt "helloworld"

    • Zaškrtněte políčko Umístit řešení a projekt do stejného adresáře.

    • Klikněte na tlačítko Vytvořit.

      Pojmenování projektu MSBuild C++

  2. Nakonfigurujte proměnnou VCPKG_ROOT prostředí.

    Poznámka:

    Nastavení proměnných prostředí tímto způsobem ovlivní pouze aktuální relaci terminálu. Pokud chcete tyto změny provést trvale ve všech relacích, nastavte je na panelu Proměnných systému Windows.

    Otevřete integrované okno Developer PowerShellu v sadě Visual Studio.

    otevření integrovaného vývojářského powershellu

    Spusťte následující příkazy:

    $env:VCPKG_ROOT = "C:\path\to\vcpkg"
$env:PATH = "$env:VCPKG_ROOT;$env:PATH"

    nastavení proměnných prostředí

    Otevřete příkazový řádek Vývojář v sadě Visual Studio.

    otevřete příkazový řádek pro vývojáře sady Visual Studio.

    Spusťte následující příkazy:

    set "VCPKG_ROOT=C:\path\to\vcpkg"
set PATH=%VCPKG_ROOT%;%PATH%

    nastavení proměnných prostředí

    Nastavení VCPKG_ROOT pomáhá sadě Visual Studio najít instanci vcpkg. Přidáním zajistíte, že PATH můžete spouštět příkazy vcpkg přímo z prostředí.

  3. Vygenerujte soubor manifestu a přidejte závislosti.

    Spuštěním následujícího příkazu vytvořte soubor manifestu vcpkg (vcpkg.json):

    vcpkg new --application

    Příkaz vcpkg new přidá vcpkg.json soubor a vcpkg-configuration.json soubor do adresáře projektu.

    fmt Přidejte balíček jako závislost:

    vcpkg add port fmt

    Vaše teď vcpkg.json by měla obsahovat:

    {
    "dependencies": [
        "fmt"
    ]
}

    Toto je váš soubor manifestu. Vcpkg přečte soubor manifestu, aby se dozvěděl, jaké závislosti se mají nainstalovat a integrovat s nástrojem MSBuild, aby poskytoval závislosti vyžadované vaším projektem.

    Vygenerovaný vcpkg-configuration.json soubor představuje směrný plán , který u závislostí projektu umístí omezení minimální verze. Úprava tohoto souboru je nad rámec tohoto kurzu. I když se v tomto kurzu nedá použít, je vhodné zachovat vcpkg-configuration.json soubor pod správou zdrojového kódu, abyste zajistili konzistenci verzí v různých vývojových prostředích.

3. Nastavení souborů projektu

  1. Upravte soubor helloworld.cpp.

    helloworld.cpp Obsah nahraďte následujícím kódem:

    #include <fmt/core.h>

int main()
{
    fmt::print("Hello World!\n");
    return 0;
}

    Tento zdrojový soubor obsahuje hlavičku <fmt/core.h> , která je součástí fmt knihovny. Funkce main() volá fmt::print() výstup zprávy "Hello World!" do konzoly.

    Poznámka:

    Editor kódu může podtrhnout řádky odkazující fmt na soubory a symboly jako chyby. Abyste mohli nainstalovat závislosti, musíte projekt sestavit jednou pro vcpkg a správně vyhodnotit kód pomocí nástrojů pro automatické dokončování.

4. Povolení režimu manifestu

  1. Přejděte na stránku Vlastností projektu.

    Pomocí navigace v nabídce v horní části zvolte > projektu. Otevře se nové okno.

  2. Přejděte na vlastnosti > konfigurace vcpkg a nastavte Use vcpkg Manifest na Yes.

    Povolení režimu manifestu ve vlastnostech projektu

    Další nastavení, jako jsou trojité hodnoty, jsou vyplněna výchozími hodnotami vcpkg rozpoznány z projektu a budou užitečná při konfiguraci projektu.

5. Sestavení a spuštění projektu

  1. Sestavte projekt.

    Sestavte projekt pomocí možnosti Build > Build Solution z nabídky nahoře.

    Pokud nástroj MSBuild zjistí vcpkg.json , že v projektu jsou povoleny soubory a manifesty, nástroj MSBuild nainstaluje závislosti manifestu jako krok před sestavením. Závislosti se instalují do vcpkg_installed adresáře ve výstupním adresáři sestavení projektu. Všechny hlavičky nainstalované knihovnou je možné použít přímo a všechny nainstalované knihovny se automaticky propojily.

  2. Aplikaci spusťte.

    Nakonec spusťte spustitelný soubor:

    Spuštění spustitelného souboru

    Měl by se zobrazit výstup:

    Výstup programu

Další kroky

Další informace o vcpkg.json integraci nástroje MSBuild a vcpkg najdete v referenční dokumentaci:

  • Last updated on