MAN page from OpenSuSE kservice-5.76.0-bp153.2.2.1.x86_64.rpm

\FBDESKTOPTOJSON\FR

Section: KDE Frameworks: KService (8)
Updated: 2014-04-02
Index

NAME

desktoptojson - Converts a .desktop file to a .json file.

SYNOPSIS

desktoptojson --input DESKTOP-FILE --output JSON-FILE
desktoptojson {--version | --help}

DESCRIPTION

The KService framework uses information contained in.desktopfiles to locate services, including plugins for Qt5-based applications and libraries. The Qt5 plugin system, however, usesJSONdata embedded in the plugin itself.desktoptojsonallows the information contained in a.desktopfile to also be used as the embedded data for a Qt5 plugin by converting the.desktopfile entries intoJSONdata.

The generatedJSONdata is aJSONobject that maps the entries from the[Desktop Entry]group of the.desktopfile. Any other groups are ignored. Most entries are just converted toJSONstrings, but certain entries (such asHiddenandX-KDE-PluginInfo-EnabledByDefault) are known to be boolean values and converted as such, and similarly some (such asX-KDE-ServiceTypesandX-KDE-PluginInfo-Depends) are always converted to arrays of strings.

OPTIONS

--input DESKTOP-FILE

: The.desktopfile to convert.

--output JSON-FILE

: The file to write the generatedJSONdata to.

--help

: Show a brief help text.

--version

: Show version information.

USAGE

Most users of this utility will use theCMakemacrokservice_desktop_to_jsonas part of the process of building a plugin.

add_library(myplugin MODULE ${myplugin_SRCS})kservice_desktop_to_json(myplugin myplugin.desktop)

This will produce theJSONfilemyplugin.json, which can be referenced from theK_PLUGIN_FACTORY_WITH_JSONorQ_PLUGIN_METADATAmacros.

BUGS

Please usem[blue]KDE's bugtrackerm[][1]to report bugs.

AUTHORS

Scarlett Clark <scarlettAATTscarlettgatelyclark.com>

: Wrote the original documentation.

Alex Merry <alexmerryAATTkde.org>

: Edited the documentation.

NOTES

1.

KDE's bugtracker

: https://bugs.kde.org

This document was created byman2html,using the manual pages.