Aurora OS Share API Example
Приложение демонстрирует использование Share API для ОС Аврора.
Для реализации примера использовалась документация на Share API.
Приложение позволяет как делиться файлами с другими приложениями, так и принимать их от других приложений. Поддерживаемые типы файлов: изображения и PDF-документы.
Главная страница приложения — список файлов файловой системы пользователя. Пользователь может перемещаться по каталогам и видеть изображения и PDF-документы, файлы других типов пользователю не показываются. Контекстное меню вызывается по долгому нажатию на файл в списке и содержит один пункт "Поделиться". Пункт "Поделиться" позволяет вызвать системный диалог выбора приложения или устройства, с которым можно поделиться данным файлом. Кроме того, приложение может принимать файлы и информацию о них от других приложений. Для тестирования этого необходимо вызвать меню "Поделиться" в стороннем приложении и выбрать "Aurora OS Share API Example" в списке доступных. В результате приложение "Aurora OS Share API Example" будет запущено, либо активировано, если оно уже было запущено, и откроется страница "Принятые файлы" с информацией о принятых файлах.
Для реализации функции "Поделиться" использовался компонент ShareAction,
его использование описано в файле MainPage.qml.
Для реализации приема файлов от сторонних приложений использовался компонент ShareProvider
и описание примера его реализации. Стоит обратить внимание на описание
файла ru.auroraos.ShareApi.desktop, а именно на поля X-Share-Methods, X-Maemo-Service, X-Maemo-Method, а также на описание
блоков [X-Share Method ...]. В функцию main() была добавлена регистрация DBus-службы приложения. Это необходимо для возможности активации приложения.
Компоненты ShareProvider объявляются в ApplicationWindow и описывают обработчик onTriggered.
Статус сборки:
- example -
- dev -
Условия использования и участия
Исходный код проекта предоставляется по лицензии, которая позволяет использовать его в сторонних приложениях.
Соглашение участника регламентирует права, предоставляемые участниками компании «Открытая Мобильная Платформа».
Информация об участниках указана в файле AUTHORS.
Кодекс поведения — это действующий набор правил компании «Открытая Мобильная Платформа», который информирует об ожиданиях по взаимодействию между членами сообщества при общении и работе над проектами.
Структура проекта
Проект имеет стандартную структуру приложения на базе C++ и QML для ОС Аврора.
- Файл ru.auroraos.ShareApi.pro описывает структуру проекта для системы сборки qmake.
- Каталог icons содержит иконки приложения для поддерживаемых разрешений экрана.
- Каталог qml содержит исходный код на QML и ресурсы интерфейса пользователя.
- Каталог cover содержит реализации обложек приложения.
- Каталог icons содержит дополнительные иконки интерфейса пользователя.
- Каталог pages содержит страницы приложения.
- Файл ShareApi.qml предоставляет реализацию окна приложения.
- Каталог rpm содержит настройки сборки rpm-пакета.
- Файл ru.auroraos.ShareApi.spec используется инструментом rpmbuild.
- Каталог src содержит исходный код на C++.
- Файл main.cpp является точкой входа в приложение.
- Каталог translations содержит файлы перевода интерфейса пользователя.
- Файл ru.auroraos.ShareApi.desktop определяет отображение и параметры запуска приложения.
Совместимость
Проект совместим с актуальными версиями ОС Аврора.
Снимки экранов
