Delphi开发的Microsoft Store应用打包为Appx后Toast通知失效求助

嘿，我之前帮朋友解决过几乎一模一样的问题——用Delphi开发的程序，Desktop Bridge打包成Appx后Toast通知就失效，还没出现在系统通知列表里。结合Delphi 10.2.3和Desktop Bridge的特性，给你整理几个关键排查点和修复步骤：

• 确保AppxManifest.xml中正确配置通知权限
  这是最容易遗漏的核心点，打包后的UWP应用完全依赖AppxManifest里的权限声明：

  • 打开你的Package.appxmanifest文件，确认添加了Toast相关的权限声明：

    <Capabilities>
      <Capability Name="internetClient" />
      <uap:Capability Name="userNotificationListener" />
      <uap:Capability Name="toastNotification" />
    </Capabilities>
    

  • 还要在<Applications>节点下的<Application>标签内添加通知激活扩展：

    <Extensions>
      <uap:Extension Category="windows.toastNotificationActivation">
        <uap:ToastNotificationActivation ToastActivationType="foreground" />
      </uap:Extension>
    </Extensions>
    

    提示：如果你的应用需要后台处理Toast点击事件，可以把ToastActivationType改成background，但Delphi 10.2.3对UWP后台任务的支持有限，建议先尝试foreground模式。

• 调整Delphi中Toast通知的创建逻辑
  未打包时用的是传统Win32 Toast API，但打包成Appx后必须适配UWP的通知通道机制：

  • 先创建并注册一个专属的应用通知通道（这一步是让应用出现在系统通知列表的关键）：

    uses
      Winapi.Notifications;
    
    var
      ChannelManager: IToastNotificationManagerForUser;
      AppToastChannel: IToastNotificationChannel;
    begin
      ChannelManager := ToastNotificationManager.GetDefault();
      // 这里的通道ID建议用你的应用包名，保证唯一性
      AppToastChannel := ChannelManager.CreateToastNotificationChannel('com.yourcompany.yourapp');
      // 设置通道的显示名称和描述，会在系统通知设置里展示
      AppToastChannel.DisplayName := '你的应用名称';
      AppToastChannel.Description := '接收应用推送的通知';
      AppToastChannel.Save();
    end;
    

  • 发送Toast时，必须通过这个注册好的通道发送，而不是默认通道：

    var
      ToastXmlContent: string;
      ToastDoc: IXmlDocument;
      NewToast: IToastNotification;
    begin
      // 构造符合UWP规范的Toast XML内容
      ToastXmlContent := '<toast><visual><binding template="ToastGeneric"><text>测试通知</text><text>这是打包后的Toast测试内容</text></binding></visual></toast>';
      ToastDoc := ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);
      ToastDoc.LoadXml(ToastXmlContent);
      NewToast := ToastNotificationManager.CreateToastNotification(ToastDoc);
      // 用刚才注册的专属通道显示Toast
      AppToastChannel.Show(NewToast);
    end;
    

• 检查Desktop Bridge打包配置的一致性

  • 建议使用Visual Studio的Windows Application Packaging Project重新打包，Delphi 10.2.3自带的打包工具可能存在兼容性问题，VS的工具对UWP规范的支持更完善。
  • 打包时务必保证AppxManifest里<Identity>节点的Name、Publisher和你Delphi代码中的配置完全匹配，系统会严格验证这个匹配关系，不匹配会导致通知被拦截。

• 强制刷新系统通知缓存
  有时候系统缓存会导致应用无法出现在通知发送者列表里，可以手动触发刷新：

  • 按下Win + R打开运行窗口，输入cmd启动命令提示符，执行以下命令（替换成你的应用包名）：

    powershell -Command "Get-AppxPackage -Name com.yourcompany.yourapp | Foreach-Object {Add-AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppxManifest.xml"}"
    

  • 执行完成后重启应用，再尝试发送Toast，应该就能在系统通知设置里找到你的应用了。

• 排查Delphi项目的权限设置
  打包后的应用运行在受限环境中，一些Win32的权限设置会影响通知功能：

  • 打开Delphi项目设置，在“Manifest File”选项中，确保勾选了“Enable Runtime Themes”，并且“UAC Execution Level”设置为asInvoker（不要设为requireAdministrator，否则会导致通知权限被系统拒绝）。
  • 避免在Toast通知的相关代码中调用需要管理员权限的操作，这类操作会静默失败，不会给出错误提示。

如果上述步骤都试过还是不行，可以打开Windows事件查看器，查看“应用和服务日志 -> Microsoft -> Windows -> ToastNotifications”下的错误日志，里面会详细记录Toast发送失败的具体原因（比如权限不足、XML格式错误、通道未注册等），可以针对性排查。

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