如何在10分钟内把NuvioTV装上电视并跑起来:完整安装教程(Play商店与APK双方案)
【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV
NuvioTV 是一款免费开源的 Android TV 媒体播放器应用,自带剧集海报、评分、字幕和播放进度同步功能。这篇 NuvioTV 安装教程将带你用 10 分钟完成电视端部署:方案一从 Play 商店一键安装,适合绝大多数用户;方案二侧载 APK,解锁插件、应用内更新等完整功能;方案三从源码构建,适合想体验最新版本的进阶用户。跟着下面的 NuvioTV 电视安装步骤走,零基础也能一次成功。
30秒确认你的电视满足 NuvioTV 安装条件
开始安装前,花半分钟对照 app/build.gradle.kts 中的配置确认设备环境:
| 条件 | 要求 | 说明 |
|---|---|---|
| 系统 | Android TV / Android 7.0(API 24)及以上 | minSdk = 24 |
| 网络 | 能正常访问互联网 | 播放和拉取元数据都需要联网 |
| 安装来源 | Play 商店 或 允许未知来源 | APK 方案需要提前开启 |
💡 当前版本为
1.1.0-beta.2(见 app/build.gradle.kts),beta 表示功能仍在快速迭代,日常使用完全没问题。
方案一:Play 商店安装 NuvioTV(最快,约2分钟)
这是 NuvioTV 安装的最简单路径,无需任何技术基础:
- 在电视或机顶盒上打开Google Play 商店
- 搜索NuvioTV,认准 Nuvio 开发者
- 点击安装,等待进度条走完
- 桌面会出现 Nuvio 图标,按遥控器的 OK 键即可启动
✅优点:自动更新、无签名问题、全程不超过 2 分钟。
⚠️注意:Play 商店版本走的是playstore构建变体(见 app/build.gradle.kts),包名为com.nuvio.app,其中插件系统、应用内更新等功能默认关闭。如果你不需要插件,这个版本就是最省心的选择。
方案二:APK 侧载安装 NuvioTV 完整版(约5分钟)
想要插件、应用内更新、片场预告片等全部能力,请下载full变体的 APK(包名com.nuvio.tv,功能开关见 app/build.gradle.kts):
第 1 步:获取 APK
从项目官方 Releases 页面下载最新 release APK。构建时开启了多 ABI 拆分并生成 universal 包(见 app/build.gradle.kts),直接下载通用包即可,无需按架构挑选。
第 2 步:允许未知来源安装
进入电视的设置 → 安全(或"安全与受限设置")→ 允许安装未知应用,对文件管理器或下载器开启权限。
第 3 步:传输并安装
把 APK 传到电视的存储中(U盘、SMB/FTP 共享或直接网络下载均可),用文件管理器打开并确认安装。
第 4 步:打开使用
安装完成后打开应用,完整版还会自动检查新版本更新(基于 GitHub Releases 的应用内更新器,见 app/build.gradle.kts 与 app/src/main/java/com/nuvio/tv/updater/ 目录)。
方案三:从源码构建 NuvioTV(进阶,10分钟)
想编译出"今天最新"的版本?项目用 Kotlin + Jetpack Compose + TV Material 3 + Media3 构建,完整说明见 README.md。
- 准备环境:Android Studio、JDK 11、Android SDK(compileSdk 36)
- 克隆仓库:
git clone https://gitcode.com/gh_mirrors/nu/NuvioTV cd NuvioTV- 执行构建(产物为 full 变体的 debug 包):
./gradlew :app:assembleFullDebug- 安装到电视(USB 调试 + adb):
adb install app/build/outputs/apk/full/debug/app-full-debug.apk🔧可选配置:把 local.example.properties 复制为local.properties,按需填入 TMDB API Key、Trakt 等配置;杜比视界 DV7 原生解码模块默认开启(DOVI_NATIVE_ENABLED=true),预编译库位于 DV7/libdovi/ 目录。
首次启动:5分钟完成开机设置
安装完成只是开始,按下面的 NuvioTV 电视设置步骤走一遍,体验会完整很多:
- 登录账号:应用支持扫码/设备码登录,电视端显示二维码,用手机浏览器确认即可同步观看进度、收藏与列表
- 添加内容源:完整版在插件管理中添加插件(Addon),社区插件可直接一键安装(操作参考 release_test_cases.csv 中 "Addon Management" 部分)
- 播放偏好:在设置中配置音轨、字幕、跳过片头、画质等,全部选项可在播放界面快速切换
- 验证核心功能:播放、暂停、10秒快进快退、倍速、续播——这些正是 release_test_cases.csv 里"Player - Core Playback"章节的验收项,你可以照着走一遍确认一切正常
常见问题排查:NuvioTV 装不上或打不开怎么办
| 问题 | 解决方法 |
|---|---|
| 提示"未允许安装" | 回到设置,给对应安装来源开启"允许未知应用"权限 |
| 安装成功但打开闪退 | 确认系统为 Android TV 7.0+;用 Play 版替换试试以排除包冲突 |
| 播放源加载失败 | 检查电视网络;full 版需先安装并启用对应插件 |
| 找不到更新入口 | Play 商店版本关闭了应用内更新,请到商店更新;APK 版会自动提示 |
| 想换应用图标 | 设置里支持多种图标主题(见 app/src/main/java/com/nuvio/tv/launcher/) |
安装完成:接下来去哪里玩
- 📄 完整功能与构建说明:README.md
- 📚 精简模式(Essential Mode)文档:docs/essential-mode.md
- 📝 全部功能验收用例清单:release_test_cases.csv
- 🛠 想参与贡献?先读 CONTRIBUTING.md 了解 PR 规范
恭喜!此时你的电视上应该已经跑起了一个海报齐全、进度同步的 NuvioTV 媒体库。如果安装过程中遇到其他问题,欢迎在项目的 Issues 区反馈(记得附上版本号和设备信息)。
【免费下载链接】NuvioTVOfficial Nuvio Android TV Repository项目地址: https://gitcode.com/gh_mirrors/nu/NuvioTV
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考