别只盯着网页版！biliuwp第三方哔哩哔哩UWP客户端开源上手指南
别只盯着网页版！biliuwp第三方哔哩哔哩UWP客户端开源上手指南
【免费下载链接】biliuwpbilibili uwp项目地址: https://gitcode.com/gh_mirrors/bi/biliuwp
在 Windows 上刷哔哩哔哩，你是否还在为网页版播放器偶发卡顿、界面要素太多而烦躁？biliuwp 正是一款开源的第三方哔哩哔哩UWP客户端，由开发者"逍遥橙子"用 UWP 技术从零搭建，把视频、直播、番剧、音乐等常用功能收进一个原生桌面应用里。本文不打算照搬官方文档，而是从一个使用者的角度，带你一步步跑通项目、看懂源码，再聊聊换肤和二次开发的玩法。
网页版不够用？先从使用场景认识 biliuwp
先还原一个常见场景：周末想追番，打开网页版，广告位、推荐流、弹幕开关层层叠叠，投影到大屏时布局还容易变形。你真正想要的，其实是一个"干净、顺手、能常驻后台"的桌面入口——这正是第三方客户端存在的理由。
biliuwp 把登录、追番、直播、音乐、搜索、本地视频播放都装进了一个 UWP 应用。启动时能看到颇具辨识度的开屏画面，官方元素和二次元风格并存，第一眼就知道它"姓 B 站"：
从技术层面看，它没有依赖大型框架，而是用 XAML + C# 手写出来的，代码结构相当直白。这一点对初学者反而友好：没有层层封装的框架黑盒，想看懂逻辑并不难。
最快上手路径：四步把 biliuwp 跑起来
第一次接触 UWP 项目的朋友，建议按下面这条最短路径走，顺序和官方手册略有不同，但更不容易中途放弃。
第一步，把仓库克隆到本地。项目托管在镜像仓库中，使用 Git 克隆即可：
git clone https://gitcode.com/gh_mirrors/bi/biliuwp第二步，还原 NuGet 依赖。进入项目根目录执行：
dotnet restore第三步，用 Visual Studio 打开解决方案文件 BiliBili.sln。注意 UWP 项目编译依赖 Windows 平台，请务必在安装 VS 时勾选"通用 Windows 平台开发"工作负载，否则会报找不到 SDK 的错。
第四步，选择 x64（或 Any CPU）后直接"生成 → 部署"。部署成功会自动在开始菜单出现"哔哩哔哩动画 UWP"，点击即可运行。如果只想先验证能否编译通过，也可以先跑一遍dotnet build，看到 Build succeeded 就说明环境没问题。
源码地图：十分钟看懂项目结构
跑起来之后，很多人会好奇：这么多文件夹，从哪里看起？答案其实很清晰——整个仓库由三个工程组成。
- BiliBili.UWP：主程序，所有界面和业务逻辑都在这里，是真正的主角。
- BiliBili.JSBridge：负责与网页层交互的桥接模块，规模不大。
- BiliBili.Background：后台任务工程，支持锁屏/后台继续播放音频，对应包清单里的 backgroundMediaPlayback 能力。
主程序内部按职责划分得非常规整，新手照着目录就能建立全局观：
- Api/ 是接口层，按 Home、Live、Season、User 分门别类，想研究 B 站接口可以重点看这里；
- Pages/ 是页面层，从番剧到直播再到音乐页都独立成文件夹；
- Modules/ 放着各页面对应的 ViewModel，业务逻辑集中在其中；
- Helper/ 则是一系列实用工具，比如下载辅助、弹幕解析、SQLite 存取等。
这套"接口层 + 页面层 + 数据层"的分层思路，比很多商业项目都清爽，适合当作 UWP 入门的活教材。
进阶玩法：换肤、自定义与二次开发切入点
跑通只是开始，biliuwp 真正耐玩的是它的可定制空间。
换肤是最直观的玩法。项目内置了蓝、绿、粉、紫、红、黄以及"EMT"共七套主题，全部放在 Theme/ 目录里。每套主题本质就是一个 ResourceDictionary，只改了几个颜色键。如果你想做出属于自己的配色，复制一份 BlueTheme.xaml 改名，把主色调改成你喜欢的颜色，再在设置里切换即可。
把客户端当本地播放器用也是隐藏技能。包清单里注册了 mp4、flv、avi 等格式的文件关联，双击本地视频就能交给它播放，还支持边播边加载弹幕，观看体验和在线视频一致。
如果你是开发者，二次开发的切入点我已经替你踩好点了：想加"我的关注"新入口，参考 Views/ 里现有页面的写法；想封装一个新接口，去 Api/ 模仿 VideoAPI 的结构；想改进播放逻辑，重点研究 PlayerPage.xaml 和 Helper/PlayurlHelper.cs。整体改动模式就是"新增一个 Api → 补一个 ViewModel → 挂一张 Page"。
常见疑问与避坑指南
上手过程中有几个高频问题，提前知道能省不少时间。
关于移动端兼容：作者在 README 里明确说过，该项目对 Windows 10 Mobile 的支持已经不太理想。如果你手里还留着 Lumia 设备，建议放低预期，它真正的主场是桌面 Windows。
关于弹幕依赖：弹幕渲染并非从零实现，而是依赖作者另一个开源项目 NSDanmaku。想深入弹幕机制的读者，顺藤摸瓜去看这个库会更省力。
关于加载报错：网络波动时偶尔会看到一张"ERROR"风格的提示插画，这属于正常兜底逻辑，不是应用故障，检查网络或稍后重试即可：
最后是一条"心里话"提醒：作者自己也承认，项目早期代码写得不讲究，存在一些历史遗留的 BUG。编译运行完全没问题，但如果你打算拿它做学习样板，请带着批判眼光阅读，别全盘照抄——这恰恰是读开源代码的正确姿势。
同场加映：同类项目怎么选
如果你觉得 biliuwp 的界面不够现代化，市面上还有几个方向可以横向对比。
Richasy 开发的 Bili Uwp 走的是另一条路线，主打设计与易用性，界面打磨得更精致，适合"颜值优先"的用户；而 biliuwp 的优点是结构简单、上手门槛低，适合想研究源码的开发者。至于官方客户端，这些年体验已经大幅改善，功能完整度最高，如果你对第三方生态没有执念，直接用官方版省心省力。
选型建议很简单：图省事用官方，图好看看 Richasy，想折腾、想学习就选 biliuwp。三者并不冲突，装两个轮换着用也很常见。
最后说两句
第三方客户端存在的意义，从来不只是"替代品"，而是给你多一个选择：在官方产品之外，你仍可以按自己的习惯去组织观看体验。biliuwp 虽然停止更新，但代码一直开源可读，作为 UWP 开发的入门样本和改造素材仍然值得一玩。
建议下一步这么做：先按本文路径把项目跑起来，花十分钟逛一遍 Pages/ 目录，然后挑一个你常用的功能页，试着改改布局或换套配色。第一次成功的编译，就是你和这个项目最好的开始。
【免费下载链接】biliuwpbilibili uwp项目地址: https://gitcode.com/gh_mirrors/bi/biliuwp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考