From 01f7fe8f78e72dcda6000c70fd8b1d5bfefc46f2 Mon Sep 17 00:00:00 2001 From: Henri Chain Date: Fri, 10 Jul 2020 13:12:25 +0000 Subject: Add ecm_generate_dbus_service_file Summary: It serves as a replacement for `kdbusaddons_generate_dbus_service_file`. An application can be a DBus-activated service just fine without using KDBusAddons. Moreover, this new module uses named arguments for future-proofing, and adds support for specifying a `SystemdService`. It also cleans up the confusion on what the "path" is about: Rather than requiring to specify executable and path separately, we just extract the executable file name on Windows, if necessary. Usage: ``` ecm_generate_dbus_service_file(NAME org.kde.kded5 EXECUTABLE ${KDE_INSTALL_FULL_BINDIR}/kded5 SYSTEMD_SERVICE plasma-kded) ``` Test Plan: * Was able to generate a kded service file * Was able to generate a kded service file with `SystemdUnit` * Verified that it moaned when executable wasn't an absolute path * Untested on Windwos Reviewers: #frameworks, davidedmundson, kossebau, kfunk, habacker Subscribers: kde-frameworks-devel, kde-buildsystem Tags: #frameworks, #build_system Differential Revision: https://phabricator.kde.org/D29051 --- modules/ECMGenerateDBusServiceFile.cmake | 120 +++++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 modules/ECMGenerateDBusServiceFile.cmake (limited to 'modules/ECMGenerateDBusServiceFile.cmake') diff --git a/modules/ECMGenerateDBusServiceFile.cmake b/modules/ECMGenerateDBusServiceFile.cmake new file mode 100644 index 00000000..f8b36d4f --- /dev/null +++ b/modules/ECMGenerateDBusServiceFile.cmake @@ -0,0 +1,120 @@ +#.rst: +# ECMGenerateDBusServiceFile +# --------------------------- +# +# This module provides the ``ecm_generate_dbus_service_file`` function for +# generating and installing a D-Bus service file. +# +# :: +# +# ecm_generate_dbus_service_file( +# NAME +# EXECUTABLE +# [SYSTEMD_SERVICE ] +# DESTINATION +# ) +# +# A D-Bus service file ``.service`` will be generated and installed +# in the relevant D-Bus config location. +# +# ```` must be an absolute path to the installed service executable. When using it with +# ``KDEInstallDirs`` it needs to be the ``_FULL_`` variant of the path variable. +# +# Note: On Windows, the macro will only use the file name part of ```` since D-Bus +# service executables are to be installed in the same directory as the D-Bus daemon. +# +# Optionally, a ```` can be specified to launch the corresponding +# systemd service instead of the ```` if the D-Bus daemon is started by systemd. +# +# Example usage: +# +# .. code-block:: cmake +# +# ecm_generate_dbus_service_file( +# NAME org.kde.kded5 +# EXECUTABLE ${KDE_INSTALL_FULL_BINDIR}/kded5 +# DESTINATION ${KDE_INSTALL_DBUSSERVICEDIR} +# ) +# +# .. code-block:: cmake +# +# ecm_generate_dbus_service_file( +# NAME org.kde.kded5 +# EXECUTABLE ${KDE_INSTALL_FULL_BINDIR}/kded5 +# SYSTEMD_SERVICE plasma-kded.service +# DESTINATION ${KDE_INSTALL_DBUSSERVICEDIR} +# ) +# +# Since 5.73.0. + +#============================================================================= +# Copyright 2020 Kai Uwe Broulik +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions +# are met: +# +# 1. Redistributions of source code must retain the copyright +# notice, this list of conditions and the following disclaimer. +# 2. Redistributions in binary form must reproduce the copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# 3. The name of the author may not be used to endorse or promote products +# derived from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +include(CMakeParseArguments) + +function(ecm_generate_dbus_service_file) + set(options) + set(oneValueArgs EXECUTABLE NAME SYSTEMD_SERVICE DESTINATION) + set(multiValueArgs) + cmake_parse_arguments(ARG "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN}) + + if(ARG_UNPARSED_ARGUMENTS) + message(FATAL_ERROR "Unexpected arguments to ecm_generate_dbus_service_file: ${ARG_UNPARSED_ARGUMENTS}") + endif() + if(NOT ARG_NAME) + message(FATAL_ERROR "Missing NAME argument for ecm_generate_dbus_service_file") + endif() + if(NOT ARG_EXECUTABLE) + message(FATAL_ERROR "Missing EXECUTABLE argument for ecm_generate_dbus_service_file") + endif() + if(NOT ARG_DESTINATION) + message(FATAL_ERROR "Missing DESTINATION argument for ecm_generate_dbus_service_file") + endif() + + if(WIN32) + get_filename_component(_exec "${ARG_EXECUTABLE}" NAME) + else() + if (NOT IS_ABSOLUTE ${ARG_EXECUTABLE}) + message(FATAL_ERROR "EXECUTABLE must be an absolute path in ecm_generate_dbus_service_file") + else() + set(_exec ${ARG_EXECUTABLE}) + endif() + endif() + + set(_service_file ${CMAKE_CURRENT_BINARY_DIR}/${ARG_NAME}.service) + + file(WRITE ${_service_file} + "[D-BUS Service] +Name=${ARG_NAME} +Exec=${_exec} +") + + if (ARG_SYSTEMD_SERVICE) + file(APPEND ${_service_file} "SystemdService=${ARG_SYSTEMD_SERVICE}\n") + endif() + + install(FILES ${_service_file} DESTINATION ${ARG_DESTINATION}) +endfunction() -- cgit v1.2.1