如何用desktoptojson转换KDE plasmoid的metadata配置文件

问题1：当前官方实际推荐的配置文件方案 #

• 面向2021年后发布的Plasma版本（对应KF5 5.83及以上，覆盖所有当前仍在支持期的Plasma发行版，包括Linux Mint搭载的Plasma环境），官方唯一推荐手动维护的配置文件为metadata.json，不需要手动编写维护metadata.desktop。
• 系统全局路径下的plasmoid同时存在两个配置文件，是发行版打包时为兼容5.83以前的老旧Plasma版本做的兼容处理，并非开发者手动维护两份文件：打包流程会自动从维护的源配置生成另一种格式的文件，保证新旧版本Plasma都能识别组件。
• 你看到的旧版Hello World教程属于Plasma 5早期的过时内容，新版开发文档中标注的「不推荐使用metadata.desktop」是当前生效的规范：仅保留metadata.json的plasmoid，在当前支持的Plasma版本中可以正常完成安装、加载、运行全流程，不会出现兼容性问题。

问题2：双文件同步的实现方式 #

如果你需要兼容5.83之前的老旧Plasma版本，确实需要同时提供两份配置文件，不要手动逐字段同步两个文件的内容，统一选定一个文件作为唯一维护源，通过工具自动生成另一份文件即可，不需要单独依赖存在问题的kdesrc-build脚本编译工具。
具体操作按开发场景选择：

• 采用CMake构建打包（官方推荐的标准打包方式）：直接调用KService组件提供的CMake宏完成自动转换，不需要单独安装命令行版desktoptojson，宏会自动调用框架内置的转换逻辑，核心配置示例如下：

# 引入KService组件依赖
find_package(KF5 REQUIRED COMPONENTS Service)
# 如果你以metadata.desktop为维护源，自动生成metadata.json
kservice_desktop_to_json(your_plasmoid_id metadata.desktop)
# 如果你以metadata.json为维护源，调用反向生成宏输出metadata.desktop即可
# 安装时将生成的两个配置文件一同放到plasmoid安装路径
install(FILES ${CMAKE_CURRENT_BINARY_DIR}/metadata.json metadata.desktop DESTINATION ${PLASMOID_INSTALL_DIR})

• 不使用构建工具、做轻量本地开发：不需要专门寻找desktoptojson工具，直接复制系统自带同类型plasmoid的metadata.desktop模板，将名称、插件ID、描述、分类、版本号这些核心字段修改为和metadata.json一致即可。Plasma加载组件时不会对两个文件做逐字段的严格校验，只要核心字段匹配就可以正常运行，不需要追求完全内容一致。
• 补充：Debian/Ubuntu系（包括Linux Mint）如果确实需要使用独立的desktoptojson命令行工具，直接源内安装libkf5service-dev包即可，工具会随开发包默认安装，不需要从源码编译。

内容的提问来源于stack exchange，提问作者Peter T.