Reactor.Uwp 0.1.0-alpha.3

Reactor.Uwp

UWP + WinUI 2 的声明式 UI 框架：用 C# 描述界面，不写 XAML。

• 仓库：https://github.com/yunmoxinghe/ReactorForUWP
• 包：https://www.nuget.org/packages/Reactor.Uwp
• 问题反馈：https://github.com/yunmoxinghe/ReactorForUWP/issues
• 许可：MIT

仓库里各目录的用途（这个包只含 Reactor.uwp/）：

路线

映射 WinUI 2，不是内置控件树。 元素最终都落成真实的 Windows.UI.Xaml / Microsoft.UI.Xaml（WinUI 2）控件：样式、输入法、无障碍、性能全部是原生的。 代价是被 WinUI 2 的能力边界卡住——它缺的控件这里也缺。

唯一的自实现控件是 VirtualizingList（ScrollViewer + Canvas），那是对 ItemsRepeater 的补位，不是主线。

安装

<PackageReference Include="Reactor.Uwp" Version="0.1.0-alpha.3" />

消费方项目要求（与本机工程一致）：

<PropertyGroup>
  <TargetFramework>net10.0-windows10.0.26100.0</TargetFramework>
  <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
  <UseUwp>true</UseUwp>
</PropertyGroup>

包自带 Microsoft.UI.Xaml 2.8.7 与 CommunityToolkit.Uwp.Controls.SettingsControls 依赖，不用另外装。

用法

using Microsoft.UI.Reactor.Core;
using Reactor.Uwp.Hosting;
using static Microsoft.UI.Reactor.Factories;

// 入口：没有 App.xaml，手写 Main 启动
public sealed partial class App : ReactorApplication<CounterPage>
{
    public static void Main(string[] args) =>
        Windows.UI.Xaml.Application.Start(_ => new App());
}

public sealed class CounterPage : Component
{
    public override Element Render()
    {
        var (count, setCount) = UseState(0);

        return VStack(
            TextBlock($"Count: {count}"),
            HStack(
                Button("-", () => setCount(count - 1)),
                Button("+", () => setCount(count + 1))));
    }
}

manifest 里把入口指向这个类：

<Application Id="App" Executable="$targetnametoken$.exe" EntryPoint="MyApp.App" />

组件用 Render() 描述一次界面，之后状态变化由框架 diff 出最小改动打到真实控件上。 UseState / UseEffect / Component<TProps> / Provide-Context 都有。

直接操作原生控件用 Native(Func<UIElement> factory) 逃生舱：控件自己造， 框架只负责放进布局和卸载时收走（库还没包住的控件走这条路）。

已知限制（alpha）

• 原生桥只带 x64 预编译产物。 Reactor.Uwp.Native.dll 用于给 ItemsRepeater 提供 C# 实现的 IElementFactory（WinUI 2 的 C# 投影把该接口标成了 internal， 只能从原生侧补）。x86 / arm64 目前没有预编译产物，那些架构下自定义工厂不可用； 其余功能不受影响。
• WinUI 2 的能力边界就是本框架的边界：它没提供的控件（如完整的 TabView / AutoSuggestBox / SplitView 封装）需要走 Native() 或自己补。
• API 尚未稳定，minor 版本内可能变。

状态

首个 alpha。已验证的核心链路：纯 C# 启动与 WinUI 2 资源加载、元素 diff/patch、 Frame 导航与过渡、设置页（SettingsCard / SettingsExpander）、 ItemsRepeater 虚拟化（含回收不变量校验）。 未做：NuGet 上的正式版、xml 文档、多架构原生产物。

发布（Trusted Publishing）

包通过 GitHub Actions 发布，走 nuget.org 的 Trusted Publishing（OIDC）， 仓库里不存 API key。工作流见 .github/workflows/publish.yml， 手动触发或推 v* tag 均可。

nuget.org 侧的策略（Account → Trusted Publishing）需要四个值：

仓库侧只留一个 secret：NUGET_USER = nuget.org 的用户名 yunmoxing （不是邮箱，也不是 GitHub 上的 yunmoxinghe）。

两点提醒：策略是按包所有者生效的，不限于单个包 id， 所以 scope 建议用 glob 限定到 Reactor.Uwp； 私有仓库的策略初次只有 7 天临时激活期， 首次成功登录（不必真的推包）后才会永久绑定 GitHub 的 repo/owner ID。