How to: Criar um manifesto de produto

Artigo
08/04/2011

Para implantar os pré-requisitos para seu aplicativo, você pode criar um pacote de bootstrapper. Um pacote de bootstrapper contém um arquivo de manifesto único produto, mas um manifesto de pacote para cada localidade. O manifesto de pacote contém a aspectos específicos de localização do seu pacote. Isso inclui seqüências de caracteres, os contratos de licença de usuário final e os pacotes de idiomas.

Para obter mais informações sobre manifestos de produto, consulte How to: Criar um manifesto de pacote.

Criando o manifesto do produto

Para criar o manifesto do produto

Crie um diretório para o pacote de bootstrapper. Este exemplo usa C:\package.
No Visual Studio, crie um novo arquivo XML chamado Product. XMLe salve-o para a pasta C:\package.
Adicione o seguinte XML para descrever o código de produto e o namespace XML para o pacote. Substitua o código de produto com um identificador exclusivo para o pacote.
```
<Product
xmlns="https://schemas.microsoft.com/developer/2004/01/bootstrapper" 
ProductCode="Custom.Bootstrapper.Package">
```
Adicione o XML para especificar que o pacote tem uma dependência. Este exemplo usa uma dependência no 3.1 do Microsoft Windows Installer.
```
    <RelatedProducts>
        <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
      </RelatedProducts>
```
Adicione o XML para listar todos os arquivos que estão no pacote bootstrapper. Este exemplo usa o nome de arquivo do pacote CorePackage.msi.
```
    <PackageFiles>
        <PackageFile Name="CorePackage.msi"/>
    </PackageFiles>
```
Copiar ou mover o arquivo CorePackage.msi para a pasta C:\package.
Adicione o XML para instalar o pacote usando os comandos de bootstrapper. O bootstrapper adiciona automaticamente o /qn Sinalizar para o arquivo. msi, que irá instalar silenciosamente. Se o arquivo for um. exe, o bootstrapper executa o arquivo. exe usando o shell. O XML a seguir mostra o sem argumentos para CorePackage.msi, mas você pode colocar o argumento de linha de comando para o atributo de argumentos.
```
    <Commands>
        <Command PackageFile="CorePackage.msi" Arguments="">
```

Adicione o seguinte XML para verificar se o pacote de bootstrapper está instalado. Substitua o código de produto com o GUID do componente redistribuível.

        <InstallChecks>
            <MsiProductCheck 
                Property="IsMsiInstalled" 
                Product="{XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"/>
        </InstallChecks>

Adicione o XML para alterar o comportamento de bootstrapper dependendo se o componente de bootstrapper já estiver instalado. Se o componente estiver instalado, o pacote de bootstrapper não é executado. O XML a seguir verifica se o usuário atual for um administrador, porque este componente requer privilégios administrativos.
```
        <InstallConditions>
            <BypassIf 
               Property="IsMsiInstalled" 
               Compare="ValueGreaterThan" Value="0"/>
            <FailIf Property="AdminUser" 
                Compare="ValueNotEqualTo" Value="True"
                String="NotAnAdmin"/>
        </InstallConditions>
```

Adicione o XML para definir códigos de saída, se a instalação for bem-sucedida e se uma reinicialização é necessária. O XML a seguir demonstra a que códigos, que indicam que o bootstrapper não continuará instalando pacotes de saída da falha e FailReboot.

        <ExitCodes>
            <ExitCode Value="0" Result="Success"/>
            <ExitCode Value="1641" Result="SuccessReboot"/>
            <ExitCode Value="3010" Result="SuccessReboot"/>
            <DefaultExitCode Result="Fail" String="GeneralFailure"/>
        </ExitCodes>

Adicione o seguinte XML para finalizar a seção para comandos de bootstrapper.
```
        </Command>
    </Commands>
```
Mova a pasta de C:\package para o diretório de bootstrapper de Visual Studio. Para 2010 Visual Studio, este é o diretório de \Program Files\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages.

Exemplo

O manifesto de produto contém instruções de instalação para pré-requisitos personalizados.

<?xml version="1.0" encoding="utf-8" ?>
<Product
  xmlns="https://schemas.microsoft.com/developer/2004/01/bootstrapper"
  ProductCode="Custom.Bootstrapper.Package">

  <RelatedProducts>
    <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
  </RelatedProducts>

  <PackageFiles>
    <PackageFile Name="CorePackage.msi"/>
  </PackageFiles>

  <InstallChecks>
    <MsiProductCheck Product="IsMsiInstalled" 
      Property="{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}"/>
  </InstallChecks>

  <Commands>
    <Command PackageFile="CorePackage.msi" Arguments="">

      <InstallConditions>
        <BypassIf Property="IsMsiInstalled"
          Compare="ValueGreaterThan" Value="0"/>
        <FailIf Property="AdminUser" 
          Compare="ValueNotEqualTo" Value="True"
         String="NotAnAdmin"/>
      </InstallConditions>

      <ExitCodes>
        <ExitCode Value="0" Result="Success"/>
        <ExitCode Value="1641" Result="SuccessReboot"/>
        <ExitCode Value="3010" Result="SuccessReboot"/>
        <DefaultExitCode Result="Fail" String="GeneralFailure"/>
      </ExitCodes>
    </Command>
  </Commands>
</Product>

Consulte também

Referência

Product and Package Schema Reference

Compartilhar via