CleanFrame安装完全教程:从Tizen开发者模式到自签名证书,把你的电视主页装上去

原创2026-10-31 16:45:241,615 阅读

CleanFrame安装完全教程:从Tizen开发者模式到自签名证书,把你的电视主页装上去

CleanFrame 是一个为三星 The Frame 电视打造的个人主页界面:它把你的常用 App、一张照片和时间表整合在一屏,用电视遥控器即可操作。本教程带你完整走一遍安装流程——开启 Tizen 开发者模式、建立开发连接、创建自签名证书,直到把签好名的应用装进电视。整个流程约需 1–2 小时,中途电视会重启一两次,建议安排在空闲时段进行。

CleanFrame 电视主页界面预览:壁纸、时钟与 Dock 应用栏

一、CleanFrame 能带来什么?

装上之后,开机看到的就是这样一屏:

  • List / Dock 两种布局,可只显示图标、名称或两者兼有
  • 15 张内置壁纸,支持照片、浅色、深色三种背景
  • 一个简单的 12 小时时钟,玻璃材质与模糊效果预渲染好,电视只做轻量变换
  • 偏好(布局、壁纸、App 顺序)保存在电视本地

CleanFrame 内置的高清山景壁纸之一

⚠️ 先说清楚:这是作者在自己那台 The Frame 上打磨出来的方案,脚本路径和配置带有个人印记,换到别的型号需要你自行适配。原生 Home 按钮的接管属于高风险实验,可以只装应用、手动打开,完全跳过那一步。

二、准备工作清单

在动手前,把下面这些备齐:

物品 说明
三星电视 + 原装遥控器 参考机型为 The Frame,Tizen 9.0 / 32 位 ARM
同局域网的电脑 需要运行三星官方 TV SDK 工具
三星账号 用于申请开发证书,登录环节需本人操作
Node.js 22+ 和 Python 3.10+ 运行浏览器预览和打包脚本
一段可中断观看的时间 电视会重启、会安装应用

仓库克隆下来即可开工:

git clone https://gitcode.com/gh_mirrors/cl/CleanFrame
cd CleanFrame
npm ci

CleanFrame 内置海岸线壁纸,适合作为主页背景

三、第 1 步:先用浏览器预览界面

不用碰电视,先在电脑上看看效果:

npm run dev:public

然后打开 http://localhost:4795/home/,用方向键、回车和 Esc 键模拟遥控器导航。App 启动类操作在浏览器里只会提示"需要电视",这是正常的。这一步能帮你提前挑好布局、壁纸和字体,等装到电视上直接照抄设置。

界面源码在 app/main.js(布局、焦点、偏好管理)和 app/device.js(App 发现与 Tizen 调用),想改样式时改的就是这两个文件加 app/style.css。

四、第 2 步:开启电视开发者模式

  1. 电视上进入 Home → Apps → App Settings
  2. 用遥控器上的 123 键呼出数字键盘
  3. 依次输入 1、2、3、4、5,出现 Developer Mode 弹窗
  4. 打开 Developer Mode,在 Host PC IP 里填入你电脑的局域网 IP,保存
  5. 按提示重启电视,重进 Apps 确认开发者模式已开启

💡 最容易卡住的一步:App Settings 里没有文本输入框,必须用遥控器数字键盘,别在菜单里干等。

五、第 3 步:用 SDB 建立开发连接

按三星官方文档安装 TV SDK(含 TV Extension 和 Certificate Extension),然后用 SDB 连接电视 IP 的 26101 端口。连接成功后确认两件事:

  • 能力信息正确:Tizen 版本和 CPU 架构(参考机为 ARMv7 / 32 位)
  • 能读到已安装 App 列表(后面配置主页快捷方式要用)

连接被拒绝怎么办? 先核对双向 IP 和路由器隔离。参考机上就踩过这个坑:开发者模式开启后电视提示重启并不够,最后是在电源插座上断电 10 秒再通电才打通的。切记:只在内网操作,不要为了连电视去开路由器端口转发。

这一步的详细做法见 docs/agent-tv-setup-guide.md 的 Stage 3。

六、第 4 步:创建自签名证书(最容易劝退的一步)

Tizen 应用上电视前必须用三星签发的证书签名。流程如下:

  1. 用你的三星账号登录开发者证书流程
  2. 在 Tizen Studio 打开 Tools → Certificate Manager → + → Samsung → TV,起一个档案名
  3. 创建作者证书(Author),填写作者信息并完成三星登录
  4. 创建分发证书(Distributor),并通过连接设备选择器加入你电视的 DUID
  5. 确认档案里两张证书齐全,把作者证书备份到安全位置

关于 DUID:优先在证书工具里直接选中已连接的电视;手动输入的话,电视菜单在 Menu → Support → Contact Samsung → Unique Device ID,注意它不是机身序列号。

CleanFrame 深色夜景壁纸,适合夜间模式的主页背景

两张证书的分工:作者证书代表"你是谁签的名",分发证书代表"允许哪台电视装"。之后想更新应用,还得用同一张作者证书,所以务必备份好。

七、第 5 步:打包、签名并安装

  1. 打开 app/config.xml,确认 <tizen:application> 里的 package 和 id——这两个值就是你的应用身份,后续所有安装、启动、Home 配置都围绕它
  2. 用 SDK 打包器构建并签名,生成 .wgt 安装包。项目自带的打包脚本是 scripts/package.py(npm run package),但它依赖作者本机环境,你需要改成自己的 SDK 路径和证书档案
  3. 安装时用 SDK 的命令行流程,注意 Device Manager 里要打开 Permit to install applications,然后运行 npm run tv:install(对应 scripts/tv.py)
  4. 看到 install completed,再到已安装列表里确认应用存在,最后用 npm run tv:launch 启动

✅ 完成标志:电视的应用列表里出现你的 CleanFrame,遥控器打开后能看到壁纸 + Dock 界面。

两个已被验证的坑

  • 别手搓 XML 签名:参考机的电视直接拒绝了手工构造的 XML 签名,只有官方 SDK 打包器签出来的包能通过
  • sdb install 只传不装:参考机上该命令只完成了文件上传。项目方案是上传后单独调用三星的 vd_appinstall,并等待 install completed 回执

八、第 6 步:验证与(可选)接管 Home 按钮

基础验证:用遥控器把每个快捷方式都点一遍,至少测试两个 App 能正常打开;同时确认有一条回到三星 Smart Hub 的退路(参考机的原始 Home 组件是 com.samsung.tv.csfs)。到这里就可以收工了——日常手动打开 CleanFrame 即可使用。

可选实验:把物理 Home 按钮也指向 CleanFrame。这依赖未公开的原生设置接口,通过一个一次性 .NET 助手(源码在 scripts/native-home/)以 SDK 用户身份写入 Home 启动项。动手前必须先备份原始值,之后可用 restore 命令精确还原:

python3 scripts/native-home/run.py restore

固件升级随时可能让该方法失效,卸载应用或更改应用身份前务必先还原 Home。详细风险说明见 docs/tv-status.md。

九、参考资料速查

资料 用途
docs/agent-tv-setup-guide.md 分 8 个阶段的电视安装完整指南
docs/development.md 运行时结构、本地工具与签名说明
docs/testing.md 浏览器检查项和电视物理检查清单
app/config.xml 应用身份与应用配置
THIRD_PARTY_NOTICES.md 字体、照片、图标等第三方素材的授权说明

按顺序走完开发者模式、连接、证书、安装这四关,你的三星 The Frame 就有了一个安静、干净的专属主页。遇到与参考机表现不一致的地方,记得先核对固件版本和架构,再动手改配置。

登录后查看全文
CleanFrame