RU | EN

Push Sender Config

Описание приложения

Приложение устанавливает конфигурационный файл для Push Sender.
Проект демонстрирует создание пакетов для установки файлов для других приложений в вашей организации.

Статус сборки:

1. example -
2. dev -

Содержание

• Совместимость
• Информация о ветках
• Установка и запуск
• Структура проекта
• Правила использования и участие в разработке

Совместимость

Приложение корректно работает начиная с ОС Аврора 4.х.х и выше.

Информация о ветках

Версии приложения соответствуют соглашению об наименовании веток

Установка и запуск

Подготовка к работе

Поумолчанию путь для установки конфига /usr/share/common/ru.auroraos/PushSender/configuration.yaml. Путь для конфига устанавливается в .spec файле. В случае необходимости путь можно изменить на /usr/share/common/ru.auroraos/PushSendeConfig/configuration.yaml. Конкретный путь нужен, для приложения PushSender, чтобы загрузить конфигурационный файл. Пример конфигурационного файла 'app_server_configuration_example.yaml' можно посмотреть в директории ./config.

Важно

Следует учесть несколько важных аспектов при установке пакета:

1. Перед установкой PushSenderConfig на устройство(эмулятор) нужно убедиться, что по нужному пути уже нету установленного конфигурационного .yaml файла. Если его нет, что пакет ru.auroraos.PushSenderConfig установится, если есть переходим к шагу 2.
2. Есть два варианта:
   • Выбрать другой путь для установки, если он свободен. Таких путей может быть три: /usr/share/common/\${ORGNAME}, /usr/share/common/\${ORGNAME}/\${APPNAME}, /usr/share/common/\${ORGNAME}/\${CONFAPPNAME}.
   • Найти приложение, с которым был установлен конфигурационный файл. Только это приложение может обновлять конфигурационный файл.

Также нужно проверить работу push сервиса на устройстве. Его настройка описана в разделе Особенности.

Особенности

1. Версии Аврора ОС начиная с 5.0.1.

   • Наличие Аврора Центр на устройстве и его регистрацией

2. Версии Аврора ОС до 5.0.1.

   • Настройка push сервиса - задать address, port и выставить флаг для crlValidation в false. Для получения текущих настроек, можно воспользоваться командой devel-su gdbus call -y -d ru.omprussia.PushDaemon -o /ru/omprussia/PushDaemon -m ru.omprussia.PushDaemon.GetNetworkConfiguration. Для установки параметров: devel-su gdbus call -y -d ru.omprussia.PushDaemon -o /ru/omprussia/PushDaemon -m ru.omprussia.PushDaemon.SetNetworkConfiguration "{'address':<'push-server.ru'>, 'port':<8000>,'crlValidation':<false>"} (важно, чтобы хост был без протокола, например https://),
   • Перезапуск push-daemon с помощью команды devel-su systemctl restart push-daemon.

Особенности после установки

Приложение не является запускаемым и устанавливает только конфигурационный файл. Чтобы приложение не отображалось в списке приложений, нужно изменить .desktop файл:

[Desktop Entry]
# ...
NoDisplay=true
# ...

Структура проекта

Проект имеет стандартную структуру приложения на базе C++ и QML для ОС Аврора.

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

• Файл ru.auroraos.PushSenderConfig.pro описывает структуру проекта для системы сборки qmake.
• Каталог config содержит .yaml файл конфигурации.
• Каталог icons содержит иконки приложения для поддерживаемых разрешений экрана.
• Каталог qml содержит исходный код на QML и ресурсы интерфейса пользователя.
  • Файл ru.auroraos.PushSenderConfig.qml предоставляет реализацию окна приложения.
• Каталог rpm содержит настройки сборки rpm-пакета.
  • Файл ru.auroraos.PushSenderConfig.spec используется инструментом rpmbuild.
• Файл ru.auroraos.PushSenderConfig.desktop определяет отображение и параметры запуска приложения.

Правила использования и участие в разработке

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

Для участия в развитии проекта, пожалуйста, ознакомьтесь с соглашением участника. Если Вы планируете присылать свой исходный код для включения в состав проекта, Вам понадобится принять условия CLA.

Информация об участниках указана в файле AUTHORS.

Кодекс поведения — это действующий набор правил компании «Открытая Мобильная Платформа», который информирует об ожиданиях по взаимодействию между членами сообщества при общении и работе над проектами.