Add bootstrap initialization and update package dependencies for framework-dependent deployment

Author: nieubank

Samples/WindowsML/cpp/CppConsoleDesktop.FrameworkDependent/CppConsoleDesktop.FrameworkDependent.vcxproj

@@ -1,9 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <!-- Framework-dependent deployment requires bootstrap initialization -->
+  <PropertyGroup>
+    <WindowsAppSDKSelfContained>false</WindowsAppSDKSelfContained>
+    <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize>
+  </PropertyGroup>
   <Import Project="packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.props" Condition="Exists('packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.props')" />
   <Import Project="packages\Microsoft.WindowsAppSDK.Base.1.8.250509001-experimental\build\native\Microsoft.WindowsAppSDK.Base.props" Condition="Exists('packages\Microsoft.WindowsAppSDK.Base.1.8.250509001-experimental\build\native\Microsoft.WindowsAppSDK.Base.props')" />
   <Import Project="packages\Microsoft.Windows.SDK.BuildTools.MSIX.1.7.20250508.1\build\Microsoft.Windows.SDK.BuildTools.MSIX.props" Condition="Exists('packages\Microsoft.Windows.SDK.BuildTools.MSIX.1.7.20250508.1\build\Microsoft.Windows.SDK.BuildTools.MSIX.props')" />
   <Import Project="packages\Microsoft.Windows.SDK.BuildTools.10.0.22621.3233\build\Microsoft.Windows.SDK.BuildTools.props" Condition="Exists('packages\Microsoft.Windows.SDK.BuildTools.10.0.22621.3233\build\Microsoft.Windows.SDK.BuildTools.props')" />
+  <Import Project="packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.props" Condition="Exists('packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.props')" />
+  <Import Project="packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.props" Condition="Exists('packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.props')" />
   <Import Project="packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.props" Condition="Exists('packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.props')" />
   <Import Project="packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.props" Condition="Exists('packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.props')" />
   <ItemGroup Label="ProjectConfigurations">
@@ -20,8 +27,6 @@
     <WindowsTargetPlatformVersion>10.0</WindowsTargetPlatformVersion>
     <WindowsPackageType>None</WindowsPackageType>
     <DefaultLanguage>en-US</DefaultLanguage>
-    <!-- Framework-dependent deployment (default) -->
-    <WindowsAppSDKSelfContained>false</WindowsAppSDKSelfContained>
   </PropertyGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
   <PropertyGroup Label="Configuration">
@@ -54,6 +59,8 @@
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <ImportGroup Label="ExtensionTargets">
     <Import Project="packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.targets" Condition="Exists('packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.targets')" />
+    <Import Project="packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.targets" Condition="Exists('packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.targets')" />
+    <Import Project="packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.targets" Condition="Exists('packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.targets')" />
     <Import Project="packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.targets" Condition="Exists('packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.targets')" />
     <Import Project="packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.targets" Condition="Exists('packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.targets')" />
     <Import Project="packages\Microsoft.Windows.SDK.BuildTools.10.0.22621.3233\build\Microsoft.Windows.SDK.BuildTools.targets" Condition="Exists('packages\Microsoft.Windows.SDK.BuildTools.10.0.22621.3233\build\Microsoft.Windows.SDK.BuildTools.targets')" />
@@ -66,6 +73,10 @@
     </PropertyGroup>
     <Error Condition="!Exists('packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.props')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.props'))" />
     <Error Condition="!Exists('packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.targets')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.Windows.CppWinRT.2.0.240405.15\build\native\Microsoft.Windows.CppWinRT.targets'))" />
+    <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.props')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.props'))" />
+    <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.targets')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.Foundation.1.8.250701000-experimental\build\native\Microsoft.WindowsAppSDK.Foundation.targets'))" />
+    <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.props')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.props'))" />
+    <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.targets')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.InteractiveExperiences.1.8.250626001-experimental\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.targets'))" />
     <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.props')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.props'))" />
     <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.targets')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.ML.1.8.1054-experimental\build\native\Microsoft.WindowsAppSDK.ML.targets'))" />
     <Error Condition="!Exists('packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.props')" Text="$([System.String]::Format('$(ErrorText)', 'packages\Microsoft.WindowsAppSDK.Runtime.1.8.250805005-experimental\build\native\Microsoft.WindowsAppSDK.Runtime.props'))" />

Samples/WindowsML/cpp/CppConsoleDesktop.FrameworkDependent/README.md

@@ -33,11 +33,77 @@ msbuild CppConsoleDesktop.FrameworkDependent.vcxproj /p:Platform=x64 /p:Configur
 - WindowsAppSDK ML package (core machine learning functionality)
 - WindowsAppSDK Runtime package (framework runtime components)
 - WindowsAppSDK Base package (required for proper binary deployment)
+- WindowsAppSDK Foundation package (required for Windows App SDK bootstrap functionality)
+- WindowsAppSDK InteractiveExperiences package (required dependency for Foundation - provides UI metadata including Microsoft.UI.WindowId)
 - CppWinRT package (Windows Runtime projections)
 - Windows SDK Build Tools packages (build-time dependencies)
 
 See `packages.config` for current package versions.
 
+## Windows App SDK Bootstrap Configuration
+
+Framework-dependent applications require bootstrap initialization to properly discover and initialize the Windows App SDK runtime at startup. This project is configured to automatically include the necessary bootstrap code.
+
+### How It Works
+
+1. **Foundation Package**: The `Microsoft.WindowsAppSDK.Foundation` package provides bootstrap functionality for framework-dependent deployments.
+
+2. **InteractiveExperiences Dependency**: Foundation package depends on `Microsoft.WindowsAppSDK.InteractiveExperiences` which provides essential UI metadata (like `Microsoft.UI.WindowId`) required by CppWinRT projections.
+
+3. **Bootstrap Property**: The project sets `<WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize>` **before** importing any Windows App SDK packages.
+
+4. **Auto-Generated Code**: When the property is set correctly, the Foundation package automatically includes `MddBootstrapAutoInitializer.cpp` in the build, which handles runtime discovery and initialization.
+
+### Key Configuration Requirements
+
+- The `WindowsAppSdkBootstrapInitialize` property must be defined **before** importing Windows App SDK packages
+- The Foundation package `.props` and `.targets` files must be imported in the correct order
+- The InteractiveExperiences package is required as a dependency of Foundation
+- Framework-dependent projects (`WindowsAppSDKSelfContained=false`) require this bootstrap mechanism
+
+### Manual Configuration Steps
+
+If setting up a new framework-dependent project:
+
+1. Add the required packages to `packages.config`:
+   ```xml
+   <package id="Microsoft.WindowsAppSDK.Foundation" version="1.8.250701000-experimental" targetFramework="native" />
+   <package id="Microsoft.WindowsAppSDK.InteractiveExperiences" version="1.8.250626001-experimental" targetFramework="native" />
+   <package id="Microsoft.WindowsAppSDK.Runtime" version="1.8.250805005-experimental" targetFramework="native" />
+   <package id="Microsoft.WindowsAppSDK.Base" version="1.8.250509001-experimental" targetFramework="native" />
+   ```
+
+2. Set the bootstrap property at the top of your `.vcxproj` file (before any imports):
+   ```xml
+   <PropertyGroup>
+     <WindowsAppSdkBootstrapInitialize>true</WindowsAppSdkBootstrapInitialize>
+   </PropertyGroup>
+   ```
+
+3. Import Foundation and InteractiveExperiences package build files:
+   ```xml
+   <!-- In props section -->
+   <Import Project="packages\Microsoft.WindowsAppSDK.Foundation.[version]\build\native\Microsoft.WindowsAppSDK.Foundation.props" />
+   <Import Project="packages\Microsoft.WindowsAppSDK.InteractiveExperiences.[version]\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.props" />
+   
+   <!-- In targets section -->
+   <Import Project="packages\Microsoft.WindowsAppSDK.Foundation.[version]\build\native\Microsoft.WindowsAppSDK.Foundation.targets" />
+   <Import Project="packages\Microsoft.WindowsAppSDK.InteractiveExperiences.[version]\build\native\Microsoft.WindowsAppSDK.InteractiveExperiences.targets" />
+   ```
+
+### Common Issues and Solutions
+
+- **CppWinRT Error: "Microsoft.UI.WindowId could not be found"**
+  - **Solution**: Ensure the InteractiveExperiences package is included. Foundation depends on UI metadata provided by this package.
+  
+- **Bootstrap initialization not working**
+  - **Solution**: Verify the `WindowsAppSdkBootstrapInitialize` property is set to `true` **before** any package imports in the vcxproj file.
+
+- **Duplicate file warnings during build**
+  - **Note**: Multiple packages may include the same auto-initializer files. The linker will automatically ignore duplicates - these warnings are informational only.
+
+This configuration ensures the Windows App SDK runtime is properly initialized when your application starts, even when the runtime is not packaged with your application.
+
 ## Deployment Requirements
 
 The target machine must have the Windows App SDK Runtime installed. This is the recommended deployment model for most applications as it allows for shared runtime components and easier servicing.

Samples/WindowsML/cpp/CppConsoleDesktop.FrameworkDependent/packages.config

@@ -4,6 +4,8 @@
   <package id="Microsoft.Windows.SDK.BuildTools" version="10.0.22621.3233" targetFramework="native" />
   <package id="Microsoft.Windows.SDK.BuildTools.MSIX" version="1.7.20250508.1" targetFramework="native" developmentDependency="true" />
   <package id="Microsoft.WindowsAppSDK.Base" version="1.8.250509001-experimental" targetFramework="native" />
+  <package id="Microsoft.WindowsAppSDK.Foundation" version="1.8.250701000-experimental" targetFramework="native" />
+  <package id="Microsoft.WindowsAppSDK.InteractiveExperiences" version="1.8.250626001-experimental" targetFramework="native" />
   <package id="Microsoft.WindowsAppSDK.ML" version="1.8.1054-experimental" targetFramework="native" />
   <package id="Microsoft.WindowsAppSDK.Runtime" version="1.8.250805005-experimental" targetFramework="native" />
 </packages>