Add comments

Author: florelis

src/AppInstallerCLI.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 18
-VisualStudioVersion = 18.0.11205.157 d18.0
+VisualStudioVersion = 18.0.11205.157
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{C7167F0D-BC9F-4E6E-AFE1-012C56B48DB5}") = "AppInstallerCLIPackage", "AppInstallerCLIPackage\AppInstallerCLIPackage.wapproj", "{6AA3791A-0713-4548-A357-87A323E7AC3A}"
 	ProjectSection(ProjectDependencies) = postProject
@@ -37,7 +37,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Project", "Project", "{8D53
 		..\azure-pipelines.nuget.yml = ..\azure-pipelines.nuget.yml
 		..\azure-pipelines.yml = ..\azure-pipelines.yml
 		..\cgmanifest.json = ..\cgmanifest.json
-		Directory.Build.props = Directory.Build.props
 		Get-VcxprojNugetPackageVersions.ps1 = Get-VcxprojNugetPackageVersions.ps1
 		..\README.md = ..\README.md
 		..\doc\ReleaseNotes.md = ..\doc\ReleaseNotes.md
@@ -97,7 +96,9 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{1A5D7A7D-5CB2-47D5-B40D-4E61CAEDC798}"
 	ProjectSection(SolutionItems) = preProject
 		CodeAnalysis.ruleset = CodeAnalysis.ruleset
+		Directory.Build.props = Directory.Build.props
 		Directory.Packages.props = Directory.Packages.props
+		Directory.Solution.props = Directory.Solution.props
 		nuget.config = nuget.config
 		stylecop.json = stylecop.json
 		vcpkg.json = vcpkg.json

src/Directory.Solution.props

@@ -1,3 +1,4 @@
+<!-- This file is automatically included in the (autogenerated) project file for the solution. -->
 <Project>
-  <Import Project="$(MSBuildProjectDirectory)\vcpkg.props" />
+    <Import Project="$(MSBuildProjectDirectory)\vcpkg.props" />
 </Project>

src/vcpkg.props

@@ -49,23 +49,36 @@
     <VcpkgConfiguration>Release</VcpkgConfiguration>
   </PropertyGroup>
 
+  <!-- vcpkg can only install ports for one triplet at a time, so we need to ensure that every project using vcpkg uses the same triplet.
+       If there is a triplet mismatch, the ports for one of the triplets will be deleted when installing a second one.
+       In parallel builds, this can lead to projects that use the first triplet not being able to find the headers or binaries, and cause an error. -->
+
   <PropertyGroup>
-      <_TripletFile>$(VcpkgInstalledDir)\.selectedtriplet</_TripletFile>
+      <!-- The MSBuild process starts with the solution file, and each individual project is built recursively from there.
+           When building the .sln, we will write a file to indicate which triplet should be used in all projects.
+           Each project will later read this file to verify that it is using the same triplet. -->
       <_IsBuildingSln>$(MSBuildProjectName.EndsWith('.sln'))</_IsBuildingSln>
+      <_TripletFile>$(VcpkgInstalledDir)\.solutiontriplet</_TripletFile>
   </PropertyGroup>
 
-  <Target Name="WriteSolutionTripletToFile" BeforeTargets="Build" Condition="'$(_IsBuildingSln)' == 'true'">
+  <Target Name="WriteSolutionTripletToFile"
+          BeforeTargets="Build"
+          Condition="'$(_IsBuildingSln)' == 'true'">
     <WriteLinesToFile File="$(_TripletFile)" Lines="$(VcpkgTriplet)" Overwrite="true" />
   </Target>
 
-  <Target Name="EnsureNoTripletMismatch" BeforeTargets="PrepareForBuild" Condition="'$(_IsBuildingSln)' != 'true'">
+  <Target Name="EnsureNoTripletMismatch"
+          BeforeTargets="PrepareForBuild"
+          Condition="'$(_IsBuildingSln)' != 'true'" >
     <ReadLinesFromFile File="$(_TripletFile)">
       <Output TaskParameter="Lines" ItemName="_TripletFileLines" />
     </ReadLinesFromFile>
 
     <PropertyGroup>
       <_SolutionTriplet>@(_TripletFileLines)</_SolutionTriplet>
     </PropertyGroup>
-    <Error Condition=" '$(_SolutionTriplet)' != '$(VcpkgTriplet)' " Text="The vcpkg triplet $(VcpkgTriplet) selected for this project does not match the solution triplet $(_SolutionTriplet)" />
+
+    <Error Condition=" '$(_SolutionTriplet)' != '$(VcpkgTriplet)' "
+           Text="The vcpkg triplet $(VcpkgTriplet) selected for this project does not match the solution triplet $(_SolutionTriplet)" />
   </Target>
 </Project>