Usando o Setup.exe Bootstrapper Sample com um aplicativo

Artigo
08/25/2010

As operações executadas pelo Amostra de inicializador Setup.exe são automáticas.No entanto, para habilitar o Setup.exe para usar o seu aplicativo, você deve criar um configurações personalizadas arquivo .ini que inclui as informações necessárias sobre seu aplicativo.Além disso, é recomendável que você implante seu programa de instalação com um arquivo Leiame que fornece aos usuários o requisitos mínimos de configuração para instalar o aplicativo e do Dotnetfx.exe.As seções a seguir fornecem informações detalhadas sobre como criar os arquivos Leiame e de Settings.ini:

Criando um configurações arquivo .ini
Criando um arquivo Leiame para o programa de instalação

Criando um configurações arquivo .ini

O exemplo de Setup.exe Bootstrapper utiliza o arquivo externo, Settings.ini, para determinar o seguinte:

O local do Dotnetfx.exe e o aplicativo host.
A versão do linguagem do .NET estrutura para verificar.
Cadeias de caracteres personalizadas a ser usado para caixas de diálogo Setup.exe.

O localização padrão para Settings.ini é na mesma pasta sistema autônomo Setup.exe.Você é responsável pela criação de configurações de um arquivo .ini que permite a amostra de inicializador Setup.exe trabalhar com seu aplicativo.Você pode copiar o arquivo Settings.ini fornecido com a amostra de inicializador Setup.exe e, em seguida, edição o arquivo conforme necessário, para especificar sistema autônomo valores corretos para seu aplicativo.

Especificar a localização do Dotnetfx.exe e aplicativo host

A amostra de inicializador Setup.exe requer Dotnetfx.exe e o host de aplicativo do .NET estrutura em um local conhecido em relação ao Setup.exe.A amostra de inicializador Setup.exe usa o arquivo externo, Settings.ini, para determinar o local de Dotnetfx.exe e o aplicativo host.Você pode copiar as configurações de arquivo .ini que é fornecido com o exemplo e, em seguida, edite o arquivo para apontar para locais de seu aplicativo host do .NET estrutura e o Dotnetfx.exe.

Os exemplos a seguir dos arquivos Settings.ini ilustram como apontar para um pacote do Windows Installer para um host de aplicativo do .NET estrutura (mySetup.msi) e o Dotnetfx.exe em vários locais em relação ao local do Setup.exe.

No seguinte arquivo de exemplo Settings.ini, mySetup.msi e Dotnetfx.exe estão localizados na mesma pasta sistema autônomo Setup.exe. Um apóstrofo "'" é usado para comentar linhas que não são personalizadas.

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

No exemplo a seguir configurações arquivo .ini, mySetup.msi e Dotnetfx.exe estão localizados em um compartilhamento de rede, separado do Setup.exe.

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

No seguinte arquivo de exemplo Settings.ini, mySetup.msi e Dotnetfx.exe estão localizados no mesmo computador sistema autônomo Setup.exe, mas em diferentes pastas.

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

No exemplo a seguir configurações arquivo .ini, mySetup.msi e Dotnetfx.exe estão localizados no mesmo CD que o Setup.exe, mas em diferentes pastas.

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

Especificar a versão de linguagem

Se você desejar que o Setup.exe para verificar se há um número da versão e uma versão de linguagem do .NET estrutura, você deve especificar o nome de cultura do linguagem para verificar se há nas configurações do arquivo .ini.Se você não especificar um nome de cultura, Setup.exe verifica a versão em inglês por padrão.

A tabela a seguir lista os nomes de cultura correspondente para especificar as configurações e versões de linguagem disponível arquivo .ini.Nomes de culturas fazem distinção entre maiúsculas e minúsculas.

Linguagem	Nome da cultura
Chinês (Simplificado)	CHS
Chinês (tradicional)	CHT
Francês	fr
Alemão	de
Italiano	Ele
Japonês	ja
Coreano	ko
Espanhol	es

O exemplo a seguir configurações arquivo .ini instrui o Setup.exe para verificar a versão do linguagem francês do Dotnetfx.exe.

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

Personalizar seqüências de caracteres para caixas de diálogo de Setup.exe

Você pode edição as variáveis a seguir no arquivo Settings.ini para personalizar seqüências de caracteres exibidas nas caixas de diálogo de Setup.exe.

ProductName Especifica o nome do aplicativo .NET estrutura que instalará o Setup.exe. O nome do produto que você especifica é usado para personalizar o texto na caixa de diálogo que aparece depois de iniciar o Setup.exe.Por exemplo, se você especificar Meu aplicativo sistema autônomo ProductName, lê o texto da caixa de diálogo, "para iniciar a instalação meu aplicativo, clicar OK. Para sair sem instalar, clicar ' Cancelar'."

Se não for personalizado a CaptionText variável, ProductName também é usado para personalizar o BAR de título para a caixa de diálogo que aparece depois de iniciar o Setup.exe. Por exemplo, se você especificar Meu aplicativo sistema autônomo the ProductName, o BAR de título exibe "Instalação do meu aplicativo". Se você personalizar os dois ProductName e CaptionText, CaptionText é usado para personalizar o BAR de título texto nessa caixa de diálogo.

ProductName também é usado para personalizar o BAR de título texto na caixa de diálogo do sucesso exibido quando o aplicativo é terminado instalando. Se você não fizer isso personalizar ProductName, o texto padrão "Instalação do aplicativo" é exibida.
DialogText Especifica o texto personalizado para exibir a caixa de diálogo é exibida depois de iniciar o Setup.exe. Se você não fizer isso personalizar DialogText, o texto padrão "para iniciar a instalação do aplicativo, clicar OK. Para sair sem instalar, clicar ' Cancelar '."é exibida.
CaptionText Especifica o texto personalizado para exibir na BAR de título da caixa de diálogo que aparece depois de iniciar o Setup.exe. Se não for personalizado CaptionText, ProductName é exibida. If ProductNamenão é personalizado, o texto padrão, "Instalação do aplicativo", é exibido.
ErrorCaptionText Especifica o texto personalizado para exibir as caixas de diálogo título Setup.exe da BAR de erro. Se não for personalizado ErrorCaptionText, o texto padrão "Erro de instalação do aplicativo" é exibido.

Criando um arquivo Leiame para o programa de instalação

Recomendamos que você distribuir seu programa de instalação com um arquivo Leiame que lista os requisitos mínimos de configuração do computador em que o programa de instalação pode executar com êxito.Uma lista mínimo, Microsoft Windows 98 ou posterior com o Internet Explorer 5.01 ou posterior instalado sistema autônomo um requisito antes para instalação.Você também deve listar o Microsoft Data Access Components (MDAC) versão 2.6 ou posterior, observando que não é necessário para a instalação, mas é necessário para aplicativos .NET estrutura que incluem o acesso a dados.Para obter mais informações sobre os requisitos mínimos de configuração para a instalação do Dotnetfx.exe, consulte Requisitos mínimos de configuração.