【UAP】利用 .NET Core App 编写 UAP

众所周知，2024年9月微软正式公布了 .NET Core App 的 UWP 支持，至此我们终于可以在新版 csproj 用 .NET 8 及以上编写 UWP 了，那么我们可不可以通过修改清单的方式来让 UWP 变成 UAP 呢？

UWP 和 UAP 利用的是同一套 WinRT API ，Windows 区分 UAP 和 UWP 的方式是看清单，只要是用 UAP 的清单就会仿真成 Win8.1 模式，于是我们只需要将清单变成 UAP 的样子就行了。所以首先我们新建一个 .NET 9 Native AOT 的 UWP 项目

然后我们修改清单，Win8 App 清单如下，内容按需填写，Win8.1 App 的清单可以通过在 Github 搜刮OSMaxVersionTested language:XML找到，6.2是 Win8，6.3是 Win8.1 ($targetentrypoint$需配合 ApplicationEntryPoint利用)

1. <?xml version="1.0" encoding="utf-8"?>
3. <Package xmlns="http://schemas.microsoft.com/appx/2010/manifest">
5.   <Identity
6.     Name="wherewhere.CoreAppUAP"
7.     Publisher="CN=where"
8.     Version="0.0.1.0" />
10.   <Properties>
11.     <DisplayName>CoreAppUAP</DisplayName>
12.     <PublisherDisplayName>wherewhere</PublisherDisplayName>
13.     <Logo>Assets\StoreLogo.png</Logo>
14.   </Properties>
16.   <Prerequisites>
17.     <OSMinVersion>6.2.0</OSMinVersion>
18.     <OSMaxVersionTested>6.3.0</OSMaxVersionTested>
19.   </Prerequisites>
21.   <Resources>
22.     <Resource Language="x-generate"/>
23.   </Resources>
25.   <Applications>
26.     <Application Id="App"
27.       Executable="$targetnametoken$.exe"
28.       EntryPoint="$targetentrypoint$">
29.       <VisualElements
30.         DisplayName="CoreAppUAP"
31.         Logo="Assets\MediumTile.png"
32.         SmallLogo="Assets\AppIcon.png"
33.         Description="CoreAppUAP"
34.         ForegroundText="light"
35.         BackgroundColor="transparent">
36.         <DefaultTile WideLogo="Assets\WideTile.png"/>
37.         <SplashScreen Image="Assets\SplashScreen.png"/>
38.         <InitialRotationPreference>
39.           <Rotation Preference="landscape"/>
40.           <Rotation Preference="portrait"/>
41.           <Rotation Preference="landscapeFlipped"/>
42.           <Rotation Preference="portraitFlipped"/>
43.         </InitialRotationPreference>
44.         <LockScreen Notification="badgeAndTileText" BadgeLogo="Assets\BadgeLogo.png"/>
45.       </VisualElements>
46.     </Application>
47.   </Applications>
49.   <Capabilities>
50.     <Capability Name="internetClient" />
51.   </Capabilities>
52. </Package>

复制代码

然后我们在csproj中添加以下内容来取消引用VC++和TargetDeviceFamily

1. <PropertyGroup>
2.   <AddMicrosoftVCLibsSDKReference>False</AddMicrosoftVCLibsSDKReference>
3.   <EnableAppxWindowsUniversalTargetDeviceFamilyItem>False</EnableAppxWindowsUniversalTargetDeviceFamilyItem>
4. </PropertyGroup>

复制代码

不过删除了这些引用仍然会在清单生成Dependencies标签，如果Dependencies是空的注册时会报错，所以我们需要添加任务来删除清单中的Dependencies元素

1. <UsingTask
2.   TaskName="RemoveDependencies"
3.   TaskFactory="CodeTaskFactory"
4.   AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
5.   <ParameterGroup>
6.     <AppxManifestPath ParameterType="System.String" Required="true" />
7.   </ParameterGroup>
8.   <Task>
9.     <Reference Include="System.Xml" />
10.     <Reference Include="System.Xml.Linq" />
11.     <Using Namespace="System.Linq" />
12.     <Using Namespace="System.Xml.Linq" />
13.    
14.       <![CDATA[
15.           try
16.           {
17.               var xdoc = XDocument.Load(AppxManifestPath);
18.               var ns = xdoc.Root.Name.Namespace;
19.               var dependencies = xdoc.Root.Descendants(ns + "Dependencies");
20.               if (dependencies != null)
21.               {
22.                   foreach (var node in dependencies.ToArray())
23.                   {
24.                       if (!node.HasElements)
25.                       {
26.                           node.Remove();
27.                       }
28.                   }
29.               }
30.               xdoc.Save(AppxManifestPath);
31.           }
32.           catch
33.           {
34.               Log.LogError("Failed to load Appx Manifest.");
35.               _Success = false;
36.           }
37.       ]]>
38.     </Code>
39.   </Task>
40. </UsingTask>
42. <Target
43.   Name="RemoveDependencies"
44.   AfterTargets="AfterGenerateAppxManifest">
45.   <Message Importance="high" Text="RemoveDependencies" />
46.   <RemoveDependencies AppxManifestPath="%(FinalAppxManifest.Identity)" />
47. </Target>

复制代码

由于 XAML 编译器编译App.xaml时生成的入口点会利用DispatcherQueueSynchronizationContext来注册线程上下文，这是16299才参加的 API，UAP 在获取DispatcherQueue时会返回null，所以我们需要手动生成入口点和注册线程上下文
首先我们需要添加DISABLE_XAML_GENERATED_MAIN来注释自动生成的入口点

1. <DefineConstants>$(DefineConstants);DISABLE_XAML_GENERATED_MAIN</DefineConstants>

复制代码

然后手动编写程序入口点

1. public static class Program
2. {
3.     public static void Main(string[] args) => Application.Start(static p => _ = new App());
4. }

复制代码

接着我们需要手动创建一个利用CoreDispatcher的线程上下文

1. /// <summary>
2. /// Provides a synchronization context for <see cref="CoreDispatcher"/>.
3. /// </summary>
4. /// <param name="dispatcher">The <see cref="CoreDispatcher"/> to associate this <see cref="CoreDispatcherSynchronizationContext"/> with.</param>
5. public sealed class CoreDispatcherSynchronizationContext(CoreDispatcher dispatcher) : SynchronizationContext
6. {
7.     /// <inheritdoc />
8.     public override void Post(SendOrPostCallback d, object? state)
9.     {
10.         ArgumentNullException.ThrowIfNull(d);
11.         _ = dispatcher.RunAsync(CoreDispatcherPriority.Normal, () => d.Invoke(state));
12.     }
14.     /// <inheritdoc />
15.     public override SynchronizationContext CreateCopy() => new CoreDispatcherSynchronizationContext(dispatcher);
17.     /// <inheritdoc />
18.     public override void Send(SendOrPostCallback d, object? state) => throw new NotSupportedException("'SynchronizationContext.Send' is not supported.");
19. }

复制代码

并在合适的时间注册线程上下文，比如OnWindowCreated

1. protected override void OnWindowCreated(WindowCreatedEventArgs e)
2. {
3.     if (SynchronizationContext.Current == null)
4.     {
5.         CoreDispatcherSynchronizationContext context = new(e.Window.Dispatcher);
6.         SynchronizationContext.SetSynchronizationContext(context);
7.     }
8.     base.OnWindowCreated(e);
9. }

复制代码

然后就可以点运行运行了

经测试，热重载等调试功能正常，UAP 可以调用一些与 UI 无关的新 WinRT API，乃至可以扩展标题栏，不过打包后无法成功在 Win8.1 安装，原因未知

末了附上示例应用：https://github.com/wherewhere/CoreAppUAP

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。