windows-experiment

Personal WindowsAppSDK, WinUI 3 experiments

• https://github.com/microsoft/WindowsAppSDK
• https://github.com/microsoft/microsoft-ui-xaml

Check current concerns and upcoming work items.

• https://github.com/luncliff/windows-experiment/issues
  The issues and milestones are note organized now. They be overhauled for GitHub Actions workflows soon.

How To

Setup

• https://github.com/microsoft/vcpkg

vcpkg integrate install

We have to restore packages in packages.config. The NuGet artifacts will be located in packages folder.

# nuget restore windows-experiment.sln
nuget restore packages.config -SolutionDirectory .

Build

Build the solution file

• Shared1 implements some Models and ViewModels
• App1 implements the application
• App1Package is a Windows Application Packaging project for this repository

# Full build of the projects
MSBuild windows-experiment.sln /p:platform="x64" /p:configuration="Debug" /p:VcpkgEnableManifest=true /Verbosity:Detailed

🚧 Test

Need a vstest.console.exe CLI command to run tests on WinUI 3 project. Our test project is UnitTestApp1.

• Test apps built with the Windows App SDK and WinUI
  • Unit tests for Windows UI Library (WinUI) apps in Visual Studio
• Microsoft.VisualStudio.TestTools.CppUnitTestFramework API reference
• VSTest.Console.exe command-line options for UWP example

# Full build of the projects
MSBuild windows-experiment.sln /t:UnitTestApp1 /p:platform="x64" /p:configuration="Debug" /p:VcpkgEnableManifest=true /Verbosity:Minimal

# After full build, Run tests with /framework option and appxrecipe file
Push-Location x64/Debug/UnitTestApp1
    vstest.console.exe /framework:frameworkuap10 UnitTestApp1.build.appxrecipe
Pop-Location

🚧 Deploy

The project creates MSIX bundle using the Visual Studio UI(publish).

• https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/single-project-msix

The following command will be tested with codesigning later. The snippet just show that we will use App1Package project. Not a correct command to create MSIX bundle.

# MSBuild windows-experiment.sln /t:App1Package /p:platform="x64" /p:configuration="Debug" /Verbosity:Minimal

References

• https://github.com/PacktPublishing/Modernizing-Your-Windows-Applications-with-the-Windows-Apps-SDK-and-WinUI
• https://github.com/microsoft/WindowsAppSDK-Samples
• Create your first WinUI 3 (Windows App SDK) project

Additional (Design & Implementation)

WinUI 3, C++/WinRT

• Microsoft.UI.Xaml.Controls Namespace
• https://github.com/Lewis-Marshall/WinUI3NavigationExample

Sadly, we can't use CommunityToolkit.

Could not install package 'CommunityToolkit.WinUI.Controls.Primitives 8.2.250402'. You are trying to install this package into a project that targets 'native,Version=v0.0', but the package does not contain any assembly references or content files that are compatible with that framework.

• Windows Community Toolkit Documentation
• https://github.com/CommunityToolkit/Windows

Diagnostics & Logging

• LoggingChannel: https://learn.microsoft.com/en-us/uwp/api/windows.foundation.diagnostics.loggingchannel
• LoggingSession: https://learn.microsoft.com/en-us/uwp/api/windows.foundation.diagnostics.loggingsession

DirectX & DXGI Interop

• DirectX 12 Programming Guide
• SwapChainPanel Interop (ISwapChainPanelNative in Microsoft.UI.Xaml namespace)
• https://github.com/microsoft/DirectX-Graphics-Samples

Future Works

The followings are for research for future use.

• https://github.com/microsoft/testfx
• https://devblogs.microsoft.com/dotnet/introducing-mstest-34/ (It's for dotnet. Not C++/WinRT)