PiliPlus-Harmony

项目概述

PiliPlus Harmony 是把 BiliBili 第三方客户端 PiliPlus 移植到鸿蒙的 HAP 项目，面向手机、平板和折叠屏，优先适配华为 Mate XTS。它在原有播放器与业务功能之上增加了鸿蒙风格界面、原生 Dock 与加载、系统智感握姿、折叠适配等能力，并持续进行鸿蒙适配回归。

让 PiliPlus 在鸿蒙设备上拥有接近原生的观感与交互。

主要功能

• 视频浏览与播放：继承 PiliPlus 的播放器与业务功能，在鸿蒙上刷视频、看视频
• 鸿蒙风格界面：可选开启鸿蒙界面风格，配合原生 Dock 与原生加载动效
• 智感握姿：接入系统智感握姿能力，双手握持时播控自动居中
• 折叠屏适配：首页与播放栏按栏数自适应折叠形态，优先打磨 Mate XTS 体验
• 竖屏短视频：竖屏短视频信息流，在「其他设置」中手动启用
• 海外播放优化：海外播放模式同样在「其他设置」中手动启用
• 评论与播控共存：评论区保留播控与切页能力，刷视频不用来回跳转

适用人群

• 使用鸿蒙手机、平板的 B 站用户
• 华为 Mate XTS 等折叠屏用户
• 习惯 PiliPlus 想迁移鸿蒙的用户
• 愿意自行构建 HAP 的开发者

快速上手

1. 准备 Flutter OH 3.44.9+ohos-0.0.1-canary1 与 HarmonyOS SDK 26
2. 把 SDK 路径写入本机 .harmony-env.local（该文件不入库）
3. 运行 bash tool/harmony.sh doctor 检查环境
4. 运行 bash tool/harmony.sh release 构建 HAP 并安装到设备

核心优势

• 接近原生：原生 Dock、加载与系统握姿能力，观感不像套壳
• 多形态适配：手机、平板、折叠屏统一考虑，布局按栏数自适应
• 功能可选：鸿蒙界面、短视频、海外模式均可手动开关，不打扰默认体验

系统要求

项目	要求
操作系统	HarmonyOS（手机、平板、折叠屏）
构建环境	Flutter OH 3.44.9+ohos、HarmonyOS SDK 26
开源许可	GPL-3.0

注意事项

• 仓库只提供源码与构建方法，签名 HAP 不随源码上传，需本地构建
• 普通 Flutter 无法生成本项目的 HAP，必须使用 Flutter OH 版本
• 竖屏短视频与海外播放默认关闭，需在「其他设置」手动启用