Comment : créer un manifeste de produit

Article
08/10/2011

Pour déployer des composants requis pour votre application, vous pouvez créer un package du programme d'amorçage. Un package du programme d'amorçage contient un fichier manifeste de produit unique et un manifeste du package pour chacun des paramètres régionaux. Le manifeste du package contient des aspects spécifiques à la localisation de votre package. Cela inclut des chaînes, des contrats de Licence Utilisateur Final et les modules linguistiques.

Pour plus d'informations sur les manifestes de produit, consultez Comment : créer un manifeste de package.

Création du manifeste de produit

Pour créer le manifeste de produit

Créez un répertoire pour le package du programme d'amorçage. Cet exemple utilise C:\package.
Dans Visual Studio, créez un fichier XML appelé product.xml et enregistrez-le dans le dossier C:\package.
Ajoutez le XML suivant afin de décrire l'espace de noms XML et le code du produit pour le package. Remplacez le code du produit par un identificateur unique pour le package.
```
<Product
xmlns="https://schemas.microsoft.com/developer/2004/01/bootstrapper" 
ProductCode="Custom.Bootstrapper.Package">
```
Ajoutez du code XML pour spécifier que le package a une dépendance. Cet exemple utilise une dépendance à Microsoft Windows Installer 3.1.
```
    <RelatedProducts>
        <DependsOnProduct Code="Microsoft.Windows.Installer.3.1" />
      </RelatedProducts>
```
Ajoutez du code XML pour répertorier tous les fichiers contenus dans le package du programme d'amorçage. Cet exemple utilise le nom de fichier CorePackage.msi pour le package.
```
    <PackageFiles>
        <PackageFile Name="CorePackage.msi"/>
    </PackageFiles>
```
Copiez ou déplacez le fichier CorePackage.msi vers le dossier C:\package.
Ajoutez du code XML pour installer le package à l'aide des commandes du programme d'amorçage. Le programme d'amorçage ajoute automatiquement l'indicateur /qn au fichier .msi, qui s'installera silencieusement. Si le fichier est un .exe, le programme d'amorçage exécute le fichier .exe à l'aide du shell. Le code XML suivant ne montre aucun argument pour CorePackage.msi, mais vous pouvez placer l'argument de ligne de commande dans l'attribut Arguments.
```
    <Commands>
        <Command PackageFile="CorePackage.msi" Arguments="">
```

Ajoutez le code XML suivant pour vérifier si ce package du programme d'amorçage est installé. Remplacez le code du produit par le GUID pour le composant redistribuable.

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

Ajoutez du code XML pour modifier le comportement du programme d'amorçage selon que le composant du programme d'amorçage est déjà installé ou non. Si le composant est installé, le package du programme d'amorçage ne s'exécute pas. Le code XML suivant vérifie si l'utilisateur actuel est un administrateur, car ce composant requiert des privilèges d'administrateur.
```
        <InstallConditions>
            <BypassIf 
               Property="IsMsiInstalled" 
               Compare="ValueGreaterThan" Value="0"/>
            <FailIf Property="AdminUser" 
                Compare="ValueNotEqualTo" Value="True"
                String="NotAnAdmin"/>
        </InstallConditions>
```

Ajoutez du code XML pour définir des codes de sortie si l'installation aboutit et si un redémarrage est nécessaire. Le code XML suivant montre les codes de sortie Fail et FailReboot, qui indiquent que le programme d'amorçage ne continuera pas à installer des packages.

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

Ajoutez le code XML suivant afin de terminer la section pour les commandes du programme d'amorçage.
```
        </Command>
    </Commands>
```
Déplacez le dossier C:\package vers le répertoire du programme d'amorçage Visual Studio. Pour Visual Studio 2010, il s'agit du répertoire \Program Files\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages.

Exemple

Le manifeste de produit contient des instructions d'installation pour les composants requis personnalisés.

<?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>

Voir aussi

Référence

Référence du schéma de produit et de package

Partager via