ASLauncher

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

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

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

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

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

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

Для настройки автозапуска AgavaSCADA при включении компьютера можно воспользоваться штатными функциями операционной системы Windows, либо использовать утилиту ASLauncher, способную выполнять автозапуск AgavaSCADA и позволяющую заменить стандартную оболочку Windows.

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

Для настройки ASLauncher в качестве оболочки рабочего стола Windows 10 необходимо внести изменения в реестр операционной системы. Вызовем стандартную утилиту «Редактор реестра» с помощью сочетания клавиш Win + R, указав в качестве выполняемой программы regedit.

Внимание: Перед внесением изменений в реестр рекомендуется создать резервную копию.

2.1 Настройка автозапуска ASLauncher

  1. Чтобы ASLauncher автоматически запускался при старте операционной системы, необходимо добавить соответствующую запись в реестр. В «Редакторе реестра» перейдите в папку: Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run
  2. В правой части окна нажмите правой кнопкой мыши и выберите «Создать» → «Строковый параметр». Присвойте ему имя ASLauncher.
  3. Для созданного параметра необходимо указать путь до исполняемого файла. Нажмите правой кнопкой мыши на записи ASLauncher и выберите пункт «Изменить...». В поле «Значение» введите полный путь до исполняемого файла (например, C:\AgavaSCADA-1.2\bin\aslauncher.exe).

2.2 Установка ASLauncher в качестве стандартной оболочки рабочего стола

  1. Чтобы сделать ASLauncher оболочкой рабочего стола по умолчанию, в «Редакторе реестра» перейдите в папку: Компьютер\HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Winlogon
  2. Найдите параметр Shell (по умолчанию его значение — explorer.exe). Если такого параметра нет, создайте новый «Строковый параметр» с именем Shell.
  3. Нажмите дважды на параметре Shell и замените его значение на полный путь до исполняемого файла ASLauncher (например, C:\AgavaSCADA-1.2\bin\aslauncher.exe).

2.3 Отключение Error Reporting

  1. Для отключения отправки отчетов об ошибках, в «Редакторе реестра» перейдите к следующему разделу: Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting
  2. В правой части окна найдите параметр Disabled типа DWORD (32-бит). Если такого параметра нет, создайте его, нажав правой кнопкой мыши, выбрав «Создать» → «Параметр DWORD (32 бита)» и присвоив ему имя Disabled.
  3. Дважды щелкните по параметру Disabled и установите значение 1 в поле «Значение». Нажмите «ОК» для сохранения изменений.

2.4 Примечание

  1. После внесения всех изменений перезагрузите компьютер, чтобы они вступили в силу.
  2. В результате замены стандартной оболочки рабочего стола Windows на ASLauncher, для пользователя блокируются все штатные функции Windows — запуск установленных программ, все операции с файлами на дисках и т. д. ASLauncher предоставляет пользователю собственный рабочий стол со следующими функциями:
    • Запуск среды исполнения.
    • Перезагрузка и выключение АРМ.
    • Просмотр текущей даты и времени.
    • Запуск штатной оболочки Windows.

2.5 Отключение ASLauncher как оболочки рабочего стола Windows 10

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

Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.

Пример содержимого файла приведен ниже: 

[General]
ProcessFile="C:/AavaSCADA-1.2/bin/rtu.exe"
Wallpaper="C:/Images/wallpaper.png"

3.1 Описание параметров и значений .ini файла

Секция [General] содержит основные настройки приложения.

  • ПараметрWallpaper
    • Описание: Задает путь к изображению, используемому в качестве обоев рабочего стола.
    • Тип: Файл.
    • Формат: Абсолютный путь.
    • Пример значения: Wallpaper="C:/Images/wallpaper.png"
  • ПараметрProcessFile
    • Описание: Задает путь до исполняемого файла (обычно rtu.exe), запускаемого при старте ASLauncher.
    • Тип: Файл.
    • Формат: Абсолютный путь.
    • Пример значения: ProcessFile="C:/AavaSCADA-1.2/bin/rtu.exe"

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
Источник — https://docs.kb-agava.ru/index.php?title=ASLauncher&oldid=2812