ASLauncher

Материал из docs.kb-agava.ru
Перейти к навигации Перейти к поиску

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

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

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

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

1 Автозапуск AgavaSCADA

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

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

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

3 Конфигурирование ASLauncher

Все настройки 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