Класс TrustedSources

(Sailfish::Mdm::TrustedSources)

Класс TrustedSources позволяет управлять списком доверенных источников на устройстве и управлять разрешением на установку пакетов без источников. Подробнее…

Подключение:

#include <mdm-trustedsources.h>

• Список всех членов класса, включая унаследованные

Публичные типы

• enum Result { Success, InternalError, UnexistingSourceError, DatabaseError }

Публичные функции

• TrustedSources(QObject *parent = nullptr)
• Result addSource(const QString &sourceKeyID, const QString &sourceSubject)
• Result bindPackageToSource(const QString &packageID, const QString &sourceKeyID)
• Result getSourceList(QList<TrustedSource> &sourceList)
• Result getSourceSignatureRequired(bool &required)
• Result removeSource(const QString &sourceKeyID)
• Result setSourceSignatureRequired(bool required)

Сигналы

• void sourceAdded(const TrustedSource &source)
• void sourceChanged(const TrustedSource &source)
• void sourceRemoved(const TrustedSource &source)
• void sourceSignatureRequiredChanged(bool required)

Подробное описание

Класс TrustedSources позволяет управлять списком доверенных источников на устройстве и управлять разрешением на установку пакетов без источников.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

Пример использования:

 #include <QDebug>
 #include <mdm-trustedsources.h>

 using namespace Sailfish::Mdm;

 void example()
 {
     TrustedSources ts;

     auto dumpTrustedSource = [](const TrustedSource &source) {
         qDebug() << source.keyID << source.subject;
     };

     auto onSourceRequiredChanged = [](bool required) {
         qDebug() << "Packages without a source signature are" << (required ? "disallowed" : "allowed");
     };

     QObject::connect(&ts, &TrustedSources::sourceAdded,   dumpTrustedSource);
     QObject::connect(&ts, &TrustedSources::sourceRemoved, dumpTrustedSource);
     QObject::connect(&ts, &TrustedSources::sourceChanged, dumpTrustedSource);
     QObject::connect(&ts, &TrustedSources::sourceSignatureRequiredChanged, onSourceRequiredChanged);

     QList<TrustedSource> sources;

     if (ts.getSourceList(sources) != TrustedSources::Result::Success)
         qDebug() << "Error occurred";

     if (ts.addSource("<source-key-id>", "<source-subject>") != TrustedSources::Result::Success)
         qDebug() << "Error occurred";

     if (ts.removeSource("<source-key-id>") != TrustedSources::Result::Success)
         qDebug() << "Error occurred";

     if (ts.bindPackageToSource("<package-id>", "<source-key-id>") != TrustedSources::Result::Success)
         qDebug() << "Error occurred";

     if (ts.setSourceSignatureRequired(false) != TrustedSources::Result::Success)
         qDebug() << "Error occurred";
 }

Описание типов-членов

enum TrustedSources::Result

Описывает результат операции над доверенными источниками.

Константа	Значение	Описание
Sailfish::Mdm::TrustedSources::Success	0	Действие выполнено успешно
Sailfish::Mdm::TrustedSources::InternalError	1	При выполнении действия возникла внутренняя ошибка API
Sailfish::Mdm::TrustedSources::UnexistingSourceError	2	Ошибка, вызванная операцией над несуществующим источником.
Sailfish::Mdm::TrustedSources::DatabaseError	3	Внутренняя ошибка, возникшая при работе с базой данных доверенных источников.

Описание функций-членов

TrustedSources::TrustedSources(QObject *parent = nullptr)

По умолчанию создаёт экземпляр TrustedSources.

Result TrustedSources::addSource(const QString &sourceKeyID, const QString &sourceSubject)

Добавляет источник с указанными keyid и subject в список доверенных.

Result TrustedSources::bindPackageToSource(const QString &packageID, const QString &sourceKeyID)

Привязывает пакет с заданным packageID к доверенному источнику с заданным sourceKeyID.

Result TrustedSources::getSourceList(QList<TrustedSource> &sourceList)

Получает список доверенных источников и в случае успеха помещает его в выходной параметр sourceList.

Result TrustedSources::getSourceSignatureRequired(bool &required)

Проверяет, включено ли требование подписи источника, и в случае успеха помещает состояние требования в выходной параметр required.

Result TrustedSources::removeSource(const QString &sourceKeyID)

Удаляет источник с указанным sourceKeyID из списка доверенных.

Result TrustedSources::setSourceSignatureRequired(bool required)

Включает требование подписи источника, если параметр required имеет значение true, в противном случае отключает требование подписи источника.

[signal] void TrustedSources::sourceAdded(const TrustedSource &source)

Сигнал, испускаемый при добавлении нового источника в список доверенных источников.

[signal] void TrustedSources::sourceChanged(const TrustedSource &source)

Сигнал, испускаемый при изменении доверенного источника, например, при привязке пакета к источнику.

[signal] void TrustedSources::sourceRemoved(const TrustedSource &source)

Сигнал, испускаемый при удалении источника из списка доверенных.

[signal] void TrustedSources::sourceSignatureRequiredChanged(bool required)

Сигнал, испускаемый при изменении требования к подписи источника.