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