BLE/UWP开发是否需要Package.appxmanifest？我的WPF应用无它也可运行？

我有一个C#（WPF）应用，使用UWP命名空间通过低功耗蓝牙（BLE）与设备配对并获取数据，偶尔会出现间歇性问题（尤其是GetGattServicesAsync调用偶尔挂起），但大多时候运行正常。

查阅资料发现，多数来源指出需包含蓝牙DeviceCapability的Package.appxmanifest文件，但我的BLE测试命令行应用及主WPF应用，无该文件也能大体正常运行，添加后也未改善间歇性问题。

附上参考微软官方文档添加蓝牙功能后的manifest文件：

<?xml version="1.0" encoding="utf-8"?>
<Package xmlns="http://schemas.microsoft.com/appx/2010/manifest"
         xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
  <Identity Name="Vitalograph.Spirotrac.RemoteTablet" 
            Version="2.0.21"
            Publisher="Vitalograph" />
  <Properties>
    <DisplayName>Spirotrac Remote Tablet</DisplayName>
    <PublisherDisplayName>Vitalograph</PublisherDisplayName>
    <Logo></Logo>
  </Properties>
  <Prerequisites>
    <OSMinVersion>6.2.1</OSMinVersion>
    <OSMaxVersionTested>6.2.1</OSMaxVersionTested>
  </Prerequisites>
  <Resources>
    <Resource Language="en-gb" />
  </Resources>
  <Applications>
    <Application Id="Vitalograph.Spirotrac.RemoteTablet" StartPage="default.html">
      <VisualElements DisplayName="Spirotrac Remote Tablet" Description="Spirotrac Remote Tablet"
           Logo="" SmallLogo=""  
           ForegroundText="dark" BackgroundColor="#FFFFFF">
         <SplashScreen Image="" />
      </VisualElements>
    </Application>
  </Applications>
  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.genericAttributeProfile">
      <m2:Device Id="any">
        <m2:Function Type="serviceId:46A970E0-0D5F-11E2-8B5E-0002A5D5C51B"/>
        <m2:Function Type="name:heartRate"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>
</Package>

我参考微软官方文档创建该清单并添加蓝牙功能，现存在疑问：是否必须使用该文件？它的作用是什么？蓝牙功能在单独的DLL项目中，该文件应添加到主exe项目还是DLL项目？是否需要设置“复制到输出目录”？

编辑：我已根据Jimi提供的链接更新了manifest代码，并确保其复制到构建文件夹，但问题仍未改善。

关于Package.appxmanifest的核心疑问 #

• 是否必须使用该文件？
  不是绝对强制，但强烈建议使用。UWP蓝牙API原本为打包的UWP应用设计，桌面应用（WPF/WinForms）调用这类API属于桌面桥兼容场景。没有manifest时，系统会默认授予基础权限，但权限范围不明确，易引发行为不稳定（比如你遇到的间歇性挂起），且未来系统版本可能收紧权限，导致应用直接无法访问BLE设备。

• 它的作用是什么？

  • 明确声明应用所需的设备权限，让Windows系统精准授予蓝牙GATT服务访问权限，避免权限模糊导致的异常。
  • 为桌面应用提供UWP API的访问上下文，确保API能正确识别应用身份，减少因权限边界不清晰引发的异步操作问题。
  • 可指定需要访问的特定BLE服务（如你manifest中配置的serviceId和name），避免请求不必要的权限，同时提升系统权限校验的准确性。

• 应添加到主exe项目还是DLL项目？
  必须添加到主EXE项目。权限是针对整个应用进程的，DLL不具备独立进程身份，系统只会读取主进程的manifest配置。

• 是否需要设置“复制到输出目录”？
  需要。需将manifest文件设置为复制到输出目录（如果较新则复制），且确保输出目录中manifest与EXE同名（例如EXE名为SpirotracRemoteTablet.exe，manifest需命名为SpirotracRemoteTablet.exe.manifest），这样系统加载应用时才能正确读取权限配置。

关于GetGattServicesAsync间歇性挂起的补充建议 #

既然更新manifest后问题仍存在，可尝试以下方案排查：

• 添加超时机制：用Task.WhenAny搭配延迟任务，避免异步调用无限挂起：

  var gattTask = device.GetGattServicesAsync();
  var timeoutTask = Task.Delay(TimeSpan.FromSeconds(10));
  if (await Task.WhenAny(gattTask, timeoutTask) == timeoutTask)
  {
      // 处理超时：重试、提示用户或断开重连
  }
  else
  {
      var serviceResult = gattTask.GetAwaiter().GetResult();
      if (serviceResult.Status == GattCommunicationStatus.Success)
      {
          // 处理获取到的服务
      }
      else
      {
          // 处理通信失败逻辑
      }
  }
  

• 检查设备与环境：排查BLE设备的电量、信号强度，低电量或弱信号易导致响应延迟；同时确保系统蓝牙驱动为最新版本。
• 线程上下文处理：在WPF中调用UWP蓝牙API时，尽量通过Dispatcher调度到UI线程执行，避免线程上下文不一致引发的异步操作异常。
• 异常捕获与处理：为GetGattServicesAsync添加完整的异常捕获，有些设备断开或通信异常时，API可能不会主动抛出异常，而是导致任务挂起。

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