Paquet Burn
L'élément Bundle est l'élément de niveau supérieur d'un empaqueté Burn. Il contient des éléments enfants vous permettant de spécifier la chaîne de caractères de paquets à installer, l'application d'amorçage fournissant l'expérience utilisateur, les variables personnalisées et intégrées, les recherches système et tous les autres avantages vous permettant de définir un empaqueté.
<Wix
xmlns="http://wixtoolset.org/schemas/v4/wxs"
xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal">
<Bundle
Name="$(BundleName)"
Version="$(Version)"
UpgradeCode="$(UpgradeCode)"
Compressed="no"
SplashScreenSourceFile="splashscreen.bmp">
<BootstrapperApplication>
<bal:WixStandardBootstrapperApplication
LicenseUrl=""
Theme="hyperlinkLicense" />
</BootstrapperApplication>
<Chain>
<PackageGroupRef Id="BundlePackages" />
</Chain>
</Bundle>
</Wix>
Regrouper les chaînes de paquet
Burn prend en charge les types de paquets suivants :
| Paquet | Description |
|---|---|
| BundlePackage | Un autre lot de gravure .exe |
| ExePackage | Un programme d'installation .exe exécutable |
| MsiPackage | Un paquet Windows Installer .msi. |
| MspPackage | Un paquet de correctifs Windows Installer .msp |
| MsuPackage | Un paquet .msu de mise à jour Windows. |
Pour inclure un paquet dans la chaîne de paquets d'un empaqueté :
- Inclue l'élément paquet en tant qu'enfant de l'élément Chain.
- Inclue l'élément paquet en tant qu'enfant d'un élément PackageGroup et incluez ce groupe de paquets dans la chaîne avec un élément PackageGroupRef en tant qu'enfant de l'élément Chain.
Variables intégrées de Burn
Le moteur de Burn propose un empaqueté de variables couramment utilisées afin que vous puissiez les utiliser sans définir les vôtres. Voici la liste des noms de variables intégrées :
| Variable | Description |
|---|---|
| AdminToolsFolder | Le dossier bien connu pour CSIDL_ADMINTOOLS. |
| AppDataFolder | Le dossier bien connu pour CSIDL_APPDATA. |
| CommonAppDataFolder | Le dossier bien connu pour CSIDL_COMMON_APPDATA. |
| CommonFilesFolder | Le dossier bien connu pour CSIDL_PROGRAM_FILES_COMMONX86. |
| CommonFiles64Folder | Le dossier bien connu pour CSIDL_PROGRAM_FILES_COMMON. |
| CommonFiles6432Folder | Le dossier bien connu pour CSIDL_PROGRAM_FILES_COMMON sur Windows 64 bits et CSIDL_PROGRAM_FILES_COMMONX86 sur Windows 32 bits. |
| CompatibilityMode | Non nul si le système d'exploitation a lancé le programme d'amorçage en mode de compatibilité. |
| ComputerName | Nom de l'ordinateur tel qu'il est renvoyé par la fonction GetComputerName. |
| Date | La date actuelle utilisant le format de date courte des paramètres régionaux de l'utilisateur actuel. |
| DesktopFolder | Le dossier bien connu pour CSIDL_DESKTOP. |
| FavoritesFolder | Le dossier bien connu pour CSIDL_FAVORITES. |
| FontsFolder | Le dossier bien connu pour CSIDL_FONTS. |
| InstallerName | Le nom du moteur d'installation ("WiX Burn"). |
| InstallerVersion | La version du moteur d'installation. |
| LocalAppDataFolder | Le dossier bien connu pour CSIDL_LOCAL_APPDATA. |
| LogonUser | Le nom d'utilisateur actuel. |
| MyPicturesFolder | Le dossier bien connu pour CSIDL_MYPICTURES. |
| NTProductType | Type de produit numérique à partir des informations de version du système d'exploitation. |
| NTSuiteBackOffice | Non zéro si la suite de version du système d'exploitation est Back Office. |
| NTSuiteDataCenter | Non zéro si la version de la suite du système d'exploitation est Datacenter. |
| NTSuiteEnterprise | Non zéro si la version de la suite du système d'exploitation est Enterprise. |
| NTSuitePersonal | Non zéro si la suite de version du système d'exploitation est Personal. |
| NTSuiteSmallBusiness | Non zéro si la version de la suite du système d'exploitation est Small Business. |
| NTSuiteSmallBusinessRestricted | Non zéro si la version de la suite du système d'exploitation est Restricted Small Business.. |
| NTSuiteWebServer | Non zéro si la suite de version du système d'exploitation est Web Server. |
| PersonalFolder | Le dossier bien connu pour CSIDL_PERSONAL. |
| ProcessorArchitecture | Le SYSTEM_INFO.wProcessorArchitecture natif. |
| Privileged | Différent de zéro si le processus peut s'exécuter avec des privilèges élevés (lorsque l'UAC est disponible) ou s'exécute en tant qu'administrateur. |
| ProgramFilesFolder | Le dossier bien connu pour CSIDL_PROGRAM_FILESX86. |
| ProgramFiles64Folder | Le dossier bien connu pour CSIDL_PROGRAM_FILES. |
| ProgramFiles6432Folder | Le dossier bien connu pour CSIDL_PROGRAM_FILES sur Windows 64 bits et CSIDL_PROGRAM_FILESX86 sur Windows 32 bits. |
| ProgramMenuFolder | Le dossier bien connu pour CSIDL_PROGRAMS. |
| RebootPending | Non zéro si le système nécessite un redémarrage. Notez que cette valeur reflétera l'état de redémarrage du système lorsque la variable est demandée pour la première fois. |
| SendToFolder | Le dossier bien connu pour CSIDL_SENDTO. |
| ServicePackLevel | Valeur numérique représentant le Service Pack du système d'exploitation installé. |
| StartMenuFolder | Le dossier bien connu pour CSIDL_STARTMENU. |
| StartupFolder | Le dossier bien connu pour CSIDL_STARTUP. |
| SystemFolder | Le dossier bien connu pour CSIDL_SYSTEMX86 sur Windows 64 bits et CSIDL_SYSTEM sur Windows 32 bits. |
| System64Folder | Le dossier bien connu pour CSIDL_SYSTEM sur Windows 64 bits et indéfini sur Windows 32 bits. |
| SystemLanguageID | ID de langue pour les paramètres régionaux du système. |
| TempFolder | Le dossier bien connu pour le répertoire temporaire. |
| TemplateFolder | Le dossier bien connu pour CSIDL_TEMPLATES. |
| TerminalServer | Différent de zéro si le système s'exécute en mode serveur d'applications des services Bureau à distance. |
| UserUILanguageID | Identificateur de langue de sélection pour les paramètres régionaux de l'utilisateur actuel. |
| UserLanguageID | Identificateur de langue de formatage pour les paramètres régionaux de l'utilisateur actuel. |
| VersionMsi | Valeur de version représentant la version du moteur Windows Installer. |
| VersionNT | Valeur de version représentant la version du système d'exploitation. Le résultat est une variable de version (v#.#.#.#) différant de la propriété Windows Installer VersionNT étant un entier. Par exemple, pour utiliser cette variable dans une condition Bundle, utilisez : VersionNT > v6.1. |
| VersionNT64 | Valeur de version représentant la version du système d'exploitation si 64 bits. Non défini si vous utilisez un système d'exploitation 32 bits. Le résultat est une variable de version (v#.#.#.#) différant de la propriété Windows Installer VersionNT64 étant un entier. Par exemple, pour utiliser cette variable dans une condition Bundle, essayez : VersionNT64 > v6.1. |
| WindowsFolder | Le dossier bien connu pour CSIDL_WINDOWS. |
| WindowsVolume | Le dossier bien connu pour le volume Windows. |
| WixBundleAction | Valeur numérique de BOOTSTRAPPER_ACTION à partir de la ligne de commande et mise à jour lors de l'appel à IBootstrapperEngine::Plan. |
| WixBundleDirectoryLayout | Le dossier fourni au commutateur -layout (la valeur par défaut est le répertoire contenant l'exécutable de l'empaqueté). Cette variable peut également être définie par l'application d'amorçage pour modifier l'emplacement des fichiers. |
| WixBundleElevated | Non zéro si l'empaqueté a été lancé en mode élevé et défini sur 1 une fois l'empaqueté élevé. Par exemple, utilisez cette variable pour afficher ou masquer le bouclier d'élévation dans l'interface utilisateur de l'application d'amorçage. |
| WixBundleExecutePackageCacheFolder | Le chemin absolu vers le dossier de cache du paquet en cours d'exécution. Cette variable n'est disponible que lorsqu'un paquet est en cours d'exécution. |
| WixBundleForcedRestartPackage | Identificateur du paquet ayant provoqué un redémarrage forcé lors de l'application. Cette valeur est réinitialisée lors du prochain appel à Apply. |
| WixBundleInstalled | Non zéro si l'empaqueté est déjà installé. Cette valeur est définie uniquement lorsque le moteur s'initialise. |
| WixBundleLastUsedSource | Le chemin de la dernière résolution de source réussie pour un conteneur ou une charge utile. |
| WixBundleName | Le nom de l'empaqueté (depuis Bundle/@Name). Cette variable peut également être définie par l'application d'amorçage pour modifier le nom de l'empaqueté lors de l'exécution. |
| WixBundleManufacturer | Le fabricant de l'empaqueté (de Bundle/@Manufacturer). |
| WixBundleOriginalSource | Le chemin source où l'empaqueté a été exécuté à l'origine. |
| WixBundleOriginalSourceFolder | Le dossier dans lequel l'empaqueté a été exécuté à l'origine. |
| WixBundleSourceProcessPath | Le chemin source de l'empaqueté où il a été exécuté à l'origine. Ne sera défini que lorsque l'empaqueté s'exécute dans la salle propre. |
| WixBundleSourceProcessFolder | Le dossier source de l'empaqueté où il a été exécuté à l'origine. Ne sera défini que lorsque l'empaqueté s'exécute dans la salle propre. |
| WixBundleProviderKey | La clef du fournisseur de dépendances de l'empaqueté. |
| WixBundleTag | La chaîne de balise définie par le développeur pour cet empaqueté (à partir de Bundle/@Tag). |
| WixBundleUILevel | Le niveau de l'interface utilisateur (l'énumération BOOTSTRAPPER_DISPLAY). |
| WixBundleVersion | La version de cet empaqueté (à partir de Bundle/@Version). |
Dernière mise à jour : Mardi, le 13 juin 2023