如何解决Windows App SDK打包C#应用开机自启失败问题？

问题根源 #

传统UWP应用的OnActivated方法在WASDK（Windows App SDK）中已不再适用，开机自启动的激活场景需要通过注册Activated事件或完善OnLaunched方法来处理，确保应用在后台激活时能正确创建并激活主窗口。

具体修复步骤 #

1. 确认Package.appxmanifest配置正确 #

确保已添加startupTask扩展，替换占位符为你的应用信息：

<Package ... xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5">
  <Applications>
    <Application ...>
      <Extensions>
        <uap5:Extension Category="windows.startupTask" 
                        Executable="$targetnametoken$.exe" 
                        EntryPoint="$targetentrypoint$">
          <uap5:StartupTask TaskId="MyAppStartupTask" 
                           Enabled="true" 
                           DisplayName="我的应用开机自启动"/>
        </uap5:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

2. 处理应用激活事件 #

在App.xaml.cs中，通过注册Activated事件来捕获开机自启动的激活场景，确保主窗口被创建并激活：

using Microsoft.UI.Xaml;
using Windows.ApplicationModel.Activation;

namespace YourAppNamespace
{
    public partial class App : Application
    {
        public App()
        {
            this.InitializeComponent();
            // 注册激活事件
            this.Activated += OnAppActivated;
        }

        protected override void OnLaunched(LaunchActivatedEventArgs args)
        {
            // 处理普通启动，确保主窗口存在
            EnsureMainWindow();
        }

        private void OnAppActivated(object sender, WindowActivatedEventArgs e)
        {
            // 判断是否为开机自启动激活
            if (e.Kind == ActivationKind.StartupTask)
            {
                EnsureMainWindow();
            }
        }

        private void EnsureMainWindow()
        {
            // 检查是否已有主窗口，没有则创建
            if (App.Current.Windows.Count == 0)
            {
                var mainWindow = new MainWindow();
                mainWindow.Activate();
            }
            else
            {
                // 激活已存在的主窗口，避免闪屏后无界面
                var existingWindow = App.Current.Windows[0];
                existingWindow.Activate();
            }
        }
    }
}

3. 可选：确保开机自启动权限生效 #

在主窗口加载时，检查并请求用户启用开机自启动权限（首次启动时需要用户授权）：

using Windows.ApplicationModel;
using Microsoft.UI.Xaml;

namespace YourAppNamespace
{
    public sealed partial class MainWindow : Window
    {
        public MainWindow()
        {
            this.InitializeComponent();
            this.Loaded += MainWindow_Loaded;
        }

        private async void MainWindow_Loaded(object sender, RoutedEventArgs e)
        {
            // 对应manifest中设置的TaskId
            var startupTask = await StartupTask.GetAsync("MyAppStartupTask");
            
            if (startupTask.State == StartupTaskState.DisabledByUser || 
                startupTask.State == StartupTaskState.DisabledByPolicy)
            {
                // 请求用户启用开机自启动
                var result = await startupTask.RequestEnableAsync();
            }
        }
    }
}

关键注意点 #

• 开机自启动属于后台激活场景，必须显式激活主窗口，否则应用会在闪屏后进入后台，用户看不到界面。
• TaskId必须在manifest和代码中保持一致，否则无法正确关联启动任务。
• Windows系统可能会限制某些应用的开机自启动权限，需要用户手动确认启用。

内容的提问来源于stack exchange，提问作者Frank