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

Материал из docs.kb-agava.ru
Перейти к навигации Перейти к поиску
 
(не показаны 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>
  
== Конфигурирование ASLauncher ==
+
[[Категория: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

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