示例工程【免费下载链接】Windows-universal-samplesAPI samples for the Universal Windows Platform.项目地址https://gitcode.com/gh_mirrors/wi/Windows-universal-samples点击查看免费下载本篇技术指南以 Samples/AppServices/README.md 为骨架结合 Windows-universal-samples 仓库中 C# 与 C/WinRT 两个版本的完整实现源码系统讲解 UWP「应用服务App Service」的声明、实现、连接、消息收发与远程调用全流程。读完本文你将掌握如何用AppServiceConnection让一个应用向另一个应用甚至另一台电脑暴露可调用的服务并能在自己的 UWP 项目中复刻「打开即用」与「长连接复用」两种典型通信模式。示例概览一次跨应用调用的最小闭环App Services应用服务是 UWP 提供的应用间通信机制一个应用Provider服务提供方把一段能力包装成服务并注册到系统另一个应用Client客户端通过AppServiceConnection发现并调用它消息以ValueSet键值对字典为载体传递。整个过程无需两个应用直接握手 socket系统负责把客户端进程与服务进程连接起来。本示例由两个 UWP 项目外加一个后台任务组成见 Samples/AppServices 目录项目职责C# 路径C/WinRT 路径AppServicesProvider服务提供方注册名为com.microsoft.randomnumbergenerator的应用服务cs/AppServicesProvidercppwinrt/AppServicesProviderRandomNumberService承载服务逻辑的 Windows 运行时后台任务IBackgroundTaskcs/RandomNumberService/RandomNumberGeneratorTask.cscppwinrt/RandomNumberService/RandomNumberGeneratorTask.cppAppServicesClient服务调用方内置两个场景页cs/AppServicesClientcppwinrt/AppServicesClient服务本身的功能很纯粹接收客户端传入的最小值/最大值返回一个区间内的随机整数。客户端则演示了两种连接策略打开-连接-关闭OpenCloseConnection调用一次就建立连接、发送消息、取回结果并立即释放连接对应 OpenCloseConnectionScenario.xaml保持连接KeepConnectionOpen连接打开后持续复用直到用户显式关闭对应 KeepConnectionOpenScenario.xaml。两个场景的 XAML 界面最小值、最大值、结果三个控件存放在共享目录 Samples/AppServices/shared由各语言的代码后置文件驱动逻辑这正是 Windows-universal-samples 仓库典型的「共享 UI 多语言实现」组织方式。服务提供方两步声明一个可被调用的应用服务要让系统知道某个应用「提供」了服务必须完成两件事在清单中声明扩展实现后台任务并挂接RequestReceived事件。1. 清单声明Package.appxmanifest以 C# 版本的 cs/AppServicesProvider/Package.appxmanifest 为例关键片段如下Identity NameMicrosoft.SDKSamples.AppServicesProvider.CS PublisherCNMicrosoft Corporation, OMicrosoft Corporation, LRedmond, SWashington, CUS Version1.0.0.0 / ... Extensions uap:Extension Categorywindows.appService EntryPointRandomNumberService.RandomNumberGeneratorTask uap3:AppService Namecom.microsoft.randomnumbergenerator SupportsRemoteSystemstrue/ /uap:Extension /Extensions逐项说明uap:Extension的Categorywindows.appService声明这是一个应用服务扩展EntryPoint指向后台任务类RandomNumberService.RandomNumberGeneratorTask它必须实现IBackgroundTaskuap3:AppService的Name是服务的全局标识符客户端连接时必须精确匹配这个字符串本示例为com.microsoft.randomnumbergenerator采用了反向域名命名惯例SupportsRemoteSystemstrue允许其他电脑上的客户端通过远程系统框架连接本服务这是 README 特别强调的声明也是与 Samples/RemoteSystems 示例联动的关键开关。同样地C/WinRT 版本的清单 cppwinrt/AppServicesProvider/Package.appxmanifest 结构完全一致仅Identity.Name变为Microsoft.SDKSamples.AppServicesProvider.CPPWINRT。注意两个清单的TargetDeviceFamily都声明了MinVersion10.0.14393.0、MaxVersionTested10.0.22621.0说明该示例面向 Windows 10 周年更新14393及以上的 Universal 平台。2. 后台任务挂接请求并回复服务本体是 RandomNumberGeneratorTask.cs 中的IBackgroundTask核心逻辑浓缩在Run与OnRequestReceived两个方法中public void Run(IBackgroundTaskInstance taskInstance) { // 1. 获取服务延迟deferral防止后台任务在等待期间被系统终止 serviceDeferral taskInstance.GetDeferral(); taskInstance.Canceled OnTaskCanceled; // 2. 初始化随机数生成器 randomNumberGenerator new Random((int)DateTime.Now.Ticks); // 3. 从触发器详情中取出系统注入的 AppServiceConnection var details taskInstance.TriggerDetails as AppServiceTriggerDetails; connection details.AppServiceConnection; // 4. 监听客户端发来的请求 connection.RequestReceived OnRequestReceived; }请求处理函数拿到AppServiceRequestReceivedEventArgs后先取消息延迟保证能安全地使用异步 API 回复再解析ValueSet参数并回写结果async void OnRequestReceived(AppServiceConnection sender, AppServiceRequestReceivedEventArgs args) { var messageDeferral args.GetDeferral(); // 消息级延迟 try { var input args.Request.Message; // 客户端传来的 ValueSet int minValue (int)input[minvalue]; int maxValue (int)input[maxvalue]; var result new ValueSet(); result.Add(result, randomNumberGenerator.Next(minValue, maxValue)); await args.Request.SendResponseAsync(result); // 回复客户端 } finally { messageDeferral.Complete(); // 通知平台本次响应处理完毕 } }两个延迟deferral是应用服务编程中最重要的细节任务级延迟taskInstance.GetDeferral()让后台任务在连接生命周期内不被系统回收消息级延迟args.GetDeferral()则保证异步的SendResponseAsync执行完之前平台不会判定响应超时。任务被取消OnTaskCanceled时则要释放连接并Complete服务延迟形成对称的清理路径。C/WinRT 版本 RandomNumberGeneratorTask.cpp 的职责划分与 C# 完全一致只是 API 形态换成投影类型事件用{ get_weak(), ... }弱引用回调防悬挂、ValueSet用Insert/TryLookup、随机数改用random的uniform_int_distribution返回类型是fire_and_forget协程并且它对maxvalue minvalue的异常输入做了防御性兜底把最大值钳制为最小值可作为健壮性处理的参考。两种语言都遵循「Run 建连接 → RequestReceived 响应 → 取消时清理」这一固定流程。客户端场景一打开连接、调用一次、立即关闭对应 OpenCloseConnectionScenario.xaml.cs这是应用服务最简调用范式用using块把连接的生命周期限制在一次调用内。连接建立阶段——设置服务名与包系列名PFN随后OpenAsyncusing (var connection new AppServiceConnection()) { connection.AppServiceName com.microsoft.randomnumbergenerator; connection.PackageFamilyName Microsoft.SDKSamples.AppServicesProvider.CS_8wekyb3d8bbwe; AppServiceConnectionStatus status await connection.OpenAsync(); ... }两个标识符缺一不可其来源分别是AppServiceName与提供方清单中uap3:AppService Name完全一致的字符串PackageFamilyName提供方应用的程序包系列名。提供方自带一个 ShowPackageFamilyName.xaml.cs 辅助页面通过Package.Current.Id.FamilyName直接读出当前包的 PFN 展示在界面上——当提供方部署到你的设备后PFN 以该页面显示为准代码里硬编码的..._8wekyb3d8bbwe后缀对应微软 SDK 签名证书。OpenAsync的返回值需要完整处理示例对每种失败原因都给出了可操作的提示AppServiceConnectionStatus含义与排查方向源自源码注释/提示文案Success连接成功AppNotInstalled提供方应用未部署到设备需先部署 AppServicesProviderAppUnavailable提供方不可用可能正在更新或安装在已不可用的可移动设备上AppServiceUnavailable提供方已安装但未提供AppServiceName指定的服务查清单声明Unknown未知错误消息收发阶段——用ValueSet装载参数并发送var inputs new ValueSet(); inputs.Add(minvalue, minValueInput); inputs.Add(maxvalue, maxValueInput); AppServiceResponse response await connection.SendMessageAsync(inputs); if (response.Status AppServiceResponseStatus.Success response.Message.ContainsKey(result)) { var resultText response.Message[result].ToString(); Result.Text resultText; }SendMessageAsync返回的AppServiceResponse同样需要按状态分支处理Failure表示服务未能确认消息可能已被终止或RequestReceived处理器异常、ResourceLimitsExceeded表示服务超出系统分配的资源而被终止、Unknown为未知失败。UI 侧则在GenerateRandomNumber_Click里先对文本框做int.TryParse校验并强制maxValue minValue保证发往服务的参数永远合法——这些校验逻辑与 XAML 中的 OpenCloseConnectionScenario.xaml 控件一一对应。客户端场景二长连接复用与生命周期管理对应 KeepConnectionOpenScenario.xaml.cs。与场景一不同这里把AppServiceConnection提升为页面级字段连接只建立一次可被多次SendMessageAsync复用private AppServiceConnection connection; // 打开连接防重入 注册 ServiceClosed if (connection ! null) { rootPage.NotifyUser(A connection already exists, NotifyType.ErrorMessage); return; } connection new AppServiceConnection(); connection.AppServiceName com.microsoft.randomnumbergenerator; connection.PackageFamilyName Microsoft.SDKSamples.AppServicesProvider.CS_8wekyb3d8bbwe; connection.ServiceClosed Connection_ServiceClosed; AppServiceConnectionStatus status await connection.OpenAsync(); // 注意await 期间连接可能已被 ServiceClosed 置空必须判空 if (connection null) { rootPage.NotifyUser(Connection was closed, NotifyType.ErrorMessage); return; }这段代码示范了长连接场景下最容易踩的三个坑源码里都有对应处理防重入点击「Open Connection」前先检查connection ! null避免重复建连await竞态await connection.OpenAsync()挂起期间用户可能已点击关闭、ServiceClosed可能已触发因此恢复执行后必须先判空再继续服务端断开通知订阅ServiceClosed事件在回调里通过Dispatcher.RunAsync切回 UI 线程Dispose()并置空连接引用private async void Connection_ServiceClosed(AppServiceConnection sender, AppServiceClosedEventArgs args) { await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () { if (connection ! null) { connection.Dispose(); connection null; } }); }关闭路径同样值得注意CloseConnection_Click直接Dispose()连接并置空而页面级清理放在OnNavigatedFrom中保证离开场景页时连接一定被释放不留悬挂引用。发送消息的方法体与场景一高度相似只是在发送前先校验connection null并给出「You need to open a connection before trying to generate a random number.」的引导提示形成完整的 UX 闭环。跨设备SupportsRemoteSystems 与 RemoteSystems 示例的联动README 明确指出RemoteSystems 示例包含一个从另一台电脑连接本服务的场景而本示例正是通过在清单中声明SupportsRemoteSystemstrue来允许这种远程连接。两处仓库证据相互印证提供方清单C# 版与 C/WinRT 版都带SupportsRemoteSystemstrue远程客户端实现在 Samples/RemoteSystems/cs/Scenario3_LaunchAppServices.xaml.cs它先通过RemoteSystem发现选定远端设备构造RemoteSystemConnectionRequest再用同一个AppServiceConnection对象调用OpenRemoteAsync而不是OpenAsyncRemoteSystemConnectionRequest connectionRequest new RemoteSystemConnectionRequest(selectedSystem); using (AppServiceConnection connection new AppServiceConnection { AppServiceName com.microsoft.randomnumbergenerator, PackageFamilyName Microsoft.SDKSamples.AppServicesProvider.CS_8wekyb3d8bbwe }) { AppServiceConnectionStatus status await connection.OpenRemoteAsync(connectionRequest); if (status AppServiceConnectionStatus.Success) { // 连接成功后即可像本地一样 SendMessageAsync await SendMessageToRemoteAppServiceAsync(connection); } }可见客户端侧的编程模型在本地与远程之间完全一致——只需把OpenAsync换成OpenRemoteAsync并传入连接请求。这也解释了为什么 README 建议把 AppServices 与 RemoteSystems 两个示例搭配学习前者是服务的「提供端 本地消费端」后者是服务的「远程消费端」。构建与运行环境与系统要求README 列出的系统要求为客户端Windows 10服务器Windows Server 2016 Technical Preview手机Windows 10。结合清单中的TargetDeviceFamilyMinVersion10.0.14393.0构建环境需为 Windows 10 周年更新或更高版本并使用 Visual Studio 与 Windows 开发者工具。构建步骤若从 ZIP 下载整个示例集合务必解压完整归档不是只解压目标示例文件夹因为示例依赖仓库根目录的 SharedContent 共享内容参见 README front-matter 中的extendedZipContent对SharedContent与LICENSE的引用启动 Visual Studio选择File Open Project/Solution进入 Samples/AppServices 下的子目录按偏好选择语言版本的解决方案文件.sln当前仓库提供csC#与cppwinrtC/WinRT两套与 README 的 front-matterlanguages: csharp, cpp, cppwinrt对应早期的 C/CX 与 Visual Basic 版本已归档至 archived/AppServices仅供历史参考按CtrlShiftB或Build Build Solution编译。运行步骤仅部署选择Build Deploy Solution部署并运行确保AppServicesProvider 项目已部署否则客户端会得到AppNotInstalled错误源码中对此有专门提示把AppServicesClient 设为启动项目按F5调试运行或CtrlF5不调试运行。两个场景的界面都要求先输入整数形式的 Minimum Value 与 Maximum Value 再点击 Generate Random Number场景二还需先点击打开连接这是两份客户端源码中共有的交互前提。小结从 README 的两个项目、两个场景出发结合仓库源码可以看到 UWP 应用服务的完整技术栈提供方用「清单windows.appService扩展 IBackgroundTaskRequestReceived事件」暴露服务客户端用「AppServiceNamePackageFamilyName定位服务、OpenAsync/OpenRemoteAsync建立连接、ValueSet收发消息、ServiceClosed与双 deferral 管理生命周期」再加上SupportsRemoteSystemstrue即可一键扩展到跨设备调用。这套模式可直接迁移到任意「两个 UWP 应用间解耦通信」的真实需求中例如主应用调用独立打包的扩展应用能力、IoT 场景下的控制面服务等。更多联动示例可继续阅读 Samples/RemoteSystems 的远程应用服务场景。相关主题关联示例Samples/RemoteSystems远程应用服务调用历史实现archived/AppServicesC/CX 与 Visual Basic 归档版核心 API 命名空间Windows.ApplicationModel.AppServices其中AppServiceConnection用于客户端建立连接与发送消息AppServiceTriggerDetails用于服务端接收并响应消息——两者在本示例的提供端与消费端源码中均有直接使用。赞分享示例工程【免费下载链接】Windows-universal-samplesAPI samples for the Universal Windows Platform.项目地址https://gitcode.com/gh_mirrors/wi/Windows-universal-samples点击查看免费下载相关推荐Windows Universal Platform开发指南构建跨设备应用的最佳实践Windows Universal Platform开发指南构建跨设备应用的最佳实践 Windows Universal PlatformUWP是微软推出示例工程如何快速掌握无限长视频生成InfiniteTalk完整使用指南如何快速掌握无限长视频生成InfiniteTalk完整使用指南 你是否曾为传统视频生成工具的时长限制和连贯性问题而烦恼想要制作一段自然的对话视频却受限于软人工智能大模型媒体生成多模态语音数字人Windows-universal-samples响应式设计UWP应用多设备适配技巧Windows universal samples响应式设计UWP应用多设备适配技巧 你是否还在为UWP应用在不同设备上的显示效果不一致而烦恼本文将通过Wi示例工程上一篇HackRF Jawbreaker硬件平台深度解析下一篇Turbo项目开发环境搭建与测试指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
