Bili.Uwp 上手指南:Windows 上跑起自己的 UWP 哔哩哔哩客户端
2026/9/20 18:26:13 网站建设 项目流程

Bili.Uwp 上手指南:Windows 上跑起自己的 UWP 哔哩哔哩客户端

【免费下载链接】Bili.Uwp适用于新系统UI的哔哩项目地址: https://gitcode.com/GitHub_Trending/bi/Bili.Uwp

Bili.Uwp(仓库内名为“哔哩”)是一款用 C# 和 UWP 框架开发的哔哩哔哩第三方客户端,原生运行在 Windows 10/11 上,带桌面与 Xbox 大屏两套界面。本文面向想从源码构建、本地安装的用户:装好 Visual Studio 后打开解决方案部署一次,推荐流、番剧、直播和动态通知就能照常使用。

先看看它长什么样

桌面版主界面是深色主题:左侧为功能导航,顶部是搜索框,中间是当前页面的内容区,点导航即可切换,不需要多窗口。

Xbox 端是独立布局,为大屏和遥控器焦点导航优化,适合接电视。

部署前需要哪些环境

  • 系统:Windows 10 1903(build 18362)及以上,或任意版本 Windows 11
  • 工具:Visual Studio 2019 或 2022,安装时勾选“通用 Windows 应用开发”工作负载
  • 解决方案文件:Bili.Uwp.sln 对应 UWP 应用,Bili.Workspace.sln 是另一套 WinUI 版本,本文跑 UWP 版

克隆代码并部署到本机

  1. 获取代码:git clone https://gitcode.com/GitHub_Trending/bi/Bili.Uwp
  2. 用 Visual Studio 打开 Bili.Uwp.sln,等待自动还原 NuGet 包。仓库在 nuget.config 里配了两个包源,还原时需要网络可达
  3. 平台选择器选 x64 和 Debug,部署目标设为“本机电脑”,按 F5。首次运行会自动生成测试证书完成签名(签名配置在 src/App/Package.appxmanifest 与工程签名设置中),结束后开始菜单出现“哔哩”
  4. 打开应用,先在右上角扫码登录账号,再开始浏览

不想编译的话,也可以到仓库 Release 页面下载对应系统的安装包:在系统设置中开启“开发者模式”,解压后以管理员身份运行 Windows PowerShell 执行包内的 install.ps1,按提示安装。

核心玩法

浏览推荐流与追番

打开应用默认进入“推荐”,向下滚动加载更多。点任意视频进入播放页,右侧是相关推荐与评论区,点评论可展开回复。“热门”“排行榜”“番剧”“纪录片”都是左侧独立入口,番剧页支持追番与继续上次观看的位置。

搜索与分类切换

点击顶栏搜索框,输入时会实时出现联想,旁边还有热搜入口。输入关键词回车后进入结果页,可以在顶部切换视频、番剧、直播、用户等分类。

看直播与收动态

“直播”页按分区浏览,点房间进入直播播放器,右侧是实时聊天区。关注 UP 主后,新动态会通过系统通知推送,这部分由 src/Tasks/ 里的后台任务完成,应用关闭后依然生效。

在客厅里看

接电视或大屏环境时,应用会进入 Xbox 模式布局(对应页面在 src/App/Pages/Xbox/),遥控器上下移动焦点、确认键进入,适合远距离操作。

提效细节

  • 主题:设置中支持浅色、深色、高对比度,深浅色可跟随系统
  • 工具箱:独立页面提供 av/bv 号转换和封面图下载两个小工具
  • 繁中:设置里一键切换界面语言
  • 缓存与日志:缓存策略和日志级别可调,排查问题时先开日志
  • 自启动:应用注册了启动任务,可在系统设置中按需启用

常见问题速查

现象可能原因处理方式
部署后提示应用被阻止或证书错误目标机器未安装测试证书在装了 Visual Studio 的本机部署;装到别的机器需先安装测试证书
NuGet 还原失败包源网络不通检查 nuget.org 与 CommunityToolkit Labs 源是否可达,或换网络重试
视频播不动或黑屏带宽不足或未登录导致的播放权限受限先降一档清晰度,登录账号后再试
Release 构建很慢或失败Release 走 Native AOT 工具链,组件不全先用 Debug 验证,仅正式打包时切 Release

代码按层划分:UI 在 src/App/,数据请求适配器在 src/Adapter/Adapter.Implementation/,页面逻辑在 src/ViewModels/。想继续深入,建议从推荐页和播放页的代码读起。

【免费下载链接】Bili.Uwp适用于新系统UI的哔哩项目地址: https://gitcode.com/GitHub_Trending/bi/Bili.Uwp

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询