ASLauncher: различия между версиями

Текущая версия на 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

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

@@ Строка 1: / Строка 1: @@
 ASLauncher - менеджер рабочего стола AgavaSCADA.
-ASLauncher предназначен для использования совместно со средой исполнения и реализует следующие функции:
+ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.
-автозапуск AgavaSCADA
-программный сторожевой таймер
+ASLauncher реализует следующие функции:
-блокировка рабочего стола Windows
+* автозапуск AgavaSCADA;
+* замена рабочего стола Windows;
+* программный сторожевой таймер.
+== Автозапуск AgavaSCADA ==
+== Замена рабочего стола 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]]

ASLauncher: различия между версиями

Текущая версия на 16:48, 7 октября 2024

Содержание

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

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

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

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

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

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

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

4.1.3 Примечание

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

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

4.2.2 Примечания

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

Навигация

Поиск

ASLauncher: различия между версиями

Текущая версия на 16:48, 7 октября 2024

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

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

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

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

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

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

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

4.1.3 Примечание

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

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

4.2.2 Примечания

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

Навигация

Поиск

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

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

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

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

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