Go to file
openKylinBot 8fc3949969 changed debian/source/format to native 2022-05-19 09:48:31 +08:00
.videproject Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
LICENSES Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
autotests Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
contrib Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
debian changed debian/source/format to native 2022-05-19 09:48:31 +08:00
docs Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
src Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
tests Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
.git-blame-ignore-revs Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
.gitignore Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
.gitlab-ci.yml Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
.kde-ci.yml Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
CMakeLists.txt Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
KF5ActivitiesConfig.cmake.in Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
MAINTAINER Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
README Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
README.developers Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
README.md Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
README.packagers Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
TODO Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
logo.png Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
metainfo.yaml Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00
vim-extrarc Import Upstream version 5.92.0 2022-05-19 09:48:30 +08:00

README.md

KActivities

Core components for the KDE Activity concept

Introduction

When a user is interacting with a computer, there are three main areas of contextual information that may affect the behaviour of the system: who the user is, where they are, and what they are doing.

Activities deal with the last one. An activity might be "developing a KDE application", "studying 19th century art", "composing music" or "watching funny videos". Each of these activities may involve multiple applications, and a single application may be used in multiple activities (for example, most activities are likely to involve using a web browser, but different activities will probably involve different websites).

KActivities provides the infrastructure needed to manage a user's activities, allowing them to switch between tasks, and for applications to update their state to match the user's current activity. This includes a daemon, a library for interacting with that daemon, and plugins for integration with other frameworks.

Usage

Most applications that wish to be activity-aware will want to use KActivities::Consumer to keep track of the user's current activity, and KActivities::ResourceInstance to notify the activity manager of resources the user has accessed (this is not necessary for resources accessed via KIO, as a plugin is provided to do that automatically).

The other classes available in the API are primarily intended for use by the workspace to allow the user to view and manage available activities.