Tutorial: Instalación y uso de paquetes con MSBuild en Visual Studio
En este tutorial se muestra cómo crear un programa de "Hola mundo" de C++ que usa la fmt
biblioteca con MSBuild, vcpkg y Visual Studio. Instalará dependencias, configurará, compilará y ejecutará una aplicación sencilla.
Requisitos previos:
- Carga de trabajo de desarrollo de Visual Studio con C++
- Git
- Windows 7 o posterior
1 - Configurar vcpkg
Clonación del repositorio
El primer paso es clonar el repositorio vcpkg desde GitHub. El repositorio contiene scripts para adquirir el ejecutable vcpkg y un registro de bibliotecas de código abierto mantenidas mantenidas por la comunidad de vcpkg. Para hacerlo, ejecute lo siguiente:
git clone https://github.com/microsoft/vcpkg.git
El registro mantenido de vcpkg es un conjunto de más de 2000 bibliotecas de código abierto. Las canalizaciones de integración continua de vcpkg han validado estas bibliotecas para trabajar conjuntamente. Aunque el repositorio vcpkg no contiene el código fuente de estas bibliotecas, contiene recetas y metadatos para compilarlos e instalarlos en el sistema.
Ejecución del script de arranque
Ahora que ha clonado el repositorio vcpkg, vaya al
vcpkg
directorio y ejecute el script de arranque:cd vcpkg && bootstrap-vcpkg.bat
cd vcpkg; .\bootstrap-vcpkg.bat
cd vcpkg && ./bootstrap-vcpkg.sh
El script de arranque realiza comprobaciones de requisitos previos y descarga el ejecutable vcpkg.
Eso es todo. vcpkg está configurado y listo para usarse.
- Integración con MSBuild de Visual Studio
El siguiente paso consiste en establecer la instancia de todo el usuario de vcpkg para que MSBuild pueda encontrarlo:
.\vcpkg.exe integrate install
Esta es la salida:
All MSBuild C++ projects can now #include any installed libraries. Linking will be handled automatically. Installing new libraries will make them instantly available.
2- Configuración del proyecto de Visual Studio
Creación del proyecto de Visual Studio
- Creación de un proyecto en Visual Studio mediante la plantilla "Aplicación de consola"
Captura de pantalla de la interfaz de usuario de Visual Studio para mostrar cómo crear una nueva aplicación de consola de Windows de C++ en Visual Studio
- Asigne al proyecto el nombre "helloworld"
- Active la casilla "Colocar solución y proyecto en el mismo directorio".
- Haga clic en el botón "Crear".
Captura de pantalla de la interfaz de usuario de Visual Studio para asignar un nombre al proyecto de C++ de MSBuild y hacer clic en el botón "crear".
Configure la variable de entorno
VCPKG_ROOT
.Abra la ventana integrada de PowerShell para desarrolladores en Visual Studio.
Captura de pantalla de la interfaz de usuario de Visual Studio para la ventana de desarrollador integrada de PowerShell
Ejecute los comandos siguientes:
$env:VCPKG_ROOT = "C:\path\to\vcpkg" $env:PATH = "$env:VCPKG_ROOT;$env:PATH"
Captura de pantalla de la interfaz de usuario de Visual Studio para la ventana integrada para desarrolladores de PowerShell en la que se muestra cómo configurar VCPKG_ROOT y agregarla a PATH.
Nota:
Establecer variables de entorno de esta manera solo afecta a la sesión de terminal actual. Para realizar estos cambios permanentes en todas las sesiones, establézcalos en el panel Variables de entorno del sistema de Windows.
Abra el símbolo del sistema para desarrolladores en Visual Studio.
Captura de pantalla de la interfaz de usuario de Visual Studio para el símbolo del sistema para desarrolladores.
Ejecute los comandos siguientes:
set VCPKG_ROOT="C:\path\to\vcpkg" set PATH=%VCPKG_ROOT%;%PATH%
Captura de pantalla del símbolo del sistema para desarrolladores de Visual Studio que muestra cómo configurar VCPKG_ROOT y agregarlo a PATH.
Nota:
Establecer variables de entorno de esta manera solo afecta a la sesión de terminal actual. Para realizar estos cambios permanentes en todas las sesiones, establézcalos en el panel Variables de entorno del sistema de Windows.
La configuración
VCPKG_ROOT
ayuda a Visual Studio a localizar la instancia de vcpkg. Agregarlo aPATH
garantiza que puede ejecutar comandos vcpkg directamente desde el shell.Genere un archivo de manifiesto y agregue dependencias.
Ejecute el siguiente comando para crear un archivo de manifiesto vcpkg (
vcpkg.json
):vcpkg new --application
El
vcpkg new
comando agrega unvcpkg.json
archivo y unvcpkg-configuration.json
archivo en el directorio del proyecto.Agregue el
fmt
paquete como dependencia:vcpkg add port fmt
Ahora
vcpkg.json
debe contener:{ "dependencies": [ "fmt" ] }
Este es el archivo de manifiesto. vcpkg lee el archivo de manifiesto para obtener información sobre qué dependencias instalar e integrar con MSBuild para proporcionar las dependencias necesarias para el proyecto.
El archivo generado
vcpkg-configuration.json
presenta una línea base que coloca restricciones de versión mínimas en las dependencias del proyecto. La modificación de este archivo está fuera del ámbito de este tutorial. Aunque no es aplicable en este tutorial, se recomienda mantener el archivo bajo control de código fuente para garantizar lavcpkg-configuration.json
coherencia de las versiones en distintos entornos de desarrollo.
3 - Configurar los archivos del proyecto
Modifique el archivo helloworld.cpp
.
Reemplace el contenido de helloworld.cpp
por el código siguiente:
#include <fmt/core.h>
int main()
{
fmt::print("Hello World!\n");
return 0;
}
Este archivo de origen incluye el <fmt/core.h>
encabezado que forma parte de la fmt
biblioteca. La main()
función llama fmt::print()
a para generar el mensaje "Hola mundo!" en la consola.
Nota:
Habrá alternancias de error en el proyecto cuando MSBuild la realice por primera vez. Compile el proyecto para adquirir dependencias de vcpkg para quitarlas.
4- Habilitar el modo de manifiesto
Vaya a las páginas Propiedades del proyecto. En Propiedades de configuración vcpkg, establezca en Use vcpkg manifest
Yes
.> MSBuild comprueba si esta propiedad se establece antes de instalar las dependencias desde el manifiesto vcpkg.
Captura de pantalla de la habilitación del modo de manifiesto vcpkg en Propiedades del proyecto de Visual Studio
Otras opciones, como tripletas, se rellenan con valores predeterminados que vcpkg detecta desde el proyecto y serán útiles al configurar el proyecto.
5- Compilación y ejecución del proyecto
Compile el proyecto.
Presione
Ctrl+Shift+B
para compilar el proyecto en Visual Studio y adquirir las dependencias de vcpkg.
Si MSBuild detecta un vcpkg.json
archivo y los manifiestos están habilitados en el proyecto, MSBuild instala las dependencias del manifiesto como paso previo a la compilación. Las dependencias se instalan en un vcpkg_installed
directorio del directorio de salida de compilación del proyecto. Los encabezados instalados por la biblioteca se pueden usar directamente y todas las bibliotecas instaladas se vincularán automáticamente.
Nota:
vcpkg install
compila configuraciones de depuración y versión para una biblioteca. Para compilar solo bibliotecas de versiones, agregue VCPKG_RELEASE_ONLY
al triplet.
Ejecute la aplicación.
Por último, ejecute el archivo ejecutable:
Captura de pantalla de la interfaz de usuario de Visual Studio para ejecutar el ejecutable.
Deberías ver la salida:
Captura de pantalla de las salidas del programa: "Hola mundo!"
Pasos siguientes
Para obtener más información sobre vcpkg.json
y la integración de MSBuild de vcpkg, consulte nuestra documentación de referencia:
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de