Документация
ОС Аврора 5.1.0

Market API

Market API предназначен для работы с магазином приложений.

Он предоставляет возможность пользователям устанавливать или удалять приложения на устройствах. Позволяет разработчикам интегрировать свои приложения или сервисы с магазином, обеспечивая новые функциональные возможности и повышая удобство использования для пользователей.

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

Market API представляет собой набор инструментов для программного взаимодействия с системным менеджером пакетов и магазином приложений ОС Аврора. Он позволяет сторонним приложениям, корпоративным MDM-решениям или альтернативным магазинам приложений управлять жизненным циклом программного обеспечения на устройстве: устанавливать, обновлять и удалять пакеты, а также отслеживать статус этих операций.

Использование данного API обеспечивает безопасную и стандартизированную интеграцию с системными службами. Это избавляет разработчика от необходимости напрямую взаимодействовать с низкоуровневыми утилитами управления пакетами (такими как zypper или rpm).

Доверенные источники

Концепция доверенных источников является расширением концепции подписи клиента в ОС Аврора 4 версии и предоставляет пользователям ОС Аврора 5 возможность обеспечения установки на мобильное устройство только приложений, подписанных источниками, которым они доверяют.

Подпись источника представляет собой криптографическое подтверждение подлинности разработчика или издателя пакета. Это механизм защиты цепочки поставок, который гарантирует, что приложение не было модифицировано злоумышленниками после его создания и действительно исходит от заявленного автора. Включение этой функции на уровне устройства позволяет администраторам или пользователям блокировать установку непроверенного программного обеспечения, существенно снижая риски заражения вредоносным ПО.

Рекомендация. Все приложения, добавляемые в маркет, должны иметь подпись источника. В будущем наличие подписи источника может стать обязательным.

Публичный API

Публичный API предоставляется в виде D-Bus интерфейса.

Интерфейс D-Bus Назначение
Market Управление приложениями (установка/удаление)

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

D-Bus (Desktop Bus) — это система межпроцессного взаимодействия (IPC), используемая в ОС Аврора для обмена сообщениями между различными приложениями и системными службами. Прямое использование D-Bus-интерфейса рекомендуется в тех случаях, когда приложение написано на языке, не имеющем нативной C++-библиотеки (например, Python, Rust или shell-скрипты), либо когда требуется минимизировать зависимости проекта.

Публичная библиотека

ОС Аврора предоставляет разработчикам сторонних пакетных менеджеров библиотеку Market для управления пакетами в системе:

  • Установка/удаление пакетов.
  • Отслеживание статуса созданных операций установки/удаления.
  • Получение информации об установленных пакетах.

Для использования библиотеки необходимо разрешение Market.

Подключение библиотеки

Для интеграции библиотеки в проект C++ необходимо указать зависимости в системе сборки.

Для CMake:

find_package(PkgConfig REQUIRED)
pkg_check_modules(MARKET_API REQUIRED market-api)

target_link_libraries(${PROJECT_NAME}
    PRIVATE
        ${MARKET_API_LIBRARIES}
)
target_include_directories(${PROJECT_NAME}
    PRIVATE
        ${MARKET_API_INCLUDE_DIRS}
)

Для qmake:

CONFIG += link_pkgconfig
PKGCONFIG += market-api

Пространства имён и классы:

  • Common — общие типы данных и перечисления, используемые во всей библиотеке.
  • Market — основное пространство имён, содержащее классы и функции для работы с демоном market.
  • Market::PackageFilters — готовые к использованию фильтры для поиска и сортировки пакетов по различным критериям.
  • Market::DaemonConnection — основной класс для установления и управления соединением с фоновым демоном market.
  • Market::EventSubscription — класс для управления подпиской на асинхронные события демона (например, завершение установки или изменение статуса).
  • Market::OperationRequest — класс, инкапсулирующий запрос на создание операции (установки или удаления).
  • Market::OperationRequest::Builder — класс-конструктор (Builder), упрощающий пошаговое создание сложных запросов на операции.
  • Market::Operation — класс для получения детальной информации о ходе выполнения конкретной операции.
  • Market::Package — класс, предоставляющий метаданные и информацию о конкретном установленном или доступном пакете.
  • Market::Result — универсальная обертка, возвращающая либо успешный результат типа T, либо объект ошибки, что упрощает обработку сбоев.
  • Market::Result< void > — специализация класса Result, которая может содержать ошибку и указывает на то, что операция завершилась, но без возврата полезного значения.

Мы используем cookies для персонализации сайта и его более удобного использования. Вы можете запретить cookies в настройках браузера.

Пожалуйста ознакомьтесь с политикой использования файлов cookies.