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