Inicialização de download da Internet

Com o Windows Installler, um executável de inicialização configurável (Setup.exe) e uma ferramenta de configuração (Msistuff.exe) estão incluídos nos Componentes do SDK do Windows para Desenvolvedores do Windows Installer. Ao usar Msistuff.exe para configurar os recursos no Setup.exe, os desenvolvedores podem criar facilmente uma instalação na Web de um pacote do Windows Installer.

A versão mínima do instalador exigida pelo executável de inicialização é o Windows Installer versão 2.0. Os aplicativos podem obter a versão do instalador usando DllGetVersion. Para obter mais informações, confira Determinando a versão do Windows Installer

O executável de inicialização fornecido com o SDK do Windows Installer faz o seguinte:

• Chama WinVerifyTrust para verificar a assinatura digital do arquivo .msi. O Windows Installer versão 2.0 e versões posteriores fornece um SIP (Pacote de Interface da Entidade) para habilitar a assinatura de pacotes do Windows Installer.
• Se necessário, ele atualiza a versão do Windows Installer no computador.

Os recursos de Setup.exe a seguir podem ser exibidos ou configurados com Msistuff.exe.

ID de Recurso	Descrição
ISETUPPROPNAME_BASEURL	O local da URL base do Setup.exe. Se nenhum valor for especificado, o local de Setup.exe padrão será a mídia removível. Somente instalações baseadas em URL estão sujeitas a uma verificação com WinVerifyTrust. A barra à direita na URL é opcional. Esse recurso é opcional.
ISETUPPROPNAME_DATABASE	O nome do arquivo .msi. É um caminho relativo para o arquivo de .msi especificado em relação ao local do programa Setup.exe. Esse recurso será obrigatório se o recurso ISETUPPROPNAME_PATCH não for especificado. ISETUPPROPNAME_DATABASE e ISETUPPROPNAME_PATCH não podem ser especificados. Somente um dos dois pode ser especificado.
ISETUPPROPNAME_OPERATION	O tipo de operação a ser realizada. Os valores possíveis são INSTALL, MINPATCH, MAJPATCH e INSTALLUPD. O valor INSTALL equivale à primeira instalação do pacote. O valor MINPATCH indica que o patch especificado na propriedade PATCH é um patch de atualização pequeno ou secundário. O valor MAJPATCH indica que o patch especificado na propriedade PATCH é um patch de atualização principal. INSTALLUPD indica que a instalação pode ser uma primeira instalação ou uma atualização. O uso de INSTALLUPD tem a verificação da presença do produto na inicialização. Se o produto estiver presente, o sinalizador do pacote recache será definido e uma reinstalação será executada; caso contrário, uma instalação regular será executada. Observe que INSTALLUPD só deve ser usado em pacotes de atualização pequenos e secundários em que o código do produto não tem mudança. Em uma atualização importante, REINSTALL não é obrigatório porque o código do produto é alterado, o que, no fundo, cria outro produto. A criação da tabela Upgrade, além das ações FindRelatedProducts, MigrateFeatureStates e RemoveExistingProducts, tratam da atualização do produto original. Portanto, a opção INSTALL é suficiente. Se esse recurso estiver ausente, a operação INSTALL será assumida se a propriedade ISETUPPROPNAME_DATABASE for criada. Caso contrário, MINPATCH será assumido se a propriedade ISETUPPROPNAME_PATCH for criada. Esse é um valor opcional.
ISETUPPROPNAME_PRODUCTNAME	O nome do produto. Esse é o nome usado no texto da faixa na interface do usuário baixada. Esse recurso é opcional. Se omitido, o nome usará como padrão "o produto".
ISETUPPROPNAME_MINIMUM_MSI	A versão mínima do Windows Installer obrigatória. Se a versão mínima do Windows Installer não estiver instalada no computador, o Instmsi.exe apropriado será chamado para atualizar o Windows Installer. O valor dessa propriedade tem o mesmo formato que o valor PID_PAGECOUNT. Para obter mais informações, confira a propriedade Page Count Summary. Esse valor precisa ser pelo menos 200; o valor que identifica o Windows Installer versão 2.0. Esse recurso é obrigatório.
ISETUPPROPNAME_INSTLOCATION	O local da URL base dos executáveis de atualização do Windows Installer. Esse recurso pode ser omitido. Se esse valor for omitido, o local padrão dos executáveis de atualização será o local de Setup.exe.
ISETUPPROPNAME_INSTMSIA	O nome da versão ANSI do executável de atualização do Windows Installer. Esse é um caminho relativo para a versão ANSI de Instmsi.exe em relação ao local especificado por ISETUPPROPNAME_INSTLOCATION. Esse recurso é obrigatório.
ISETUPPROPNAME_INSTMSIW	O nome da versão Unicode do executável de atualização do Windows Installer. Esse é um caminho relativo para a versão Unicode de Instmsi.exe em relação ao local especificado por ISETUPPROPNAME_INSTLOCATION. Esse recurso é obrigatório.
ISETUPPROPNAME_PATCH	O nome do arquivo .msp. É um caminho relativo para o arquivo de .msp especificado em relação ao local do programa Setup.exe. Esse recurso será obrigatório se o recurso ISETUPPROPNAME_DATABASE não for especificado. ISETUPPROPNAME_DATABASE e ISETUPPROPNAME_PATCH não podem ser especificados. Somente um dos dois pode ser especificado.
ISETUPPROPNAME_PROPERTIES	As cadeias de caracteres PROPERTY=VALUE. São os pares PROPERTY=VALUE a serem incluídos na linha de comando. Essa opção é opcional.

 

Por exemplo, os valores de ISETUPPROPNAME_BASEURL e ISETUPPROPNAME_DATABASE a seguir seriam usados para os locais hipotéticos do pacote abaixo.

Local real do pacote	Valores de Recurso
https://www.blueyonderairlines.com/Products/Product1/product1.msi	ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = product1.msi
https://www.blueyonderairlines.com/Products/Product1/product1.msi	ISETUPPROPNAME_BASEURL = https://www.blueyonderairlines.com/Products/Product1 ISETUPPROPNAME_DATABASE = ../Products1/product1.msi
e:\product1.msi	Omit ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = product1.msi
e:\setup\product1.msi (O local de execução atual de Setup.exe é e:\setup.exe.)	Omit ISETUPPROPNAME_BASEURL. ISETUPPROPNAME_DATABASE = Setup\product1.msi

 

Parâmetros de linha de comando Setup.exe

A tabela a seguir lista as opções de comando que podem ser usadas com o Setup.exe que é fornecido com os Componentes do SDK do Windows para Desenvolvedores do Windows Installer. Quando invocado sem nenhuma opção de linha de comando, Setup.exe usa como padrão o comportamento especificado por meio dos recursos configurados. As opções de linha de comando são mutuamente exclusivas; apenas uma delas pode ser usada de cada vez.

Opção	Uso	Significado
/a	setup.exe /a	Inicia uma instalação administrativa. Se a propriedade ISETUPPROPNAME_DATABASE estiver configurada em Setup.exe, essa opção poderá ser usada para executar uma instalação administrativa do produto. Essa opção de linha de comando não terá suporte se o recurso ISETUPPROPNAME_PATCH estiver configurado.
/a	setup.exe /a<caminho completo para uma instalação administrativa existente>	Se a propriedade ISETUPPROPNAME_PATCH estiver configurada em Setup.exe, essa opção poderá ser usada para corrigir uma instalação administrativa existente do produto. Essa opção de linha de comando não terá suporte se o recurso ISETUPPROPNAME_DATABASE estiver configurado.
/v	setup.exe /v<caminho completo para um arquivo>	Verifica a assinatura no arquivo usando WinVerifyTrust. Nenhuma interface do usuário é exibida quando essa opção é usada. Nesse caso, o resultado da verificação de confiança é o valor retornado obtido da execução de Setup.exe.
/?		Exibe um diálogo de ajuda que indica os argumentos válidos. Observação: o diálogo de ajuda também será exibida se argumentos inválidos forem fornecidos.

 

Para obter mais informações, confira Um exemplo de instalação do Windows Installer baseado em URL.