RU | EN

WebAppServer

Описание

Проект предоставляет приложение-пример по использованию браузера.

Приложение для демонcтрации запуска локального статического веб-сервера и отображения его контента с помощью WebView (Chromium) на ОС Аврора.

Приложение позволяет:

• Просмотривать веб-содержимое,
• Просматривать собственные статические веб-файлы.

Приложение WebAppServer использует утилиту командной строки static-web-server версии 2.38.0 для запуска сервера для отображения статических веб-файлов. Утилита static-web-server распространяется под лицензиями MIT license и Apache License (Vesion 2.0). Веб-файлы для статического веб-сервера должны располагаться в каталоге ~/Documents/WebAppServer/ на устройстве.

Шаблон приложения сгенерирован с помощью утилиты WebAppGenerator.

Содержание

1. Совместимость
2. Особенности сборки
3. Информация о ветках
4. Установка и запуск
5. Скриншоты
6. Варианты использования
7. Известные ошибки и ограничения
8. Структура проекта
9. Правила использования и участие в разработке

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

Приложение корректно работает, начиная с 5.1.3.45 версии ОС Авроры

Особенности сборки

Данный пример-приложение собирается с помощью Аврора SDK: Документация

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

Ветки

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

Проект собирается обычным образом с помощью Аврора SDK: Документация.

Скриншоты

Варианты использования

Просмотр веб-содержимого

• Для просмотра веб-содержимого необходимо выполнить запуск приложения.
• При старте приложения будет запущен статический веб-сервер и отображено его содержимое в WebView на базе Chromium.
• По умолчанию будет отображена страница с сообщением о том, как настроить отображение собственных статических веб-файлов.

Настройка отображения собственных веб-файлов

• Для отображения собственных статических веб-файлов необходимо поместить их в каталог ~/Documents/WebAppServer/ на устройстве и перезапустить приложение.
• При старте приложения каталог ~/Documents/WebAppServer/ будет создан, если он не был создан ранее.

Известные ошибки и ограничения

В проекте не обнаружены известные ошибки.

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

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

• Файл CMakeLists.txt описывает структуру проекта для системы сборки CMake.
• Каталог icons содержит иконки приложения для поддерживаемых разрешений экрана.
• Каталог initial-site содержит HTML-файл с веб-страницей по умолчанию для демонстрации.
• Каталог libexec содержит бинарные файлы static-web-server для трёх доступных архитектур: aarch64, armv7l и x86_64.
• Каталог qml содержит исходный код на QML и ресурсы интерфейса пользователя.
  • Каталог cover содержит реализации обложек приложения.
  • Каталог icons содержит дополнительные иконки интерфейса пользователя.
  • Каталог pages содержит страницы приложения.
  • Файл ru.auroraos.WebAppServer.qml предоставляет реализацию окна приложения.
• Каталог rpm содержит настройки сборки rpm-пакета.
  • Файл ru.auroraos.WebAppServer.spec используется инструментом rpmbuild.
• Каталог src содержит исходный код на C++.
  • Файл main.cpp является точкой входа в приложение.
• Каталог translations содержит файлы перевода интерфейса пользователя.
• Файл ru.auroraos.WebAppServer.desktop определяет отображение и параметры запуска приложения.

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

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

Лицензионное соглашение с участником Соглашение участника регламентирует права, предоставляемые участниками компании «Открытая Мобильная Платформа».

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

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