TVBoxOSC 自动打包怎么用：不编译也能拿到新版 APK 的完整指南

TVBoxOSC 自动打包怎么用：不编译也能拿到新版 APK 的完整指南

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

TVBoxOSC 自动打包能把上游 TVBoxOS 的新提交变成开箱即用的 APK，你不用装 JDK、不用配 Gradle，就能把最新电视盒子版本装到盒子上。下面按场景、前置条件、操作步骤和功能拆解带你走一遍，最后附一张常见问题排查表。

先对号入座：这 3 种情况你用得上

想体验上游 TVBoxOS 刚合入的新功能，但你不想装 Android Studio，更不想自己折腾构建环境。

需要某个具体时间点打出来的版本，而 Releases 页里命名太乱，你分不清哪个包对应哪次提交。

自己编译时 crosswalk 依赖总是拉不下来，构建中途反复挂掉。

前置条件：动手前确认这 4 项

• 上游仓库（q215613905/TVBoxOS 或 takagen99/Box）的 main 分支有已提交、可编译的代码；
• 你有能访问 GitHub Releases 页面 的账号，或项目已配置 Bot Token、Chat ID 这两个 secrets；
• 盒子系统与 APK 架构匹配，装错架构装不上；
• 想手动触发构建，你要有仓库的 Actions 操作权限，没有的话只能等每日定时构建。

从触发到装盒：4 步拿到新版 APK

第 1 步：在 Actions 里手动触发。打开仓库的 Actions 面板，选中 Test workflow，点 Run workflow 手动触发。这里有两个选项：rebuild 勾上表示忽略"上游没新提交"的检查直接重打；donotpublish 勾上表示只构建、不发布新版本。默认都不勾，走正常流程。

第 2 步：下载对应版本的 APK。构建跑完后到 Releases 页，找名字形如TVBox_作者_时间戳.apk的附件。时间戳就是版本号，例如 20250901-0815 代表上游提交时间 2025 年 9 月 1 日 08:15 左右。

第 3 步：装盒并核对版本。把 APK 拷进盒子安装（签名一致，直接覆盖升级就行）。打开应用"关于"页，会显示构建时间戳——和文件名对上，说明装对了。

第 4 步：确认构建真的成功。回 Actions 页看这次运行状态是不是绿色，徽章也会同步刷新。想确认当前版本对应哪次提交，看 README.md Credits 里的Updated:后那串 commit hash。

自动打包到底做了什么

版本号：你不用再猜装的是哪一版。构建脚本取上游最新提交的提交时间，格式化成20250901-0815这类时间戳，同时写进versionName和"关于"页。你装完看一眼关于页，就能和文件名、README 里的 commit 记录三方对上。

取包：APK 和源码包一起给你。每次构建除了 APK，还会把该次提交的源码压缩成sourceCode-短commit号.tar.xz放进同一个 Release。想核对代码、看具体改了啥，直接下这个包。

签名：统一签名，装旧不冲突。流水线里内置了固定签名文件 TVBoxOSC.jks，所有版本用同一把钥匙签。所以覆盖安装旧版本不会报"签名不一致"，不用先卸载。

推送：新包出来 Telegram 频道会同步。构建成功后脚本会把 APK 发到频道。这一步依赖 secrets 里的 BOT_TOKEN 和 CHAT_ID，没配置就静默跳过，不影响 APK 本身发布。

清理：老构建不会堆满仓库。超过 14 天的 Actions 运行记录和附件会被自动删除，只留最近的若干条，Releases 页始终能拿到可用的新包。

装不上、找不到包时先查这 5 处

下一步与延伸阅读

等下一次每日构建跑完，或自己手动触发一次，然后去 Releases 页把最新 APK 装进盒子试试。

• 上游对应关系：README.md（Credits 部分标注两个上游仓库及最新 commit）
• 构建全流程源码：.github/workflows/test.yml
• 通知脚本：.github/scripts/upload.py

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC