Use PackageReference for C++ dependencies

.ado/jobs/e2e-test.yml

@@ -79,6 +79,16 @@ jobs:
                 feature: UseHermes
                 value: ${{ matrix.UseHermes }}
 
+            # NuGet ignores packages.config if it detects <PackageReference>.
+            # Use restore packages.config directly to keep compabitility with ReactNativePicker.
+            - pwsh: |
+                Get-ChildItem -Recurse -Path packages.config |`
+                  Foreach-Object {`
+                    NuGet.exe Restore -PackagesDirectory windows\packages $_`
+                  }
+              workingDirectory: packages/e2e-test-app
+              displayName: Restore packages.config items
+
             - template: ../templates/run-windows-with-certificates.yml
               parameters:
                 buildEnvironment: ${{ parameters.BuildEnvironment }}

.ado/jobs/playground.yml

@@ -96,6 +96,16 @@ jobs:
                 parameters:
                   certificateName: playgroundEncodedKey
 
+            # NuGet ignores packages.config if it detects <PackageReference>.
+            # Use restore packages.config directly to keep compabitility with ReactNativePicker.
+            - pwsh: |
+                Get-ChildItem -Recurse -Path packages.config |`
+                  Foreach-Object {`
+                    NuGet.exe Restore -PackagesDirectory packages $_`
+                  }
+              workingDirectory: packages/playground/windows
+              displayName: Restore packages.config items
+
             - template: ../templates/msbuild-sln.yml
               parameters:
                 solutionDir: packages/playground/windows

.ado/jobs/universal.yml

@@ -46,7 +46,12 @@
       - ${{ if eq(config.BuildEnvironment, parameters.buildEnvironment) }}:
         - ${{ each matrix in config.Matrix }}:
             - job: UniversalBuild${{ matrix.BuildPlatform }}${{ matrix.BuildConfiguration }}
-              variables: [template: ../variables/windows.yml]
+              variables:
+                - template: ../variables/windows.yml
+                # Some tasks run on a different user (VssAdministrator) instead of the default user (AzDevOps).
+                # Keep NuGet cache independent from the user directory.
+                - name: NUGET_PACKAGES
+                  value: $(Agent.TempDirectory)/NuGetPackages
               displayName: Universal Build ${{ matrix.Name }}
               pool: ${{ parameters.AgentPool.Large }}
               timeoutInMinutes: 60
@@ -71,7 +76,7 @@
                     solutionName: Microsoft.ReactNative.sln
                     buildPlatform: ${{ matrix.BuildPlatform }}
                     buildConfiguration: ${{ matrix.BuildConfiguration }}
-                
+
                 - ${{ if eq(config.BuildEnvironment, 'Continuous') }}:
                   - template: ../templates/component-governance.yml
 
@@ -111,7 +116,12 @@
                       Mso.UnitTests\**
 
             - job: UniversalTest${{ matrix.Name }}
-              variables: [template: ../variables/windows.yml]
+              variables:
+                - template: ../variables/windows.yml
+                # Some tasks run on a different user (VssAdministrator) instead of the default user (AzDevOps).
+                # Keep NuGet cache independent from the user directory.
+                - name: NUGET_PACKAGES
+                  value: $(Agent.TempDirectory)/NuGetPackages
               displayName: Universal Test ${{ matrix.Name }}
               dependsOn:
                 - UniversalBuild${{ matrix.BuildPlatform }}${{ matrix.BuildConfiguration }}

.ado/templates/msbuild-sln.yml

@@ -45,11 +45,13 @@ steps:
       createLogFile: true
       logFileVerbosity: detailed
       msbuildArgs:
+        /restore
         /p:PreferredToolArchitecture=${{parameters.preferredToolArchitecture}}
         /p:PlatformToolset=${{parameters.platformToolset}}
         /p:PublishToolDuringBuild=true
         /p:EnableSourceLink=true
         /p:RestoreLockedMode=true
+        /p:RestoreForceEvaluate=true
         /bl:$(BuildLogDirectory)\MsBuild.binlog
         /flp1:errorsonly;logfile=$(BuildLogDirectory)\MsBuild.err
         /flp2:warningsonly;logfile=$(BuildLogDirectory)\MsBuild.wrn

.ado/templates/run-windows-with-certificates.yml

@@ -24,6 +24,9 @@ parameters:
   - name: restoreLockedMode
     type: boolean
     default: true
+  - name: restoreForceEvaluate
+    type: boolean
+    default: true
 
 steps:
   - ${{ if eq(parameters.buildConfiguration, 'Debug') }}:
@@ -33,7 +36,7 @@ steps:
         --no-launch
         --logging
         --buildLogDirectory ${{ parameters.buildLogDirectory }}
-        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }}
+        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }},RestoreForceEvaluate=${{ parameters.restoreForceEvaluate }}
         ${{ parameters.deployOption }}
       displayName: run-windows (Debug)
       workingDirectory: ${{ parameters.workingDirectory }}
@@ -46,7 +49,7 @@ steps:
         --no-launch
         --logging
         --buildLogDirectory ${{ parameters.buildLogDirectory }}
-        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }}
+        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }},RestoreForceEvaluate=${{ parameters.restoreForceEvaluate }}
         ${{ parameters.deployOption }}
       displayName: run-windows (Release) - PR
       workingDirectory: ${{ parameters.workingDirectory }}
@@ -63,7 +66,7 @@ steps:
         --no-launch
         --logging
         --buildLogDirectory ${{ parameters.buildLogDirectory }}
-        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }},PackageCertificateKeyFile=$(Build.SourcesDirectory)\EncodedKey.pfx
+        --msbuildprops RestoreLockedMode=${{ parameters.restoreLockedMode }},RestoreForceEvaluate=${{ parameters.restoreForceEvaluate }},PackageCertificateKeyFile=$(Build.SourcesDirectory)\EncodedKey.pfx
         ${{ parameters.deployOption }}
       displayName: run-windows (Release) - CI
       workingDirectory: ${{ parameters.workingDirectory }}

.editorconfig

@@ -22,9 +22,10 @@ indent_size = 4
 end_of_line = crlf
 
 # Xml project files
-[*.{csproj}]
+[*.{config,csproj,njsproj,props,targets,vcxitems,vcxproj,vcxproj.filters}]
 indent_size = 2
 end_of_line = crlf
+insert_final_newline = false
 
 # Xml files
 [*.{xml,stylecop,resx,ruleset}]

Directory.Build.props

@@ -10,6 +10,43 @@
   -->
   <PropertyGroup>
     <ReactNativeWindowsDir>$(MSBuildThisFileDirectory)vnext\</ReactNativeWindowsDir>
+
+    <Platform Condition="'$(Platform)' == ''">x64</Platform>
+    <Configuration Condition="'$(Configuration)' == ''">Debug</Configuration>
+
+    <RootIntDir>$(ReactNativeWindowsDir)build</RootIntDir>
+    <RootOutDir>$(ReactNativeWindowsDir)target</RootOutDir>
+    <!-- Visual Studio forces using 'Win32' for the 'x86' platform. -->
+    <BaseIntDir Condition="'$(Platform)' == 'Win32'">$(RootIntDir)\x86\$(Configuration)</BaseIntDir>
+    <BaseIntDir Condition="'$(Platform)' != 'Win32'">$(RootIntDir)\$(Platform)\$(Configuration)</BaseIntDir>
+    <BaseOutDir Condition="'$(Platform)' == 'Win32'">$(RootOutDir)\x86\$(Configuration)</BaseOutDir>
+    <BaseOutDir Condition="'$(Platform)' != 'Win32'">$(RootOutDir)\$(Platform)\$(Configuration)</BaseOutDir>
   </PropertyGroup>
 
-</Project>
+  <PropertyGroup Label="NuGet">
+    <MSBuildProjectExtensionsPath Condition="'$(ProjectName)' != ''">$(RootIntDir)\ProjectExtensions\$(ProjectName)\</MSBuildProjectExtensionsPath>
+    <MSBuildProjectExtensionsPath Condition="'$(ProjectName)' == ''">$(RootIntDir)\ProjectExtensions\$(MSBuildProjectName)\</MSBuildProjectExtensionsPath>
+  </PropertyGroup>
+
+  <PropertyGroup Label="NuGet" Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+
+    <!-- https://github.com/NuGet/Home/issues/10511#issuecomment-778400668 -->
+    <AssetTargetFallback>$(AssetTargetFallback);native</AssetTargetFallback>
+
+    <!--
+      Avoid Visual Studio error message:
+      "The project '$(MSBuildProjectName)' ran into a problem during the last operation: The value of the
+      'TargetFrameworkMoniker' and 'NuGetTargetMoniker' properties in the '$(Configuration)|$(Platform)' configuration are both
+      empty. This configuration will not contribute to NuGet restore, which may result in restore and build errors. You may
+      need to reload the solution after fixing the problem."
+    -->
+    <TargetFrameworkMoniker>native,Version=v0.0</TargetFrameworkMoniker>
+    <!-- TODO: Keep? -->
+    <!-- <RuntimeIdentifiers Condition="'$(RuntimeIdentifiers)' == ''">win;win-x64;win-x86;win-arm64</RuntimeIdentifiers> -->
+  </PropertyGroup>
+
+  <ItemGroup Label="NuGet" Condition="'$(MSBuildProjectExtension)' == '.vcxproj'">
+    <ProjectCapability Include="PackageReferences" />
+  </ItemGroup>
+
+</Project>

Directory.Build.targets

@@ -12,8 +12,8 @@
     </ItemGroup>
   </Target>
 
-  <!-- 
-    This target checks if Yarn install needs to run or not. 
+  <!--
+    This target checks if Yarn install needs to run or not.
     This is a common cause of failed builds for developers not used to running it after syncing...
     This check does not run during design time build and in our CI validation runs (detected via AGENT_NAME).
   -->
@@ -27,7 +27,7 @@
     >
 
     <Message Text="Checking if yarn is 'up to date' by running a 'dry-run' version of `yarn install` and checking the exit code" />
-    <Exec 
+    <Exec
       ContinueOnError="True"
       Command="yarn install --offline --cache-folder $(IntDir)\JsUpToDateCheck\Cache"
       WorkingDirectory="$(MSBuildThisFileDirectory)"
@@ -36,13 +36,13 @@
     </Exec>
 
     <!-- Fail the build if yarn needs to install packages. -->
-    <Error 
+    <Error
       Condition="'%(_YarnExitCode.Identity)' != '0'"
-      Text="Yarn packages are out of date. Please run `yarn install &amp;&amp; yarn build` in the root of the repo to ensure the generated files are up to date" 
+      Text="Yarn packages are out of date. Please run `yarn install &amp;&amp; yarn build` in the root of the repo to ensure the generated files are up to date"
     />
 
-    <!-- 
-      Copy the yarn.lock file to prevent this task from running over and over again, and only rerun the check with yarn.lock or any package.json changes. 
+    <!--
+      Copy the yarn.lock file to prevent this task from running over and over again, and only rerun the check with yarn.lock or any package.json changes.
       This will likely miss a few corner cases with local changes to package.json but should catch the most important case after syncing
     -->
     <Copy
@@ -57,5 +57,101 @@
 
   </Target>
 
+  <!-- For build debugging purposes. -->
+  <Target Name="Vars">
+    <Message Text="General" />
+    <Message Text="=> ApplicationType         [$(ApplicationType)]" />
+    <Message Text="=> Configuration           [$(Configuration)]" />
+    <Message Text="=> Platform                [$(Platform)]" />
+    <Message Text="=> PlatformTarget          [$(PlatformTarget)]" />
+    <Message Text="=> PlatformName            [$(PlatformName)]" />
+    <Message Text="=> DefaultPlatformToolset  [$(DefaultPlatformToolset)]" />
+    <Message Text="=> PlatformToolset         [$(PlatformToolset)]" />
+    <Message Text="=> SolutionDir             [$(SolutionDir)]" />
+    <Message Text="=> RootDir                 [$(RootDir)]" />
+    <Message Text="=> RootIntDir              [$(RootIntDir)]" />
+    <Message Text="=> RootOutDir              [$(RootOutDir)]" />
+    <Message Text="=> BaseIntDir              [$(BaseIntDir)]" />
+    <Message Text="=> BaseOutDir              [$(BaseOutDir)]" />
+    <Message Text="=> IntDir                  [$(IntDir)]" />
+    <Message Text="=> OutDir                  [$(OutDir)]" />
+    <Message Text="=> TargetDir               [$(TargetDir)]" />
+    <Message Text="=> TargetPath              [$(TargetPath)]" />
+    <Message Text="=> TLogLocation            [$(TLogLocation)]" />
+    <Message Text="=> LastBuildUnsuccessful   [$(LastBuildUnsuccessful)]" />
+    <Message Text="=> LastBuildState          [$(LastBuildState)]" />
+    <Message Text="=> GeneratedFilesDir       [$(GeneratedFilesDir)]" />
+    <Message Text="=> WinVer                  [$(WinVer)]" />
+    <Message Text="=> TargetFrameworkMoniker  [$(TargetFrameworkMoniker)]" />
+
+    <Message Text="%0A" />
+    <Message Text="Microsoft.CppBuild.targets/MakeDirsForCl" />
+    <Message Text="=> PrecompiledHeaderOutputFile [@(CLCompile->Metadata('PrecompiledHeaderOutputFile')->DirectoryName()->Distinct())]" />
+    <Message Text="=> AssemblerListingLocation    [@(CLCompile->Metadata('AssemblerListingLocation')->DirectoryName()->Distinct())]" />
+    <Message Text="=> ObjectFileName              [@(CLCompile->Metadata('ObjectFileName')->DirectoryName()->Distinct())]" />
+    <Message Text="=> ProgramDataBaseFileName     [@(CLCompile->Metadata('ProgramDataBaseFileName')->DirectoryName()->Distinct())]" />
+    <Message Text="=> XMLDocumentationFileName    [@(CLCompile->Metadata('XMLDocumentationFileName')->DirectoryName()->Distinct())]" />
+    <Message Text="=> BrowseInformationFile       [@(CLCompile->Metadata('BrowseInformationFile')->DirectoryName()->Distinct())]" />
+    <Message Text="=> PreprocessOutputPath        [@(CLCompile->Metadata('PreprocessOutputPath')->DirectoryName()->Distinct())]" />
+    <Message Text="=> PreprocessorDefinitions     [@(CLCompile->Metadata('PreprocessorDefinitions')->Distinct())]" />
+    <Message Text="=> ClDirsToMake                [@(ClDirsToMake)]" />
+
+    <Message Text="%0A" />
+    <Message Text="=> UnmergedWinmdDirectory  [$(UnmergedWinmdDirectory)]" />
+    <Message Text="=> MergedWinmdDirectory    [$(MergedWinmdDirectory)]" />
+    <Message Text="=> FollyDir                [$(FollyDir)]" />
+    <Message Text="=> ReactNativeWindowsDir   [$(ReactNativeWindowsDir)]" />
+    <Message Text="=> ReactNativeDir          [$(ReactNativeDir)]" />
+    <Message Text="=> YogaDir                 [$(YogaDir)]" />
+    <Message Text="=> ProjectHome             [$(ProjectHome)]" />
+    <Message Text="=> UserRootDir             [$(UserRootDir)]" />
+    <Message Text="=> MSBuildExtensionsPath   [$(MSBuildExtensionsPath)]" />
+    <Message Text="=> MSBuildExtensionsPath32 [$(MSBuildExtensionsPath32)]" />
+    <Message Text="=> MSBuildExtensionsPath64 [$(MSBuildExtensionsPath64)]" />
+    <Message Text="=> VCTargetsPath           [$(VCTargetsPath)]" />
+
+    <Message Text="%0A" />
+    <Message Text="JS Engine" />
+    <Message Text="=> PkgReactNative_Hermes_Windows        [$(PkgReactNative_Hermes_Windows)]" />
+    <Message Text="=> EnableHermesInspectorInReleaseFlavor [$(EnableHermesInspectorInReleaseFlavor)]" />
+    <Message Text="=> UseHermes     [$(UseHermes)]" />
+    <Message Text="=> UseFabric     [$(UseFabric)]" />
+    <Message Text="=> HermesVersion [$(HermesVersion)]" />
+    <Message Text="=> HermesPackage [$(HermesPackage)]" />
+    <Message Text="=> HermesArch    [$(HermesArch)]" />
+    <Message Text="=> UseFabric     [$(UseFabric)]" />
+    <Message Text="=> UseV8         [$(UseV8)]" />
+    <Message Text="=> V8Package     [$(V8Package)]" />
+    <Message Text="=> V8Version     [$(V8Version)]" />
+    <Message Text="=> V8AppPlatform [$(V8AppPlatform)]" />
+
+    <Message Text="%0A" />
+    <Message Text="NuGet" />
+    <Message Text="=> AssetTargetFallback                 [$(AssetTargetFallback)]" />
+    <Message Text="=> IncludeFrameworkReferencesFromNuGet [$(IncludeFrameworkReferencesFromNuGet)]" />
+    <Message Text="=> NuGetPackageRoot                    [$(NuGetPackageRoot)]" />
+    <Message Text="=> NuGetPackagesDirectory              [$(NuGetPackagesDirectory)]" />
+    <Message Text="=> NuGetRuntimeIdentifier              [$(NuGetRuntimeIdentifier)]" />
+    <Message Text="=> ProjectLockFile                     [$(ProjectLockFile)]" />
+    <Message Text="=> IntermediateOutputPath              [$(IntermediateOutputPath)]" />
+    <Message Text="=> NuGetTargetMoniker                  [$(NuGetTargetMoniker)]" />
+    <Message Text="=> TargetFramework                     [$(TargetFramework)]" />
+    <Message Text="=> TargetFrameworks                    [$(TargetFrameworks)]" />
+    <Message Text="=> TargetFrameworkIdentifier           [$(TargetFrameworkIdentifier)]" />
+    <Message Text="=> BaseNuGetRuntimeIdentifier          [$(BaseNuGetRuntimeIdentifier)]" />
+    <Message Text="=> NuGetRuntimeIdentifier              [$(NuGetRuntimeIdentifier)]" />
+    <Message Text="=> TargetPlatformIdentifier            [$(TargetPlatformIdentifier)]" />
+    <Message Text="=> MSBuildProjectExtensionsPath        [$(MSBuildProjectExtensionsPath)]" />
+
+    <Message Text="%0A" />
+    <Message Text="WinUI" />
+    <Message Text="=> UseWinUI3           [$(UseWinUI3)]" />
+    <Message Text="=> WinUI3Version       [$(WinUI3Version)]" />
+    <Message Text="=> WinUI2xVersion      [$(WinUI2xVersion)]" />
+    <Message Text="=> WinUIPackageName    [$(WinUIPackageName)]" />
+    <Message Text="=> WinUIPackageVersion [$(WinUIPackageVersion)]" />
+    <Message Text="=> IsWinUIAlpha        [$(IsWinUIAlpha)]" />
+
+  </Target>
 
 </Project>

change/@react-native-windows-automation-channel-e55358d7-47ab-4fdd-b9bc-1a5bf5af7172.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Use PackageReference in C++ projects",
+  "packageName": "@react-native-windows/automation-channel",
+  "email": "julio.rocha@microsoft.com",
+  "dependentChangeType": "patch"
+}

change/@react-native-windows-cli-f600b0b4-710d-4c11-b639-f94578bf55a6.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Use PackageReference for C++ dependencies",
+  "packageName": "@react-native-windows/cli",
+  "email": "julio.rocha@microsoft.com",
+  "dependentChangeType": "none"
+}

change/node-rnw-rpc-6fae19ab-7d3e-488e-83c6-cb979474aebb.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Use PackageReference for C++ dependencies",
+  "packageName": "node-rnw-rpc",
+  "email": "julio.rocha@microsoft.com",
+  "dependentChangeType": "patch"
+}

change/react-native-windows-c9ee2e0d-b03e-4c92-8335-36e12d4e2465.json

@@ -0,0 +1,7 @@
+{
+  "type": "prerelease",
+  "comment": "Use PackageReference for NuGet Dependencies",
+  "packageName": "react-native-windows",
+  "email": "julio.rocha@microsoft.com",
+  "dependentChangeType": "none"
+}

packages/@react-native-windows/automation-channel/windows/AutomationChannel/AutomationChannel.filters

@@ -12,7 +12,6 @@
   </ItemGroup>
   <ItemGroup>
     <None Include="PropertySheet.props" />
-    <None Include="packages.config" />
     <None Include="AutomationChannel.def" />
   </ItemGroup>
   <ItemGroup>