Платформа 1С:Предприятие 8.3
11.06.2015

Приложение Autorun

Приложение Autorun

• Создание приложения Autorun
• Редактирование основных настроек
  • Секция [Main]
  • Cекция [Language]
  • Секция [Element]
• Локализация
  Добавление элементов подменю
  Обеспечение автоматического запуска Autorun

Приложение SetupV8

• Секция [Platform]
• Секция [CFG]
• Секция [ <Язык> ]

Приложение Autorun может быть использовано как настраиваемая пользовательская оболочка при создании CD или DVD-ROM. Как настройки, так и пользовательский интерфейс приложения предельно упрощены — приложение представляет собой диалог, разделенный на следующие логические части:

• заголовок,
• фон,
• список запускаемых программ,
• описание запускаемых программ,
• кнопка выхода.

Все части диалога настраиваемы и локализуемы. Для локализации диалога используется список языков и соответствующие каждому языку из этого списка локализованные части диалога. Если в списке языков присутствует более одного языка, то в диалоге появляется дополнительный элемент управления (выпадающий список) для выбора пользователем одного из известных ему языков.

Приложение Autorun доступно в виде исполняемого файла, который может работать в ОС Windows (autorun.exe) и в ОС Linux (autorun). В ОС Linux приложение Autorun может функционировать как в 32-разрядной, так и в 64-разрядной версии операционной системы.

Создание приложения Autorun

Приложение Autorun можно создать на основе файлов, которые вы можете скопировать.

Список используемых файлов зависит от используемой операционной системы.

Для ОС Windows в каталоге содержатся файлы:

• autorun.exe
• autorun.ico
• autorun.inf - файл информации об установке.
• autorun.lst - файл настроек автозапуска.
• autorunfull.lst - файл настроек для "вложенного меню" диалога автозапуска.
• gdiplus.dll - требуется только для версий ниже Windows Vista.
• SetupV8.cfg
• SetupV8.exe

Для ОС Linux в каталоге содержится файл autorun.

Настройки диалога автозапуска редактируются в файле autorun.lst.

Редактирование основных настроек Autorun

Настройки диалога помещаются в файл autorun.lst. Этот файл имеет формат, аналогичный формату ini-файлов, и записывается в кодировке UTF-8. Файл должен находиться в одном каталоге с исполняемым файлом autorun.exe. Ниже перечислены элементы формата autorun.lst.

Секция [Main]

Секция Main содержит параметры, относящиеся ко всему диалогу. Данная секция является обязательной.

• Caption — заголовок диалога автозапуска.
• Picture — путь к картинке фона диалога в формате .bmp. Указывается относительно каталога, в котором расположен файл autorun.lst. Размер диалога подстраивается под размеры картинки.
• WarningMsg — текст предупреждения, которое будет отображаться в диалоге системы UAC (для Windows Vista и старше) при запуске приложения Autorun.
• ExitText — текст кнопки выхода.

[Main]
Caption = 1С:Предприятие 8.3. Версия для обучения программированию
Picture = Picture\autorun.bmp
ExitText = Завершить

Секция [Language]

Необязательная секция Language описывает языки, доступные в диалоге автозапуска. Для каждого языка следует создать отдельную секцию.

• Locale — идентификатор языка установки. Тип - Строка. 
• Name — наименование языка установки, как оно будет отображаться в списке доступных языков.

При использовании нескольких секций Language в диалоге автозапуска будет доступен выбор языка из списка.

[Language]
Name=Русский
Locale=ru

[Language]
Name=Английский
Locale=en

Секция [Element]

Секция Element описывает один из элементов списка запускаемых программ. Данная секция является обязательной:

• Name — строка для списка запускаемых программ.
• Description — описание запускаемой программы.
• Command — командная строка для запуска программы. Командная строка исполняется последовательно с прибавлением в начале наименования диска, с которого запущен автозапуск, затем с прибавлением в начале наименования диска и каталога автозапуска, и затем без добавлений — как есть.
• CommandWindows - командная строка запуска приложения в ОС Windows. Путь указывается относительно каталога, в котором расположен файл autorun.lst.
• CommandLinux - командная строка запуска приложения в ОС Linux.
• RunAsRoot - флаг, указывающий, что Linux-версия приложения Autorun должна быть запущена от имени суперпользователя (root). Если для запуска требуются права суперпользователя, значение параметра должно равняться "1", и "0" - в противном случае. Значение по умолчанию - "0".
• Marker — отметка элемента списка. Может принимать строчные значения Primary (синяя картинка) и Secondary (желтая картинка).

В том случае, если для элемента конфигурационного файла задан параметр Command только для одной из операционных систем (CommandWindows или CommandLinux), то соответствующий элемент будет отображаться только в той операционной системе, какой параметр задан.

Если задан только параметр Command, то элемент будет отображаться во всех операционных системах.

Если задан Command и какой-либо (или оба) параметра, специфичный для какой-либо операционной системы (CommandWindows или CommandLinux), то соответствующий элемент будет отображаться во всех операционных системах, а для выполнения команды будет выбираться команда, соответствующая операционной системе или использоваться свойство Command, если для текущей ОС не указано "свое" свойство.

Возможно переключение списка пунктов. Для этого необходимо в файле autorun.lst создать элемент, который содержит дополнительный список пунктов выбора, например:

[Element]
Name=Выборочная установка...
Description= Выборочная установка компонент
Marker=Secondary
Command=autorunfull.lst

В этом примере команда Command=autorunfull.lst ссылается на файл настроек, который содержит другой набор элементов выбора.

Вложенность дополнительных списков пунктов выбора не ограничена. Возврат к нужному списку выполняется как один из пунктов дополнительного списка с указанием нужного файла настроек. Так, для возврата в основной список выбора нужно в файле autorunfull.lst (из предыдущего примера) создать следующий элемент:

[Element]
Name=Назад...
Description= Возврат к предыдущему списку
Command=autorun.lst

Пример:

[Element]
Name = Инструкции по установке
Description = Щелкните здесь, чтобы прочитать инструкцию по установке.
CommandWindows = readme.htm
CommandLinux = xdg-open readme.htm
Marker = Primary

При выборе данного элемента диалога будет открыт файл readme.htm.

[Element]
Name = Установить приложение
Description = Щелкните здесь, чтобы установить прилжоение
CommandWindows = SetupV8.exe @SetupV8.cfg
CommandLinux = InstallationScript.sh
RunAsRoot = 1
Marker = Primary

В ОС Windows будет запущен установщик платформы, в ОС Linux - будет выполнен скрипт установки, содержащийся в файле InstallationScript.sh. Для выполнения действия требуются права суперпользователя (root).

Локализация элементов

Для локализации той или иной строки достаточно добавить к наименованию элемента символ подчеркивания "_" и идентификатор (Locale) нужного языка. Элементы с наименованиями без суффиксов считаются универсальными и могут быть использованы для любого языка в случае отсутствия локализованной для этого языка строки. Описанные правила не относятся к наименованиям секций и параметрам Locale, Command и Marker.

Пример:

[Main]
Caption = 1С:Предприятие 8.3. Учебная версия
Caption_en= 1C:Enterprise 8.3. Training Version
Picture = Pictures/autorun_ru.bmp
Picture_en = Pictures/autorun_en.bmp
ExitText = Выход
ExitText_en = Exit

[Language]
Name = Английский
Name_en = English
Locale = en

[Language]
Name = Russian
Name_ru = Русский
Locale = ru

[Element]
Name = Автоматическая установка (рекомендуется)
Name_en = Automatic installation (recommended)
Description = Это рекомендованный режим установки
Description_en = This is the recommended installation type.
Command = install.bat
Marker = Primary

Доступны следующие языки:

• азербайджанский - az,
• английский - en,
• болгарский - bg
• вьетнамский - vi,
• грузинский - ka,
• казахский - kk,
• китайский - zh,
• латвийский - lv,
• литовский - lt,
• немецкий - de,
• польский - pl,
• румынский - ro,
• русский - ru,
• украинский - uk,
• французский - fr. 

Основной язык устанавливается по следующему принципу:

• Если язык, соответствующий локали, задан в файле autorun.lst, он используется как основной.
• Если язык, соответствующий локали, не задан в файле autorun.lst, но задан русский - в качестве основного языка используется русский.

Создание вложенных меню

В приложении Autorun доступно создание многоуровневых меню. Элементы меню, открывающие вложенные меню - это эелменты в файле autorun.lst.

Например:

[Element]
Name = Ещё
Description = Щелкните элемент, чтобы открыть меню.
Marker = Primary
Command = autorunfull.lst

В данном примере в файле autorunfull.lst содержатся настройки для другого диалога автозапуска, содержащего собственные элементы.

Глубина вложенности элементов в меню диалога автозапуска неограничена. В данном примере, чтобы вернуться в меню верхнего уровня, в aurotunfull.lst требуется создать элемент, который будет указывать на файл autorun.lst (в котором описан верхний уровень меню)

[Element]
Name = < Назад
Description = Вернуться к предыдущему меню.
Marker = Primary
Command = autorun.lst

Обеспечение автоматического запуска Autorun

Для автоматического запуска Autorun в ОС Windows требуется наличие файла autorun.inf в корне диска. Документация по формату этого файла размещена по адресу http://msdn.microsoft.com/en-us/library/windows/desktop/cc144202. При размещении программы Autorun (название исполняемого файла – autorun.exe) в корне диска, содержимое файла autorun.inf будет следующим:

[autorun]
OPEN=autorun.exe
ICON=autorun.ico

Для автоматического запуска программы Autorun в ОС Linux требуется наличие исполняемого файла autorun.sh в корне диска. Файл представляет собой обычный shell-скрипт, в котором (в простейшем варианте) осуществляется вызов программы autorun. При размещении программы Autorun (название исполняемого файла – autorun) в корне диска, содержимое файла autorun.sh будет следующим:

#!/bin/bash
./autorun

Приложение SetupV8

Программа SetupV8.exe позволяет выполнить в автоматическом режиме следующие действия:

• установить платформу "1С:Предприятие 8";
• установить шаблон конфигурации;
• создать информационную базу на основе установленного шаблона;
• запустить установленную систему.

Настройка особенностей поведения при выполнении каждого из вышеперечисленных действий осуществляется с помощью специального конфигурационного файла. Для того чтобы выполнить необходимые действия, описанные в конфигурационном файле, следует указать нужный конфигурационный файл в качестве параметра при запуске приложения SetupV8.exe:

SetupV8.exe <путь к файлу ConfigFileName.cfg относительно каталога с SetupV8.exe>

Если параметр не указан, то приложение SetupV8.exe будет использовать файл SetupV8.cfg, который должен быть расположен в каталоге, откуда выполняется запуск SetupV8.exe.

Конфигурационный файл имеет формат, аналогичный формату ini-файлов, и записывается в кодировке UTF-8.

Все секции являются обязательными. Символ # является признаком комментария. Любой текст, следующий после этого символа, игнорируется.

Ниже перечислены элементы формата конфигурационного файла.

Секция [Platform]

Секция описывает настройки установки платформы "1С:Предприятие 8". Данная секция является обязательной.

• MsgBeforePlatform – если используется, перед установкой платформы будет отображено указанное сообщение. Текст сообщения устанавливается в секциях <Язык>.
• Location – указывает местоположение дистрибутива платформы относительно каталога, в котором расположена программа SetupV8.exe.
• CmdLine – параметры, передаваемые программе установки платформы:
  • DEFLANGUAGE – указывает язык интерфейса платформы по умолчанию.
  • HASPInstall – определяет необходимость установки драйвера ключа защиты.
  • REINSTALL – содержит список элементов, которые будут установлены заново. Подробнее см. https://msdn.microsoft.com/en-us/library/aa371175(v=vs.85).aspx.
  • REINSTALLMODE - указывает тип повторной установки. Подробнее см. http://msdn.microsoft.com/en-us/library/aa371182(v=vs.85).aspx
  • Любые параметры, доступные в опции InstallComponents файла 1CEStart.cfg: DESIGNERALLCLIENTS, THINCLIENT, THINCLIENTFILE, SERVER, WEBSERVEREXT, CONFREPOSSERVER, and SERVERCLIENT.
    
• UI – определяет, насколько подробным будет графический интерфейс программы установки:
  • 3 – будет отображаться только индикатор установки (прогресс-бар);
  • 5 – будет использоваться обычный (полный) интерфейс программы установки.
• PackageName – имя установочного пакета платформы.
• MsiVersion – минимальная требуемая версия компонента Microsoft Installer, необходимая для запуска программы установки платформы.
• MsiW – имя установочного файла компонента Microsoft Installer, который будет запущен, если на компьютере установлена старая версия этого компонента (относительно указанной в параметре MsiVersion).
• MsgAfterPlatform – если используется, после установки платформы будет отображено указанное сообщение. Текст сообщения устанавливается в секциях <Язык>.

Пример секции:

[Platform]
MsgBeforePlatform
Location=1CV8
CmdLine=REINSTALLMODE=vomus REINSTALL=ALL LAUNCHREADME=No READMEFILETOLAUNCHATEND=0 SHOWLAUNCHREADME=0 HASPInstall=no DEFLANGUAGE=RU
UI=3
PackageName=1CEnterprise 8.msi
MsiVersion=2.0.2600.2
MsiW=WindowsInstaller-KB893803-x86.exe
MsgAfterPlatform

Секция [CFG]

Секция описывает настройки установки конфигурации (прикладного решения). Данная секция является обязательной.

• Location - указывает местоположение дистрибутива прикладного решения относительно каталога, в котором расположена программа SetupV8.exe.
• CfgDestination – каталог установки шаблона прикладного решения. Задается при подготовке поставки прикладного решения.
• Version – версия устанавливаемого прикладного решения.
• Config1 – признак необходимости создания новой информационной базы прикладного решения после завершения установки шаблона.
  • 0 – не создавать информационную базу;
  • 1 – создавать информационную базу.
• Config2 – признак необходимости создания демонстрационной информационной базы прикладного решения после завершения установки шаблона.
  • 0 – не создавать информационную базу;
  • 1 – создавать информационную базу.
• MsgBeforeCFG – если используется, сообщение отображается перед установкой конфигурации. Текст сообщения устанавливается в секциях <Язык>.
• MsgAfterCFG – если используется, сообщение отображается просле установки конфигурации. Текст сообщения устанавливается в секциях <Язык>.
• CFGLoad – если используется, сообщение отображается во время загрузки конфигурации. Текст сообщения устанавливается в секциях <Язык>.
• CFGError – если используется, сообщение отображается, если во время загрузки шаблона конфигурации возникла ошибка. Текст сообщения устанавливается в секциях <Язык>.
• MsgBeforeIB – если используется, сообщение отображается перед созданием информационной базы. Текст сообщения устанавливается в секциях <Язык>.
• IBCreate – если используется, сообщение отображается во время создания информационной базы. Текст сообщения устанавливается в секциях <Язык>.
• MsgAfterIB – если используется, сообщение отображается после создания информационной базы. Текст сообщения устанавливается в секциях <Язык>.
• AppLaunch – если используется, сообщение отображаетс перед запуском программы. Текст сообщения устанавливается в секциях <Язык>.

Пример секции:

[CFG]
Location=configs\smallbusiness
CfgDestination=1С\smallbusiness
version=1.0.0.0
Config1=1
Config2=1
MsgBeforeCFG
MsgAfterCFG
MsgBeforeIB
MsgAfterIB

Секция [<Язык>]

Секция содержит локализованные строки для информирования пользователя. Секций может быть несколько. В качестве имени секции указывается английское написание языка.

• <Язык> - определяет язык локализации. Может иметь следующие значения:
  • Russian – русский,
  • Ukrainian – украинский,
  • English – английский,
  • Latvian – латвийский,
  • Lithuanian – литовский,
  • Bulgarian – болгарский,
  • German – немецкий,
  • Romanian – румынский,
  • Georgian – грузинский,
  • Kazakh – казахский,
  • Vietnamese – вьетнамский,
  • Polish - польский,
  • Azerbaijani - азербайджанский,
  • Chinese - китайский,
  • French - французский.
• Title - заголовок окна программы установки.
• IBCreate - сообщение о создании информационной базы в анимированном диалоге.
• AppLaunch - сообщение о запуске платформы в анимированном диалоге.
• CFGLoad - сообщение о подготовке к запуску установки конфигурации в анимированном диалоге.
• CFGError - сообщение об ошибке при подготовке установки конфигурации в анимированном диалоге.
• MsgBeforePlatform – сообщение о начале установки платформы.
• MsgAfterPlatform – сообщение о завершении установки платформы.
• MsgBeforeCFG – сообщение о начале установки конфигурации.
• MsgAfterCFG – сообщение о завершении установки конфигурации.
• MsgBeforeIB – сообщение о начале создания информационной базы.
• MsgAfterIB – сообщение о завершении создания информационной базы.

Пример секции:

[Russian]
Title=Программа установки
IBCreate=Выполняется создание информационной базы %1. Это может занять несколько минут.
AppLaunch=Выполняется запуск 1С:Предприятия...
CFGLoad=Выполняется подготовка к установке конфигурации...
CFGError=Ошибка записи в каталог шаблонов. Возможно, недостаточно прав для записи.
MsgBeforeCFG=Для продолжения установки, пожалуйста, подключите ключ защиты, который включен в поставку, в порт USB компьютера.
MsgAfterIB=Установка успешно завершена. Нажмите OK для запуска 1С:Предприятия.

Файлы Autorun для запуска в ОС Windows находятся в каталоге \1CITS\EXE\Autorun\Windows

Копировать Autorun для OC Windows

Архив файлов Autorun для ОС Linux находится в подкаталоге \1CITS\EXE\Autorun\linux

Копировать Autorun для ОС Linux

Картинки находятся в подкаталоге \1CITS\EXE\Autorun\Pictures

Копировать картинки для Autorun