Condividi tramite

Esercitazione: Installare e usare pacchetti con MSBuild in Visual Studio

Questa esercitazione illustra come creare un programma "Hello World" C++ che usa la fmt libreria con MSBuild, vcpkg e Visual Studio. Si installeranno le dipendenze, si configureranno il progetto, la compilazione e si eseguirà una semplice applicazione.

Prerequisiti

1 - Configurare vcpkg

  1. Clonare il repository

    Il primo passaggio consiste nel clonare il repository vcpkg da GitHub. Il repository contiene script per acquisire l'eseguibile vcpkg e un registro di librerie open source curate gestite dalla community vcpkg. A tale scopo, eseguire:

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

    Il registro curato vcpkg è un set di oltre 2.000 librerie open source. Queste librerie sono state convalidate dalle pipeline di integrazione continua di vcpkg per collaborare. Anche se il repository vcpkg non contiene il codice sorgente per queste librerie, contiene ricette e metadati per compilarli e installarli nel sistema.

  2. Eseguire lo script bootstrap

    Dopo aver clonato il repository vcpkg, passare alla vcpkg directory ed eseguire lo script bootstrap:

    cd vcpkg && bootstrap-vcpkg.bat

    cd vcpkg; .\bootstrap-vcpkg.bat

    cd vcpkg && ./bootstrap-vcpkg.sh

    Lo script bootstrap esegue i controlli dei prerequisiti e scarica il file eseguibile vcpkg.

    Ecco fatto! vcpkg è configurato e pronto per l'uso.

  1. Integrazione con Visual Studio MSBuild

    Il passaggio successivo consiste nell'abilitare l'integrazione vcpkg a livello di utente, in modo che MSBuild sia consapevole del percorso di installazione di vcpkg.

    Run

    .\vcpkg.exe integrate install

    Verrà restituito questo output:

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

2 - Configurare il progetto di Visual Studio

  1. Creare il progetto di Visual Studio

    • Creare un nuovo progetto in Visual Studio usando il modello "Applicazione console"

      creare una nuova applicazione console Windows C++

    • Assegnare al progetto il nome "helloworld"

    • Selezionare la casella "Inserisci soluzione e progetto nella stessa directory".

    • Fare clic sul pulsante "Crea"

      Denominazione del progetto C++ di MSBuild

  2. Configurare la variabile di ambiente VCPKG_ROOT.

    Nota

    L'impostazione delle variabili di ambiente in questo modo influisce solo sulla sessione del terminale corrente. Per rendere permanenti queste modifiche in tutte le sessioni, impostarle tramite il pannello Variabili di ambiente del sistema Windows.

    Aprire la finestra predefinita di PowerShell per sviluppatori in Visual Studio.

    apertura di PowerShell per sviluppatori predefiniti

    Eseguire i comandi seguenti:

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

    configurazione delle variabili di ambiente

    Aprire il prompt dei comandi per gli sviluppatori in Visual Studio.

    apertura del prompt dei comandi per gli sviluppatori di Visual Studio.

    Eseguire i comandi seguenti:

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

    configurazione delle variabili di ambiente

    L'impostazione VCPKG_ROOT consente a Visual Studio di individuare l'istanza di vcpkg. Aggiungendolo per PATH assicurarsi di poter eseguire comandi vcpkg direttamente dalla shell.

  3. Generare un file manifesto e aggiungere dipendenze.

    Eseguire il comando seguente per creare un file manifesto vcpkg (vcpkg.json):

    vcpkg new --application

    Il vcpkg new comando aggiunge un vcpkg.json file e un vcpkg-configuration.json file nella directory del progetto.

    Aggiungere il fmt pacchetto come dipendenza:

    vcpkg add port fmt

    Il vcpkg.json file dovrebbe ora contenere:

    {
    "dependencies": [
        "fmt"
    ]
}

    Questo è il file manifesto. vcpkg legge il file manifesto per informazioni sulle dipendenze da installare e integrare con MSBuild per fornire le dipendenze richieste dal progetto.

    Il file generato vcpkg-configuration.json introduce una baseline che inserisce vincoli di versione minimi sulle dipendenze del progetto. La modifica di questo file non rientra nell'ambito di questa esercitazione. Anche se non applicabile in questa esercitazione, è consigliabile mantenere il file sotto il controllo del vcpkg-configuration.json codice sorgente per garantire la coerenza delle versioni in ambienti di sviluppo diversi.

3 - Configurare i file di progetto

  1. Modificare il file helloworld.cpp.

    Sostituire il contenuto di helloworld.cpp con il codice seguente:

    #include <fmt/core.h>

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

    Questo file di origine include l'intestazione <fmt/core.h> che fa parte della fmt libreria. La main() funzione chiama fmt::print() per inviare il messaggio "Hello World!" alla console.

    Nota

    L'editor di codice può sottolineare le righe che fmt fanno riferimento a file e simboli come errori. È necessario compilare il progetto una volta per vcpkg per installare le dipendenze e fare in modo che gli strumenti di completamento automatico valutino correttamente il codice.

4 - Abilitare la modalità manifesto

  1. Passare alla pagina Proprietà progetto.

    Usando lo spostamento di menu nella parte superiore, scegliere > progetto. Verrà aperta una nuova finestra.

  2. Passare a > e impostare su Use vcpkg Manifest.Yes

    Abilitare la modalità manifesto nelle proprietà del progetto

    Altre impostazioni, ad esempio triplette, vengono compilate con i valori predefiniti rilevati da vcpkg dal progetto e saranno utili durante la configurazione del progetto.

5 - Compilare ed eseguire il progetto

  1. Compilare il progetto.

    Compilare il progetto usando l'opzione Build > Build Solution dal menu in alto.

    Se MSBuild rileva un vcpkg.json file e manifesti sono abilitati nel progetto, MSBuild installa le dipendenze del manifesto come passaggio di pre-compilazione. Le dipendenze vengono installate in una vcpkg_installed directory nella directory di output di compilazione del progetto. Tutte le intestazioni installate dalla libreria possono essere usate direttamente e tutte le librerie installate verranno collegate automaticamente.

  2. Eseguire l'applicazione.

    Infine, eseguire il file eseguibile:

    Esecuzione del file eseguibile

    Verrà visualizzato l'output:

    Output del programma

Passaggi successivi

Per altre informazioni sull'integrazione vcpkg.json di MSBuild vcpkg, vedere la documentazione di riferimento:

  • Last updated on