ASLauncher

ASLauncher - менеджер рабочего стола AgavaSCADA.

ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.

ASLauncher реализует следующие функции:

• автозапуск AgavaSCADA;
• замена рабочего стола Windows;
• программный сторожевой таймер.

2 Замена рабочего стола Windows

Заменив стандартную оболочку Windows на ASLauncher, для пользователя блокируются все штатные функции Windows - запуск установленных программ, все операции с файлами на дисках и т. д. ASLauncher предоставляет пользователю собственный рабочий стол со следующими функциями:

• Запуск среды исполнения.
• Перезагрузка и выключение АРМ.
• Просмотр текущей даты и времени.
• Запуск штатной оболочки Windows.

3 Конфигурирование ASLauncher, версия 1.2

Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.

[General]
ProcessFile="G:/workspace/AgavaScada/bin-win/rtu.exe"
RestartProcessAt=00:02
Wallpaper="./GNOME-Shell.jpg"

4 Конфигурирование ASLauncher, версия 1.5

4.1 Описание конфигурационного файла и его параметров

Данный раздел описывает структуру и назначение конфигурационного файла формата .ini, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов.

4.1.1 Общая структура .ini файла

Файл .ini состоит из разделов и пар ключ-значение:

• Разделы: обозначаются названием в квадратных скобках, например, [General].
• Ключи и значения: пары вида Ключ=Значение, определяющие настройку.

Образец общей структуры .ini файла:

[SectionName]
Key1=Value1
Key2=Value2

4.1.2 Описание ключей и значений .ini файла

Секция [General] содержит основные настройки приложения.

• Ключ Wallpaper
  • Описание: Задает путь к изображению, используемому в качестве обоев рабочего стола.
  • Тип: Файл.
  • Формат: Абсолютный путь.
  • Пример значения: Wallpaper=/home/user/Images/wallpaper.png

• Ключ ProcessErrorLogFile
  • Описание: Указывает путь к файлу, в который записываются ошибки основного процесса приложения.
  • Тип: Файл.
  • Формат: Абсолютный путь.
  • Пример значения: ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log

• Ключ ProcessStandardLogFile
  • Описание: Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения.
  • Тип: Файл.
  • Формат: Абсолютный путь.
  • Пример значения: ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log

• Ключ ASLauncherLogsDir
  • Описание: Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола.
  • Тип: Директория.
  • Формат: Абсолютный путь.
  • Пример значения: ASLauncherLogsDir=/var/log/aslauncher
• Ключ DesktopEntriesDir
  • Описание: Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате .desktop. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска.
  • Тип: Директория.
  • Формат: Абсолютный путь.
  • Пример значения: DesktopEntriesDir=/usr/share/aslauncher

4.1.3 Примечание

• Все описанные параметры, за исключением Wallpaper, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр Wallpaper является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом.

• Убедитесь, что все указанные пути существуют и имеют соответствующие права доступа для чтения и записи.

• Используйте абсолютные пути для обеспечения корректной работы независимо от текущей директории.

4.2 Документация для .desktop файлов

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

4.2.1 Общая структура .desktop файла

Файл состоит из секции [Desktop Entry] и набора ключей с соответствующими значениями. Пример файла:

[Desktop Entry]
Name=MyApp
Process=/usr/bin/myapp
Arguments=--mode test
Icon=/usr/share/icons/myapp.png
Type=Application
AutoLaunch=true
AutoRestartOnCrash=true
User=myuser
PasswordPrompt=false

4.2.2 Примечания

• Для некоторых ключей используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: true, True или 1 — для истинных значений и false, False или 0 — для ложных.
• Ключи и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа.
• Убедитесь, что все указанные пути существуют и доступны для чтения/запуска.
• Если иконка не отображается, значит, по меньшей мере одна пара ключ-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там.

4.2.3 Описание ключей и значений .desktop файла

1. Ключ Name
   • Описание: Отображаемое имя приложения в меню или панели запуска.
   • Формат: Строка.
   • Пример значения: Name=MyApp
2. Ключ Process
   • Описание: Путь к исполняемому файлу приложения.
   • Формат: Абсолютный путь.
   • Пример значения: Process=/usr/bin/myapp
3. Ключ Arguments
   • Описание: Аргументы командной строки, передаваемые приложению при запуске.
   • Формат: Строка с аргументами, разделенными пробелами.
   • Пример значения: Arguments=--mode test --verbose
4. Ключ Icon
   • Описание: Путь к файлу иконки или имя иконки из темы значков.
   • Формат: Абсолютный путь.
   • Пример значения: Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png
5. Ключ Type
   • Описание: Тип записи, определяет, как система будет обрабатывать файл.
   • Возможные значения: Application — исполняемое приложение.
   • Пример значения: Type=Application
6. Ключ AutoLaunch
   • Описание: Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему.
   • Формат: Логическое значение.
   • [Если] Параметр отсутствует: Значение по умолчанию — false
   • Пример значения: AutoLaunch=true
7. Ключ AutoRestartOnCrash
   • Описание: Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения.
   • Формат: Логическое значение.
   • [Если] Параметр отсутствует: Значение по умолчанию — false
   • Пример значения: AutoRestartOnCrash=true
8. Ключ User
   • Описание: Имя пользователя, от имени которого должно запускаться приложение.
   • Формат: Строка.
   • [Если] Параметр отсутствует: Приложение запускается из-под пользователя root.
   • Пример значения: User=john_doe
9. Ключ PasswordPrompt
   • Описание: Указывает, необходимо ли запрашивать пароль при запуске приложения.
   • Формат: Имя пользователя, пароль аккаунта которого должен быть введён.
   • Возможные значения: default — будет запрошен пароль 123asd890.
   • [Если] Параметр отсутствует: Пароль не запрашивается.
   • Пример значения: PasswordPrompt=default