3728f5a304 | ||
---|---|---|
LICENSES | ||
debian | ||
example | ||
po | ||
src | ||
.git-blame-ignore-revs | ||
.gitignore | ||
.gitlab-ci.yml | ||
.kde-ci.yml | ||
CMakeLists.txt | ||
Messages.sh | ||
README | ||
README.md |
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