OpenPHT进阶开发指南动手编写自定义皮肤与插件的完整流程【免费下载链接】OpenPHTOpenPHT is a community driven fork of Plex Home Theater项目地址: https://gitcode.com/gh_mirrors/op/OpenPHTOpenPHT 是一个社区驱动的 Plex Home Theater 分支fork专为家庭媒体中心爱好者打造。本教程将带你走通OpenPHT 自定义皮肤与插件开发的完整流程从搭建开发环境到理解皮肤目录结构、修改界面布局与配色再到用 Python 编写第一个插件如天气插件最终完成调试与发布。无需深厚编程基础跟着步骤动手即可上手 认识 OpenPHT为什么适合二次开发OpenPHT 继承了 Plex Home Theater 成熟的媒体播放与界面框架同时保留了 XBMC 时代完善的插件Addon机制这意味着皮肤系统开放所有界面窗口都是 XML 文件改一个文件就能改变界面插件生态丰富天气、元数据抓取、可视化、屏幕保护等都以插件形式存在代码即文档仓库结构清晰addons/目录集中存放所有皮肤与插件xbmc/目录是核心引擎源码。仓库中与开发最相关的目录内置皮肤与插件addons/核心引擎源码xbmc/Plex 客户端增强模块plex/皮肤结构定义XML Schemaaddons/xbmc.gui/skin.xsd插件脚本规范定义addons/xbmc.python/script.xsd开发环境准备5 分钟搭建本地工作区一键获取源码如本地没有仓库可执行git clone https://gitcode.com/gh_mirrors/op/OpenPHT核心依赖CMake、C 编译器GCC/Clang、Python 2.7插件运行时、依赖库仓库lib/目录下已内置 ffmpeg、freetype 等大部分第三方库。构建时建议参考 README-BUILD-PLEX.md两个关键选项CMake 选项推荐值说明COMPRESS_TEXTURESoff开发阶段关闭纹理压缩可大幅加快编译速度CREATE_BUNDLEoff开发构建不需要生成签名发布包 小贴士纯改皮肤/写插件时甚至可以先不编译内核直接替换addons/下对应目录再启动即可看到效果。动手编写自定义皮肤先看懂目录结构OpenPHT 内置了两套完整皮肤是学习皮肤开发的最佳范本Confluence经典 XBMC 默认皮肤位于addons/skin.confluence/OpenPHT 皮肤Plex 风格位于addons/skin.plex/皮肤目录结构清单以 Confluence 为例打开 addons/skin.confluence/addon.xml可以看到一个皮肤的核心声明addon idskin.confluence version2.1.5 nameConfluence extension pointxbmc.gui.skin defaultthemenametextures.xbt res width1280 height720 aspect16:9 defaulttrue folder720p/ /extension /addon几个关键点id皮肤唯一标识新建皮肤时改成自己的名字extension pointxbmc.gui.skin声明这是一个皮肤插件并指定纹理包文件名textures.xbtres声明皮肤支持的分辨率所有窗口 XML 放在folder指定的目录这里是720p/。各目录职责一目了然addons/skin.confluence/720p/ —— 所有窗口与对话框的 XML 布局如 Home.xml主页、Settings.xml设置页media/—— 皮肤用到的全部图片素材fonts/—— 字体定义Font.xml在 720p 目录下colors/—— 全局配色见 addons/skin.confluence/colors/defaults.xmllanguage/—— 多语言翻译文件.po格式sounds/—— 界面音效3 个快速上手修改技巧① 换背景、改配色最简单替换media/下的背景图或直接编辑colors/defaults.xml中的色值。官方皮肤也内置了多张背景图可替换参考例如 addons/skin.confluence/backgrounds/tv.jpg② 调整窗口布局核心技能以主页 Home.xml 为例每个控件都是一个control节点通过posx/posy定位、width/height定尺寸、visible控制显示条件。想删掉主页左上角 Logo找到对应的texturexbmc-logo.png/texture控件删除即可。常用标签image/label/button/list/group基础控件include复用公共片段如CommonBackground公共背景animation淡入淡出等动画效果③ 支持多语言在language/下按语言建目录放入langinfo.xmlstrings.po参考现成示例 language/Spanish/。编写自定义插件以天气插件为例插件比皮肤更代码向但 OpenPHT 自带了现成的 Python 插件范例——Weather Underground 天气插件结构极简非常适合拆解学习插件最小结构2 个文件即可运行weather.myaddon/ ├── addon.xml # 插件元信息与扩展点声明 ├── default.py # 插件主入口Python └── resources/ # 库文件与资源打开 addons/weather.wunderground/addon.xml核心内容addon idweather.wunderground nameWeather Underground version1.0.9 requires import addonxbmc.python version2.1.0/ /requires extension pointxbmc.python.weather librarydefault.py/ /addon要点requires声明依赖天气插件需要xbmc.python运行环境extension pointxbmc.python.weather声明插件类型天气源入口文件是default.py其他常见扩展点还有xbmc.python.script脚本插件、xbmc.metadata.*元数据抓取等id决定插件在系统中的注册名。主程序 default.py 的开头展示了标准套路引入xbmc、xbmcgui、xbmcaddon、xbmcvfs四个核心模块再通过xbmcaddon.Addon()读取插件自身的 id、路径、版本号最后加载resources/lib/下的业务代码。插件对外输出的字段清单Current、Day、Daily、Hourly 等标签完整列在 addons/weather.wunderground/README.txt写自定义天气源时照此输出即可与皮肤无缝对接。 开发路径速查想模仿写插件直接复制addons/weather.wunderground/改 id 和代码想研究元数据抓取参考addons/metadata.common.themoviedb.org/。测试与发布让皮肤和插件跑起来本地调试三步走将你的皮肤/插件目录放入 OpenPHT 的用户数据addons/目录开发时可直接用仓库内目录启动 OpenPHT进入设置 → 界面切换皮肤或设置 → 插件安装/启用插件查看xbmc.log日志定位 XML 解析错误或 Python 异常——皮肤 XML 写错标签时日志里会有明确的行号提示。发布分享OpenPHT 内置了插件仓库机制可参考 addons/repository.xbmc.org/addon.xml 与 addons/repository.openpht.tv/addon.xml 的结构把自己的插件仓库添加进去用户即可通过安装插件界面一键安装你的作品 常见问题 FAQQ1改了 XML 没生效确认文件放对了分辨率目录720p/且标签拼写与层级正确对照 addons/xbmc.gui/skin.xsd 检查结构然后重启 OpenPHT。Q2新建插件不显示检查addon.xml的id是否符合命名规范如weather.myaddon、script.myaddon且version为三段式版本号。Q3皮肤图片模糊或变形按 1280x720 基准设计素材放进media/后需重新打包纹理编译时开启COMPRESS_TEXTURESon或保持 PNG 原图引用。Q4Python 插件报错 ModuleNotFoundError把第三方库放进插件的resources/lib/目录并在default.py开头追加到sys.path参考天气插件的写法。写在最后OpenPHT 的皮肤与插件开发门槛比想象中低皮肤改的是看得见的 XML插件写的是标准化的 Python。建议的学习路线是——先改一张背景图 → 再调整一个窗口布局 → 最后复制天气插件改出自己的第一个脚本插件。仓库中addons/目录下的几十个现成插件都是最好的老师动手改一改你的第一个 OpenPHT 作品很快就诞生了 ✨核心资料索引皮肤范例addons/skin.confluence/addon.xml、addons/skin.plex/addon.xml插件范例addons/weather.wunderground/addon.xml、addons/weather.wunderground/default.py构建指南README-BUILD-PLEX.md结构规范addons/xbmc.gui/skin.xsd、addons/xbmc.python/script.xsd【免费下载链接】OpenPHTOpenPHT is a community driven fork of Plex Home Theater项目地址: https://gitcode.com/gh_mirrors/op/OpenPHT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考