[**RU**](README.ru.md) | [EN](README.md)

---

# Open with

Description.
The фзздшсфешщ demonstrates the use of the "Open With" mechanism to open a file. To do this, the application uses 
the intent mechanism. The application implements files viewer and opening files using other applications.

You can read more about Contacts API [here](https://developer.auroraos.ru/doc/software_development/reference/runtime_manager#intent).

<a name="Table-of-contents"></a>
## Table of Contents

1. [Table of Contents](#Table-of-contents)
2. [Compatibility](#Compatibility)
3. [Features of build](#Features-of-build)
4. [Branch info](#Branch-info)
5. [Install and Run](#Install-and-Run)
6. [Screenshots](#Screenshots)
7. [Project Structure](#Project-structure)
8. [Terms of Use and Participation in Development](#Terms-of-use-and-participation-in-development)

<a name="Compatibility"></a>
## Compatibility

The project is compatible with Aurora 5th OS versions and upper.

<a name="Features-of-build"></a>
## Features of build

This example being built using the Aurora SDK in the usual way:
[Documentation](https://developer.auroraos.ru/doc/sdk/app_development/work/create/examples#build).

<a name="Branch-info"></a>
## Branch info

[Branches](https://developer.auroraos.ru/doc/software_development/examples#branches)

<a name="Install-and-Run"></a>
## Install and Run

The project being installed and run in the usual way using the Aurora SDK:
[Documentation](https://developer.auroraos.ru/doc/sdk/app_development/work/build).

When you first launch the application, you must grant it all the required permissions.

<a name="Screenshots"></a>
## Screenshots

![screenshots](screenshots/screenshots.png)

<a name="Project-structure"></a>
## Project structure

The project has a standard structure of an application based on C++ and QML for Aurora OS.

* **[CMakeLists.txt](CMakeLists.txt)** file describes the project structure for the qmake build system.
* **[icons](icons)** directory contains the application icons for different screen resolutions.
* **[qml](qml)** directory contains the QML source code and the UI resources.
  * **[cover](qml/cover)** directory contains the application cover implementations.
  * **[pages](qml/pages)** directory contains the application pages.
  * **[OpenWith.qml](qml/OpenWith.qml)** file provides the application window implementation.
* **[rpm](rpm)** directory contains the rpm-package build settings.
  * **[ru.auroraos.OpenWith.spec](rpm/ru.auroraos.OpenWith.spec)** file is used by rpmbuild tool.
* **[src](src)** directory contains the C++ source code.
  * **[intentsinvoker.h](src/intentsinvoker.h)** & **[intentsinvoker.cpp](src/intentsinvoker.cpp)** 
  files implement the class for sending intents.
  * **[mimetypemanager.h](src/mimetypemanager.h)** implements a class for gettig files mime-type.
  * **[main.cpp](src/main.cpp)** file is the application entry point.
* **[translations](translations)** directory contains the UI translation files.
* **[ru.auroraos.OpenWith.desktop](ru.auroraos.OpenWith.desktop)** file defines the display and parameters 
for launching the application.

<a name="Terms-of-use-and-participation-in-development"></a>
## Terms of Use and Participation in Development

The source code of the project is provided under [the license](LICENSE.BSD-3-CLAUSE.md),
which allows it to be used in third-party applications.

[Contributor License Agreement](https://gitlab.com/omprussia/wiki/-/wikis/CLA) 
The [contributor agreement](CONTRIBUTING.md) documents the rights granted by contributors
of the Open Mobile Platform.

Information about the contributors is specified in the [AUTHORS](AUTHORS.md) file.

[Code of conduct](CODE_OF_CONDUCT.md) is a current set of rules of the Open Mobile
Platform which informs you how we expect the members of the community will interact
while contributing and communicating.