Go to file
luzhiping 3728f5a304 update info 2022-08-22 16:45:19 +08:00
LICENSES Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
debian update info 2022-08-22 16:45:19 +08:00
example Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
po Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
src Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
.git-blame-ignore-revs Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
.gitignore Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
.gitlab-ci.yml Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
.kde-ci.yml Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
CMakeLists.txt Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
Messages.sh Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
README Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00
README.md Import Upstream version 21.12.3 2022-05-24 22:48:50 +08:00

README.md

KAccounts Integration

Integration library and QML module for Accounts-SSO and SignOn-SSO

Introduction

KAccounts Integration provides a way to share accounts data such as login tokens and general user information (like usernames and such) between various applications.

The KAccounts library is a KDE Frameworks style abstraction layer on top of the Accounts-SSO and SignOnD libraries, which uses a combination of models and jobs to expose the functionality of those.

The kaccounts QML plugin exposes that functionality directly to Qt Quick based applications, and using the classes only requires importing the module like so:

import org.kde.kaccounts 1.2 as KAccounts

The main functionality in the library can be accessed through the various classes below, and the accounts manager can be accessed directly through KAccounts::accountsManager(). The other central classes are:

Models

  • AccountsModel
  • ServicesModel
  • ProvidersModel

Jobs

  • AccountServiceToggleJob
  • ChangeAccountDisplayNameJob
  • CreateAccountJob
  • RemoveAccountJob

KDE Control Module

The Online Accounts KCM is the main user-visible point for KAccounts, and can be accessed either through System Settings, or directly from any system menu which allows launching of KCMs directly (including KRunner). It is built using the Qt Quick module mentioned above, and uses Kirigami as its base.

Provider and Service files

If you plan on creating new providers and services, you will need to register those with the accounts manager. Two cmake macros are provided to assist you in the creation and installation of these files, and further assists in translation integration for them:

  • kaccounts_add_provider
  • kaccounts_add_service