Конфигурационный файл

Информация о конфигурационном файле:

расположение: /etc/xdg/plasmamobilerc
владелец: root
группа: root
права доступа: rw-r--r--

Параметр WaydroidDefaultOrientation, задающий ориентацию по умолчанию для всех приложений Waydroid, располагается в секции APPORIENTATION конфигурационного файла:

[APPORIENTATION]
WaydroidDefaultOrientation=4

Ориентация окна приложения Waydroid задается в этой же секции строкой, содержащей имя приложения и код ориентации экрана:

[APPORIENTATION]
WaydroidDefaultOrientation=4
waydroid.com.devinterestdev.streamshow=4
waydroid.com.android.calculator2=1
waydroid.org.lineageos.etar=2
waydroid.org.lineageos.jelly=3
fly-camera=1
fly-gallery=2
chromium=4

Соответствие кода ориентации экрана, положения устройства и ориентации экрана приложения приведено в таблице.

Код	Положение устройства	Ориентация экрана приложения
1	Верхняя грань устройства направлена вверх	Приложение запустится в ландшафтной ориентации
2	Верхняя грань устройства направлена вниз	Приложение запустится в портретной ориентации (справа налево)
3	Левая грань устройства направлена вверх	Приложение запустится в зеркальной портретной ориентации (слева направо)
4	Правая грань устройства направлена вверх	Приложение запустится в зеркальной ландшафтной ориентации (вверх ногами)

Варианты ориентации экрана показаны в следующем порядке:

верхняя грань сверху;
верхняя грань снизу;
левая грань сверху;
правая грань сверху;
лицевая сторона сверху;
лицевая сторона снизу.

ВНИМАНИЕ! Значения, не входящие в приведенную таблицу, считаются невалидными и могут привести к неправильной работе функционала.

ВНИМАНИЕ! Данное описание применимо для устройства Lenovo IdeaPad URU. Для устройств, у которых аппаратно задан другой левый верхний угол, ориентация может быть инвертирована.

Скрипты

Установка ориентации экрана приложения осуществляется с участием следующих скриптов:

/usr/sbin/astra-mobile-waydroid-watcher-session — скрипт, управляющий функционалом на уровне сессии по сигналам dbus.

Требования: права user.

Принцип работы: ожидает получения команды на перезапуск сессии Waydroid с последующим запуском приложения;

/usr/sbin/astra-mobile-waydroid-watcher — скрипт, управляющий функционалом на уровне системы по сигналам dbus.

Требования: права root.

Принцип работы: ожидает получения команды на изменение конфигураций разрешения окна Waydroid.

Алгоритм работы

Алгоритм определения ориентации экрана приложения:

пользователь запускает приложение;
производится проверка необходимости смены ориентации экрана для запускаемого приложения;
если приложение существует в конфигурационном файле, ему задаётся указанная ориентация экрана, автоматический поворот экрана блокируется;
производится проверка что приложение является приложением Waydroid;
если это приложение Waydroid то в случаи различного разрешения в конфигурационном файле (/var/lib/waydroid/waydroid_base.prop) и необходимого для приложения, производится изменение разрешения в конфигурационном файле и перезапуск сессии Waydroid с повторным запуском указанного приложения (по средствам отправки dbus сигналов скриптам astra-mobile-waydroid-watcher и astra-mobile-waydroid-watcher-session).

При переключении между приложениями также происходит проверка необходимости смены ориентации экрана для активируемого приложения:

если приложение существует в конфигурационном файле, ему задаётся указанная ориентация экрана, автоматический поворот экрана блокируется;
если приложения не существует, то ориентация будет установлена в соответствии с текущими показаниями сенсора, а флаг автоматического поворота будет возвращён к предыдущему состоянию до блокировки.

Методика тестирования

Для обычных системных приложений

Порядок тестирования:

В конфигурационный файл /etc/xdg/plasmamobilerc в секцию APPORIENTATION (возможно её придётся создать) требуется добавить имя приложения в системе и указать ориентацию из таблицы.
Запустить приложение, проверить что ориентация изменилась, а автоповорот был заблокирован;
Произвести переключение между несколькими приложениям в разных ориентациях (в том числе не заблокированных).

Ожидаемый результат:

ориентация фиксированных приложений должна автоматически применяться при запуске и при переключении на него с помощью комбинации клавиш <Alt+Tab> или графического интерфейса;
автоматический поворот для фиксированных приложений должен блокироваться и восстанавливать прежнее значение при переключении на не фиксированные приложения.

Для приложений Waydroid