Delen via

/Build (devenv.exe)

  • Artikel

Hiermee bouwt u een oplossing of project met behulp van een opgegeven oplossingsconfiguratiebestand.

Syntaxis

devenv SolutionName /Build [SolnConfigName [/Project ProjName [/ProjectConfig ProjConfigName]] [/Out OutputFilename]]

Argumenten

  • SolutionName-

    Vereist. Het pad en de naam van het oplossingsbestand ten opzichte van de map van de oplossing.

  • SolnConfigName-

    Facultatief. De naam van de oplossingsconfiguratie (zoals Debug of Release) die moet worden gebruikt voor het bouwen van de oplossing met de naam in SolutionName. Als er meerdere oplossingsplatforms beschikbaar zijn, moet u ook het platform opgeven (bijvoorbeeld Debug|Win32). Als dit argument niet is opgegeven of een lege tekenreeks (""), gebruikt het hulpprogramma de actieve configuratie van de oplossing.

  • /Project ProjName-

    Facultatief. Het pad en de naam van een projectbestand in de oplossing. U kunt een relatief pad invoeren vanuit de map SolutionName naar het projectbestand, of de weergavenaam van het project, of het volledige pad en de naam van het projectbestand.

  • /ProjectConfig ProjConfigName-

    Facultatief. De naam van een projectbuildconfiguratie (zoals Debug of Release) die moet worden gebruikt bij het bouwen van het benoemde project. Als er meer dan één oplossingsplatform beschikbaar is, moet u ook het platform opgeven (bijvoorbeeld Debug|Win32). Als deze switch is opgegeven, wordt het argument SolnConfigName overschreven.

  • /Out OutputFilename

    Facultatief. De naam van een bestand waarnaar u de uitvoer van het hulpprogramma wilt verzenden. Als het bestand al bestaat, voegt het hulpprogramma de uitvoer toe aan het einde van het bestand.

Opmerkingen

  • De /Build switch voert dezelfde functie uit als de build solution menuopdracht in de integrated development environment (IDE).

  • Plaats tekenreeksen tussen spaties tussen dubbele aanhalingstekens.

  • Samenvattingsinformatie voor builds, inclusief fouten, kan worden weergegeven in het opdrachtvenster of in een logboekbestand dat is opgegeven met de /Out-switch.

  • De /Build schakelt alleen projecten uit die sinds de laatste build zijn gewijzigd. Als u alle projecten in een oplossing wilt bouwen, gebruikt u in plaats daarvan /rebuild.

  • Als u een foutbericht krijgt met de tekst Ongeldige projectconfiguratie, controleert u of u een oplossingsplatform of projectplatform hebt opgegeven (bijvoorbeeld Debug|Win32).

Voorbeelden

Met de volgende opdracht wordt het project CSharpWinAppgebouwd met behulp van de Debug projectbuildconfiguratie binnen MySolution.

devenv "%USERPROFILE%\source\repos\MySolution.sln" /build Debug /project "CSharpWinApp\CSharpWinApp.csproj" /projectconfig Debug

En om alle buildbestanden op te schonen:

devenv "%USERPROFILE%\source\repos\MySolution.sln" /clean

Een installatieproject bouwen

Als u een installatieprogramma (.msi bestand) wilt maken, hebt u een installatieproject nodig, dat een .vdproj projectbestand heeft, maar om het te bouwen, moet u eerst een tijdelijke oplossing toepassen waarmee een bepaalde registersleutel wordt ingesteld. Voer vanaf de opdrachtprompt van Visual Studio Developer het uitvoerbare DisableOutOfProcBuild.exe uit vanuit de map Common7\IDE\CommonExtensions\Microsoft\VSI\DisableOutOfProcBuild. Zonder deze tijdelijke oplossing krijgt u mogelijk de volgende fout: ERROR: An error occurred while validating. HRESULT = '8000000A'. De opdracht is van invloed op de huidige gebruiker, dus voor buildagentscenario's moet u deze uitvoeren vanuit hetzelfde account waarop de build wordt uitgevoerd. Zie het README.txt-bestand in dezelfde map voor meer informatie.

In Visual Studio kunt u ook een nieuwe configuratie maken, bijvoorbeeld Setup, op basis van de Release-configuratie en het installatieproject selecteren als een project dat u wilt bouwen. Standaard zijn installatieprojecten niet opgenomen in de standaardconfiguraties, Debug en Release. Wanneer de Setup-configuratie is gedefinieerd, bouwen de volgende opdrachten een project WindowsFormsApp1 en het bijbehorende installatieproject om het .msi-bestand te genereren:

devenv WindowsFormsApp1.sln /build Setup

Als de oplossing al is gebouwd met de Release-configuratie, wordt met deze opdracht alleen het installatieproject gebouwd.

Zie ook