自定义 ROM 上 NewPipe 不工作 - LineageOS、GrapheneOS、HarmonyOS 兼容提示

NewPipe 在定制 ROM 上的表现

NewPipe 因为不依赖 Google Play Services，理论上应该在所有 Android 设备上都能跑。但实际使用中，某些定制 ROM 会引入兼容性问题。

LineageOS 等 AOSP 基础 ROM

LineageOS 是最干净的 AOSP ROM 之一，NewPipe 在上面几乎不会遇到问题。偶发情况：

• DocumentsUI 缺失：极少数 LineageOS 构建移除了 DocumentsUI，导致 SAF 文件选择器无法弹出。从 F-Droid 安装 Simple File Manager 解决。
• 后台限制：LineageOS 的权限管理默认对后台较严格。如果后台播放偶尔中断，到电池优化里把 NewPipe 设为"不限制"。

GrapheneOS

GrapheneOS 是以隐私和安全为核心的定制 ROM，NewPipe 在上面表现很好——实际上 NewPipe 是 GrapheneOS 用户最常用的 YouTube 替代方案之一。

需要注意的设置：

• 存储权限：GrapheneOS 的权限管理比较严格，NewPipe 需要手动授予存储访问权限
• 网络权限：确认 NewPipe 的网络访问权限已打开
• 背景访问：GrapheneOS 可能阻止后台访问网络。设置 → 应用 → NewPipe → 网络 → 允许后台网络访问

HarmonyOS（鸿蒙）

NewPipe 可以在 HarmonyOS 的 Android 兼容层上运行。注意点：

• HarmonyOS 对后台进程管理较激进，后台播放可能被中断。到"应用启动管理"里把 NewPipe 设为手动管理，允许自启动和后台活动。
• HarmonyOS 的权限管理是弹窗式的，NewPipe 首次使用下载功能时必须手动确认"始终允许"存储访问。

MIUI / HyperOS

小米自家系统对后台管理非常严格：

• 到"自启动管理"里把 NewPipe 加入自启动白名单
• 到"电池和性能"里把 NewPipe 的耗电限制设为"无限制"
• 在最近任务里把 NewPipe 下拉锁定（防止被清理）

OneUI（三星）

三星 OneUI 对后台的处理与 MIUI 类似：

• 设置 → 应用 → NewPipe → 电池 → 允许后台活动
• 如果"存储"权限被自动回收（OneUI 有定期回收权限的机制），手动重新授予

通用排查步骤

在任何 ROM 上遇到 NewPipe 功能异常时，按以下顺序排查：

1. 检查 NewPipe 版本是否最新
2. 清除 NewPipe 缓存（不清除数据）
3. 确认所有必需权限已授予
4. 检查 ROM 的电池优化和后台限制
5. 重新安装 NewPipe（先备份数据）