ASLauncher: различия между версиями
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 1: | Строка 1: | ||
ASLauncher - менеджер рабочего стола AgavaSCADA. | ASLauncher - менеджер рабочего стола AgavaSCADA. | ||
− | ASLauncher предназначен для использования совместно со средой исполнения и реализует следующие функции: | + | ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows. |
+ | |||
+ | ASLauncher реализует следующие функции: | ||
* автозапуск AgavaSCADA; | * автозапуск AgavaSCADA; | ||
Строка 10: | Строка 12: | ||
== Замена рабочего стола Windows == | == Замена рабочего стола Windows == | ||
+ | Заменив стандартную оболочку Windows на ASLauncher, для пользователя блокируются все штатные функции Windows - запуск установленных программ, все операции с файлами на дисках и т. д. ASLauncher предоставляет пользователю собственный рабочий стол со следующими функциями: | ||
+ | |||
+ | * Запуск среды исполнения. | ||
+ | * Перезагрузка и выключение АРМ. | ||
+ | * Просмотр текущей даты и времени. | ||
+ | * Запуск штатной оболочки Windows. | ||
+ | |||
+ | == Конфигурирование ASLauncher, версия 1.2 == | ||
+ | Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA. | ||
+ | [General] | ||
+ | ProcessFile="G:/workspace/AgavaScada/bin-win/rtu.exe" | ||
+ | RestartProcessAt=00:02 | ||
+ | Wallpaper="./GNOME-Shell.jpg" | ||
+ | |||
+ | == Конфигурирование ASLauncher, версия 1.5 == | ||
+ | |||
+ | === Описание конфигурационного файла и его параметров === | ||
+ | Данный раздел описывает структуру и назначение конфигурационного файла формата <code>.ini</code>, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов. | ||
+ | |||
+ | ==== Общая структура <code>.ini</code> файла ==== | ||
+ | Файл <code>.ini</code> состоит из разделов и пар ключ-значение: | ||
+ | |||
+ | * '''Разделы''': обозначаются названием в квадратных скобках, например, <code>[General]</code>. | ||
+ | * '''Ключи и значения''': пары вида <code>Ключ=Значение</code>, определяющие настройку. | ||
+ | |||
+ | Образец общей структуры <code>.ini</code> файла: | ||
+ | [SectionName] | ||
+ | Key1=Value1 | ||
+ | Key2=Value2 | ||
+ | |||
+ | ==== Описание ключей и значений <code>.ini</code> файла ==== | ||
+ | Секция <code>[General]</code> содержит основные настройки приложения. | ||
+ | |||
+ | * Ключ <code>Wallpaper</code> | ||
+ | ** '''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола. | ||
+ | ** '''Тип''': Файл. | ||
+ | ** '''Формат''': Абсолютный путь. | ||
+ | ** '''Пример значения''': <code>Wallpaper=/home/user/Images/wallpaper.png</code> | ||
+ | |||
+ | * Ключ <code>ProcessErrorLogFile</code> | ||
+ | ** '''Описание''': Указывает путь к файлу, в который записываются ошибки основного процесса приложения. | ||
+ | ** '''Тип''': Файл. | ||
+ | ** '''Формат''': Абсолютный путь. | ||
+ | ** '''Пример значения''': <code>ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log</code> | ||
+ | |||
+ | * Ключ <code>ProcessStandardLogFile</code> | ||
+ | ** '''Описание''': Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения. | ||
+ | ** '''Тип''': Файл. | ||
+ | ** '''Формат''': Абсолютный путь. | ||
+ | ** '''Пример значения''': <code>ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log</code> | ||
+ | |||
+ | * Ключ <code>ASLauncherLogsDir</code> | ||
+ | ** '''Описание''': Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола. | ||
+ | ** '''Тип''': Директория. | ||
+ | ** '''Формат''': Абсолютный путь. | ||
+ | ** '''Пример значения''': <code>ASLauncherLogsDir=/var/log/aslauncher</code> | ||
+ | * Ключ <code>DesktopEntriesDir</code> | ||
+ | ** '''Описание''': Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате <code>.desktop</code>. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска. | ||
+ | ** '''Тип''': Директория. | ||
+ | ** '''Формат''': Абсолютный путь. | ||
+ | ** '''Пример значения''': <code>DesktopEntriesDir=/usr/share/aslauncher</code> | ||
+ | |||
+ | ==== Примечание ==== | ||
+ | |||
+ | * Все описанные параметры, за исключением <code>Wallpaper</code>, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр <code>Wallpaper</code> является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом. | ||
+ | |||
+ | * Убедитесь, что все указанные пути существуют и имеют соответствующие права доступа для чтения и записи. | ||
+ | |||
+ | * Используйте абсолютные пути для обеспечения корректной работы независимо от текущей директории. | ||
+ | |||
+ | === Документация для <code>.desktop</code> файлов === | ||
+ | Файлы с расширением <code>.desktop</code> используются для описания приложений и их поведения в системе. Они позволяют интегрировать приложения в графическую оболочку, определяя, как они отображаются на рабочем столе, какие иконки используют, и как запускаются. | ||
+ | |||
+ | ==== Общая структура <code>.desktop</code> файла ==== | ||
+ | Файл состоит из секции <code>[Desktop Entry]</code> и набора ключей с соответствующими значениями. Пример файла: | ||
+ | [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 | ||
+ | |||
+ | ==== Примечания ==== | ||
+ | |||
+ | * Для некоторых ключей используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: <code>true</code>, <code>True</code> или <code>1</code> — для истинных значений и <code>false</code>, <code>False</code> или <code>0</code> — для ложных. | ||
+ | * Ключи и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа. | ||
+ | * Убедитесь, что все указанные пути существуют и доступны для чтения/запуска. | ||
+ | * Если иконка не отображается, значит, по меньшей мере одна пара ключ-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там. | ||
+ | |||
+ | ==== Описание ключей и значений <code>.desktop</code> файла ==== | ||
+ | |||
+ | # Ключ <code>Name</code> | ||
+ | #* '''Описание''': Отображаемое имя приложения в меню или панели запуска. | ||
+ | #* '''Формат''': Строка. | ||
+ | #* '''Пример значения''': <code>Name=MyApp</code> | ||
+ | # Ключ <code>Process</code> | ||
+ | #* '''Описание''': Путь к исполняемому файлу приложения. | ||
+ | #* '''Формат''': Абсолютный путь. | ||
+ | #* '''Пример значения''': <code>Process=/usr/bin/myapp</code> | ||
+ | # Ключ <code>Arguments</code> | ||
+ | #* '''Описание''': Аргументы командной строки, передаваемые приложению при запуске. | ||
+ | #* '''Формат''': Строка с аргументами, разделенными пробелами. | ||
+ | #* '''Пример значения''': <code>Arguments=--mode test --verbose</code> | ||
+ | # Ключ <code>Icon</code> | ||
+ | #* '''Описание''': Путь к файлу иконки или имя иконки из темы значков. | ||
+ | #* '''Формат''': Абсолютный путь. | ||
+ | #* '''Пример значения''': <code>Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png</code> | ||
+ | # Ключ <code>Type</code> | ||
+ | #* '''Описание''': Тип записи, определяет, как система будет обрабатывать файл. | ||
+ | #* '''Возможные значения''': <code>Application</code> — исполняемое приложение. | ||
+ | #* '''Пример значения''': <code>Type=Application</code> | ||
+ | # Ключ <code>AutoLaunch</code> | ||
+ | #* '''Описание''': Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему. | ||
+ | #* '''Формат''': Логическое значение. | ||
+ | #* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code> | ||
+ | #* '''Пример значения''': <code>AutoLaunch=true</code> | ||
+ | # Ключ <code>AutoRestartOnCrash</code> | ||
+ | #* '''Описание''': Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения. | ||
+ | #* '''Формат''': Логическое значение. | ||
+ | #* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code> | ||
+ | #* '''Пример значения''': <code>AutoRestartOnCrash=true</code> | ||
+ | # Ключ <code>User</code> | ||
+ | #* '''Описание''': Имя пользователя, от имени которого должно запускаться приложение. | ||
+ | #* '''Формат''': Строка. | ||
+ | #* '''[Если] Параметр отсутствует''': Приложение запускается из-под пользователя <code>root</code>. | ||
+ | #* '''Пример значения''': <code>User=john_doe</code> | ||
+ | # Ключ <code>PasswordPrompt</code> | ||
+ | #* '''Описание''': Указывает, необходимо ли запрашивать пароль при запуске приложения. | ||
+ | #* '''Формат''': Имя пользователя, пароль аккаунта которого должен быть введён. | ||
+ | #* '''Возможные значения''': <code>default</code> — будет запрошен пароль <code>123asd890</code>. | ||
+ | #* '''[Если] Параметр отсутствует:''' Пароль не запрашивается. | ||
+ | #* '''Пример значения''': <code>PasswordPrompt=default</code> | ||
− | + | [[Категория:AgavaSCADA/AgavaPLC]] |
Текущая версия на 16:48, 7 октября 2024
ASLauncher - менеджер рабочего стола AgavaSCADA.
ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.
ASLauncher реализует следующие функции:
- автозапуск AgavaSCADA;
- замена рабочего стола Windows;
- программный сторожевой таймер.
1 Автозапуск AgavaSCADA
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
- Описание: Задает директорию, в которой хранятся файлы записей рабочих столов (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