第一个WinUI程序

大家好，欢迎来到IT知识分享网。

概述

WinUI 是Windows上最新的UI开发框架，属于 Windows App SDK 的一部分。

对于开发者需要知道的是：

• 开发工具为 Visual Studio 2019 或 Visual Studio 2022。
• 支持使用 C++ 或 C# 开发。
• Windows App SDK 要求系统版本在 Windows 10 1809 或以上，也就是2018年11月之后的Win10、Win11系统。
• 支持生成传统的 exe 文件和新的 MSIX 文件。什么是MSIX？
• 程序依赖 Windows App Runtime 运行时，当然也可以选择在打包时将相应的文件一并打包。

安装开发环境

1. 安装 VS 组件
   对于C++开发者，安装VS时需要勾选Windows 应用 SDK C++ 模板，这样才能在VS中创建WinUI项目
   

对于C#开发者，安装VS时需要勾选Windows 应用 SDK C# 模板，这样才能在VS中创建WinUI项目

2. 安装 Visual Studio 扩展 https://learn.microsoft.com/zh-cn/windows/apps/windows-app-sdk/downloads

第一个项目

打开VS，选择 WinUI 项目，可以看到有两个工程模板

第三个模板中强调的是”使用 Windows 应用程序打包项目打包”，这个模板会产生两个项目，其中一个只是用来打包用。

这是一个过时的模板，我们不需要它。所以选择第一个工程模板即可。

建立项目后直接按F5键启动调试，程序就可以跑起来了。此时可以发现运行的文件位置在
bin\x64\Debug\net6.0-windows10.0.19041.0\win10-x64\AppX\目录，但是当我尝试去双击运行时，程序没有如期的显示，因为项目默认是一个所谓的打包应用，不能像传统的exe那样直接运行。
要创建一个未打包应用（就是传统的exe），那么需要手动编辑工程文件（.csproj或.vcxproj），在<PropertyGroup>下添加

<WindowsPackageType>None</WindowsPackageType>

然后删除项目目录下的package.appxmanifest文件即可。
这样我们就回归到了传统的开发方式，文件会生成在bin\x64\Debug\net6.0-windows10.0.19041.0\win10-x64这样的目录下。

但是发现其中携带了VC运行库和.Net运行时文件，为了移除.Net运行时文件，手动编辑文件Properties\PublishProfiles下对应的.pubxml文件，比如：

<?xml version="1.0" encoding="utf-8"?>
<!--
https://go.microsoft.com/fwlink/?LinkID=208121.
-->
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <PublishProtocol>FileSystem</PublishProtocol>
    <Platform>x64</Platform>
    <RuntimeIdentifier>win10-x64</RuntimeIdentifier>
    <PublishDir>bin\$(Configuration)\$(TargetFramework)\$(RuntimeIdentifier)\publish\</PublishDir>
	<!-- 包含 .NET 运行时 -->
    <SelfContained>false</SelfContained>
    <PublishSingleFile>False</PublishSingleFile>
    <PublishReadyToRun Condition="'$(Configuration)' == 'Debug'">False</PublishReadyToRun>
    <PublishReadyToRun Condition="'$(Configuration)' != 'Debug'">True</PublishReadyToRun>
   <!-- 
    See https://github.com/microsoft/CsWinRT/issues/373
    <PublishTrimmed>True</PublishTrimmed>
    -->
  </PropertyGroup>
</Project>

将其中的<SelfContained>标签改为false即可，最后发布的文件就很少了

这样发布的客户端优点是文件少，但要求目标计算机上安装了 .Net 和 Windows App 运行库。

相关阅读

创建第一个 WinUI 3（Windows 应用 SDK）项目
打包应用的优点和缺点
Packaged, Unpackaged and Self-Contained WinUI 3 Apps with the Windows App Sdk
WinUI 3 踩坑记：从创建项目到发布