Использование примера загрузчика Setup.exe с приложением

Статья
11/16/2008

Обновлен: Ноябрь 2007

Операции, выполняемые примером загрузчика Setup.exe являются автоматическими. Однако для использования программы Setup.exe с собственным приложением необходимо создать специальных файл Settings.ini и включить в него все необходимые сведения о приложении. Кроме того, рекомендуется развертывать программу установки с файлом сведений, который бы содержал предназначенные для пользователей минимальные требования к конфигурации для установки приложения и Dotnetfx.exe. В приведенных ниже разделах содержится подробная информация о создании файла Settings.ini и файлов сведений.

Создание файла Settings.ini
Создание файла сведений для программы установки

Создание файла Settings.ini

В примере загрузчика Setup.exe внешний файл Settings.ini используется для определения следующих параметров.

Расположение файла Dotnetfx.exe и ведущего приложения.
Языковая версия .NET Framework, которая должна присутствовать на компьютере.
Пользовательские строки, которые должны использоваться в диалоговых окнах Setup.exe.

По умолчанию расположение файла Settings.ini совпадает с расположением файла Setup.exe. За создание файла Settings.ini, который позволил бы запускать пример загрузчика Setup.exe с конкретным приложением, отвечает разработчик. Разработчик может скопировать файл Settings.ini, поставляемый вместе с примером загрузчика Setup.exe, а затем изменить этот файл, указав значения, соответствующие нужному приложению.

Указание расположения файла Dotnetfx.exe и ведущего приложения

Для работы примера загрузчика Setup.exe необходимо, чтобы было известно расположение файла Dotnetfx.exe и приложения .NET Framework относительно файла Setup.exe. Для определения расположения файла Dotnetfx.exe и ведущего приложения в примере загрузчика Setup.exe используется внешний файл Settings.ini. Разработчик может скопировать файл Settings.ini, поставляемый вместе с примером загрузчика, а затем изменить этот файл, указав в нем расположение ведущего приложения .NET Framework и файла Dotnetfx.exe.

В приведенных ниже примерах файла Settings.ini показано, как указывать путь к пакету установщика Windows ведущего приложения .NET Framework (mySetup.msi) и файлу Dotnetfx.exe при различных вариантах их расположения относительно файла Setup.exe.

В следующем примере файлы Settings.ini, mySetup.msi и Dotnetfx.exe расположены в той же папке, что и файл Setup.exe. Знак апострофа " ' " служит для преобразования в комментарий неизменяемых строк.

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

В следующем примере файлы Settings.ini, mySetup.msi и Dotnetfx.exe расположены в сетевой папке, отличной от папки, в которой хранится файл Setup.exe.

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

В следующем примере файлы Settings.ini, mySetup.msi и Dotnetfx.exe расположены на том же компьютере, что и файл Setup.exe, но в других папках

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

В следующем примере файлы Settings.ini, mySetup.msi и Dotnetfx.exe расположены на том же компакт-диске, что и файл Setup.exe, но в других папках

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

Указание языковой версии

Если программа Setup.exe должна проверять не только номер построения, но и язык платформы .NET Framework, необходимо указать имя языка и региональных параметров в файле Settings.ini. Если имя языка и региональных параметров не указано, программа Setup.exe будет по умолчанию искать только английскую версию.

В приведенной ниже таблице перечислены доступные языковые версии и соответствующие им имена языка и региональных параметров, которые следует указывать в файле Settings.ini. Имена языка и региональных параметров можно указывать без учета регистра символов.

Язык	Имя языка и региональных параметров
Китайский (упрощенное письмо)	chs
Китайский (традиционное письмо)	cht
Французский	fr
Немецкий	de
Итальянский	it
Японский	ja
Корейский	ko
Испанский	es

Согласно следующему файлу Settings.ini программа Setup.exe должна проверить систему на наличие версии Dotnetfx.exe на французском языке.

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Настройка строк, которые должны использоваться в диалоговых окнах Setup.exe

Для настройки строк, отображаемых в диалоговых окнах программы Setup.exe, служат следующие переменные файла Settings.ini.

ProductName — имя приложения .NET Framework, устанавливаемого с помощью программы Setup.exe. Указываемое имя продукта будет отображаться в диалоговом окне, которое появляется после запуска программы Setup.exe. Например, если указать для параметра ProductName значение Мое приложение, то в диалоговом окне будет отображаться текст "Чтобы начать установку приложения "Мое приложение", нажмите кнопку "ОК". Чтобы завершить программу и не устанавливать приложение, нажмите "Отмена"".

Если параметр CaptionText не задан, то значение ProductName будет также использоваться в заголовке диалогового окна, которое появляется после запуска программы Setup.exe. Например, если в качестве значения ProductName указан текст Мое приложение, то в заголовке окна будет отображаться строка "Мое приложение - установка". Если заданы оба параметра (ProductName и CaptionText), в заголовке диалогового окна будет использоваться значение CaptionText.

Кроме того, значение ProductName используется в заголовке окна с сообщением об успешном завершении установки приложения. Если параметр ProductName не задан, отображается текст по умолчанию: "Установка приложения".
Значение DialogText определяет пользовательский текст в диалоговом окне, которое появляется после запуска программы Setup.exe. Если параметр DialogText не задан, отображается текст по умолчанию: "Чтобы начать установку приложения, нажмите кнопку "ОК". Чтобы завершить программу и не устанавливать приложение, нажмите "Отмена"".
Значение CaptionText определяет пользовательский текст в заголовке диалогового окна, которое появляется после запуска программы Setup.exe. Если параметр CaptionText не задан, отображается значение ProductName. Если не задан и параметр ProductName, отображается текст по умолчанию: "Установка приложения".
Значение ErrorCaptionText определяет пользовательский текст в заголовке окна сообщения об ошибке программы Setup.exe. Если параметр ErrorCaptionText не указан, отображается текст по умолчанию: "Ошибка установки приложения".

Создание файла сведений для программы установки

Рекомендуется распространять программу установки с файлом сведений, содержащим минимальные требования к конфигурации компьютера, на котором можно запускать программу установки. В качестве минимальных требований установки указывайте Microsoft Windows 98 или более поздней версии и Internet Explorer 5.01 или более поздней версии. Кроме того, в список требований следует включать компоненты доступа к данным MDAC версии 2.6 или более поздней версии, а также указывать, что эти компоненты не требуются для установки, но нужны для работы приложений .NET Framework, использующих доступ к данным. Дополнительные сведения о минимальных требованиях к конфигурации системы, в которой устанавливается пакет Dotnetfx.exe, см. в разделе Минимальные требования к конфигурации.