Créer un fichier du programme d’installation d’application manuellement
Cet article explique comment créer manuellement un fichier App Installer qui définit un ensemble associé avec des fonctionnalités de mise à jour et de réparation automatiques. Un ensemble associé n’est pas une entité, mais plutôt une combinaison d’un package principal et de packages facultatifs.
Pour pouvoir installer un ensemble associé en tant qu’entité, nous devons être en mesure de spécifier le package principal et le package facultatif en tant qu’entité. Pour ce faire, nous devons créer un fichier XML avec une extension .appinstaller pour définir un ensemble associé. Le programme d’installation d’application utilise le fichier *.appinstaller et permet à l’utilisateur d’installer tous les packages définis en un seul clic.
Pendant le déploiement, le fichier App Installer effectue les opérations suivantes :
- Le package d’application Windows référencé dans l’attribut
URIde l’élément < MainPackage > valide les attributsName,PublisheretVersiondu package d’application Windows cible. Si l’élément Package/Identity du manifeste du package d’application Windows ne correspond pas, l’installation échoue. - Créez une référence aux URI de mise à jour et de réparation pour la famille du package.
Créer un fichier App Installer
Pour distribuer votre jeu associé en tant qu’entité, vous devez créer un fichier d’installation d’application qui contient les éléments requis par ce schéma d’installation d’application.
- Créez le *fichier .AppInstaller.
- Spécifiez les attributs du fichier App Installer.
- Spécifiez le package d’application Windows principal.
- Spécifiez le package facultatif du jeu associé.
- Spécifiez le package App Framework Windows de dépendance.
- Spécifiez les chemins d’accès de l’URI de mise à jour.
- Spécifiez les chemins de l’URI de réparation.
- Spécifiez le Paramètres de mise à jour.
Exemple de fichier App Installer
En suivant les étapes fournies ci-dessus, vous aurez créé un fichier App Installer qui ressemble à ce qui suit :
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2017/2"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<OptionalPackages>
<Bundle
Name="Contoso.OptionalApp1"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/OptionalApp1.msixbundle" />
<Bundle
Name="Contoso.OptionalApp2"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/OptionalApp2.msixbundle" />
<Package
Name="Fabrikam.OptionalApp3"
Publisher="CN=Fabrikam"
Version="10.34.54.23"
Uri="http://mywebservice.azurewebsites.net/OptionalApp3.msix"
ProcessorArchitecture="x64" />
</OptionalPackages>
<UpdateURIs>
<UpdateURI>http://mywebservice.azurewebsites.net/appset.appinstaller</UpdateURI>
<UpdateURI>http://mywebservice2.azurewebsites.net/appset.appinstaller</UpdateURI>
</UpdateURIs>
<RepairURIs>
<RepairURI>http://mywebservice.azurewebsites.net/appset.appinstaller</RepairURI>
<RepairURI>http://mywebservice2.azurewebsites.net/appset.appinstaller</RepairURI>
</RepairURIs>
<UpdateSettings>
<OnLaunch HoursBetweenUpdateChecks="0"/>
</UpdateSettings>
</AppInstaller>
Étape 1 : Créer le fichier *.appinstaller
À l’aide d’un éditeur de texte (Notepad.exe), créez un fichier avec une extension de nom de fichier de *. AppInstaller
Procédure :
- Ouvrez le menu Démarrer.
- Tapez la commande suivante :
notepad.exe. - Ouvrez le menu Fichier.
- Sélectionnez Enregistrer sous dans le menu déroulant.
Étape 2 : Ajouter le modèle de base
Incluez l’élément AppInstaller dans votre fichier App Installer notant la version, le chemin d’accès et l’emplacement réseau de votre fichier App Installer. Les informations contenues dans l’élément AppInstaller sont consommées lors de l’installation des applications Windows associées.
| Élément | Description |
|---|---|
| xmlns | Espace de noms XML |
| Version | Version du fichier Programme d’installation d’application dans une notation en pointillés quad (1.0.0.0). |
| URI | Chemin d’URI du fichier App Installer actuel, accessible par l’appareil. |
Procédure :
Ouvrez le fichier créé à l’étape 1.
Copiez le contenu XML suivant dans votre fichier *.AppInstaller.
<?xml version="1.0" encoding="utf-8"?> <AppInstaller xmlns="http://schemas.microsoft.com/appx/appinstaller/2021" Version="" Uri="" > </AppInstaller>Mettre à jour l’attribut
Versionavec la version de votre fichier App InstallerMettez à jour l’attribut
URIavec l’emplacement réseau à partir duquel ce fichier *.AppInstaller sera accessible.
Étape 3 : Ajouter les informations principales du package
Les <MainPackage> and <MainBundle> sont utilisées pour identifier l’application Windows principale qui sera installée à l’aide du fichier App Installer. Il <MainPackage> est utilisé lorsque le programme d’installation de l’application Windows est un *.msix ou *.appx. Utilisez le <MainBundle> lorsque le programme d’installation de l’application Windows est un programme d’installation d’application Windows groupé, avec une extension de *.msixbundle ou *.appxbundle.
| Élément | Description |
|---|---|
| Nom | Nom de l’application principale en cours de distribution via le fichier Programme d’installation d’application. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Name. |
| Serveur de publication | Nom canonique du certificat d’éditeur utilisé pour signer le programme d’installation de l’application Windows principale. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Publisher. |
| Version | Version du programme d’installation d’application Windows principal dans une notation en pointillés quad (1.0.0.0). Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Version. |
| ProcessorArchitecture | Architecture sur laquelle le programme d’installation d’application Windows principal est installé. |
| URI | Chemin d’URI du support d’installation de l’application Windows principale. |
Les informations contenues dans l’attribut <MainBundle> ou <MainPackage> doivent correspondre à l’élément Package/Identity du manifeste de bundle d’application ou du package de l’application, respectivement.
Programme d’installation de Windows ADK
Si le package d’application principal est un fichier .msix ou .appx, utilisez <MainPackage>, comme indiqué ci-dessous. Veillez à inclure processorArchitecture, car il est obligatoire pour les packages non groupés.
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainPackage
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
ProcessorArchitecture="x64"
Uri="http://mywebservice.azurewebsites.net/mainapp.msix" />
</AppInstaller>
Programme d’installation de l’ensemble d’applications Windows
Si le package d’application principale est un fichier .msixbundle ou .appxbundle, utilisez la valeur <MainBundle> à la place de <MainPackage>, comme indiqué ci-dessous. Pour les offres groupées, ProcessorArchitecture n’est pas obligatoire.
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
</AppInstaller>
Étape 4 : Ajouter les packages facultatifs
Comme pour l’attribut principal du package d’application, si le package facultatif peut être un package d’application ou un ensemble d’applications, l’élément enfant dans l’attribut <OptionalPackages> doit être <Package> ou <Bundle> respectivement. Les informations du package dans les éléments enfants doivent correspondre à l’élément d’identité dans le bundle ou le manifeste du package.
| Élément | Description |
|---|---|
| Nom | Nom de l’application facultative en cours de distribution via le fichier App Installer. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Name. |
| Serveur de publication | Nom canonique du certificat d’éditeur utilisé pour signer le programme d’installation facultatif de l’application Windows. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Publisher. |
| Version | Version du programme d’installation facultatif de l’application Windows dans une notation en pointillés quad (1.0.0.0). Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Version. |
| ProcessorArchitecture | Architecture sur laquelle le programme d’installation facultatif de l’application Windows est installé. |
| URI | Chemin d’URI du support d’installation de l’application Windows principale. |
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<OptionalPackages>
<Bundle
Name="Contoso.OptionalApp1"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/OptionalApp1.msixbundle" />
<Package
Name="Fabrikam.OptionalApp3"
Publisher="CN=Fabrikam"
Version="10.34.54.23"
ProcessorArchitecture="x64"
Uri="http://mywebservice.azurewebsites.net/OptionalApp3.msix" />
</OptionalPackages>
</AppInstaller>
Étape 5 : Ajouter des dépendances
Dans l’élément dépendances, vous pouvez spécifier les packages d’infrastructure requis pour le package principal ou les packages facultatifs.
| Élément | Description |
|---|---|
| Nom | Nom de l’application de dépendance en cours de distribution via le fichier Programme d’installation d’application. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Name. |
| Serveur de publication | Nom canonique du certificat d’éditeur utilisé pour signer le programme d’installation de l’application Windows de dépendance. Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Publisher. |
| Version | Version du programme d’installation d’applications Windows de dépendance dans une notation en pointillés quad (1.0.0.0). Pour ce faire, exécutez la cmdlet PowerShell suivante : $(Get-AppxPackage [AppName]).Version. |
| ProcessorArchitecture | Architecture sur laquelle le programme d’installation de l’application Windows de dépendance est installé. |
| URI | Chemin d’URI du support d’installation de l’application Windows de dépendance. |
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<Dependencies>
<Package
Name="Microsoft.VCLibs.140.00"
Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
Version="14.0.24605.0" ProcessorArchitecture="x86" Uri="http://foobarbaz.com/fwkx86.appx" />
<Package
Name="Microsoft.VCLibs.140.00"
Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
Version="14.0.24605.0"
ProcessorArchitecture="x64"
Uri="http://foobarbaz.com/fwkx64.appx" />
</Dependencies>
</AppInstaller>
Étape 6 : Ajouter un paramètre de mise à jour
Le fichier App Installer peut également spécifier le paramètre de mise à jour afin que les jeux associés puissent être mis à jour automatiquement lorsqu’un fichier d’installation d’application plus récent est publié. <UpdateSettings> est un élément facultatif. Dans <UpdateSettings> l’option OnLaunch spécifie que les vérifications de mise à jour doivent être effectuées lors du lancement de l’application, et HoursBetweenUpdateChecks="12" spécifie qu’une vérification de mise à jour doit être effectuée toutes les 12 heures. Si HoursBetweenUpdateChecks n’est pas spécifié, l’intervalle par défaut utilisé pour vérifier pour les mises à jour est de 24 heures. D’autres types de mises à jour, comme les mises à jour en arrière-plan, peuvent être trouvés dans le schéma Paramètres de mise à jour ; les autres types de mises à jour au lancement, comme les mises à jour avec une invite, peuvent être trouvés dans le schéma OnLaunch
| Éléments | Description |
|---|---|
| HoursBetweenUpdateChecks | Définit l’écart minimal dans les vérifications de mise à jour des applications Windows. |
| UpdateBlocksActivation | Définit l’expérience lorsque la mise à jour d’une application est vérifiée. |
| ShowPrompt | Définit si une fenêtre est affichée lorsque des mises à jour sont en cours d’installation et lorsque des mises à jour sont vérifiées. |
| ForceUpdateFromAnyVersion | Spécifie que la prochaine version de l’application peut être à une version plus récente ou antérieure. Si la valeur est « True », toutes les deux sont concernées. Si la valeur est « False » (valeur par défaut), seules les nouvelles versions sont installées. |
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<UpdateSettings>
<OnLaunch
HoursBetweenUpdateChecks="12"
UpdateBlocksActivation="true"
ShowPrompt="true" />
<AutomaticBackgroundTask />
<ForceUpdateFromAnyVersion>true</ForceUpdateFromAnyVersion>
</UpdateSettings>
</AppInstaller>
Étape 7 : Ajouter les paramètres de mise à jour automatique
Important
Les paramètres suivants sont disponibles uniquement lors de l’utilisation du schéma 2021 sur une build Windows Insider de Windows 10.
Les applications Windows installées avec un fichier App Installer mettent par défaut à jour leur application Windows à partir de l’URI App Installer, en respectant les configurations définies à l’étape précédente. Les URI de mise à jour configurés dans cette étape joueront le rôle d’URI de secours qui peuvent être utilisés si l’URI d’origine d’App Installer n’est plus accessible. Un maximum de 10 URI de mise à jour peut être configuré pour n’importe quelle application Windows.
L’URI de mise à jour doit cibler les fichiers App Installer.
Remarque
Ces paramètres fonctionnent uniquement lorsque le schéma est configuré en tant que version 2021 ou ultérieure.
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<UpdateSettings>
<OnLaunch
HoursBetweenUpdateChecks="12" />
</UpdateSettings>
<UpdateUris>
<UpdateUri>https://www.contoso.com/Installers/MainApp.AppInstaller</UpdateUri>
<UpdateUri>\\ServerName\Share\Installers\MainApp.AppInstaller</UpdateUri>
</UpdateUris>
</AppInstaller>
Étape 8 : Ajouter les paramètres de mise à jour automatique
Important
Les paramètres suivants sont disponibles uniquement lors de l’utilisation du schéma 2021 sur une build Windows Insider de Windows 10.
Les applications Windows installées sur un appareil peuvent prendre en charge la réparation automatique de l’application Windows lorsqu’elle a été falsifiée. Le programme d’installation source qui sera utilisé pour réparer l’application Windows peut être configuré à l’aide de la propriété <RepairURIs>. L’application Windows tente de se réparer elle-même en fonction de l’URI d’App Installer. Si elle n’est pas accessible, alors l’application Windows utilise l’URI de réparation pour identifier une source de réparation. Un maximum de 10 URI de réparation peut être configuré pour n’importe quelle application Windows.
L’URI de réparation peut cibler les fichiers de l’application Windows ou de l’App Installer. Ce paramètre ne nécessite pas que l’application Windows ait été installée à l’aide d’un fichier App Installer.
<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
Version="1.0.0.0"
Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >
<MainBundle
Name="Contoso.MainApp"
Publisher="CN=Contoso"
Version="2.23.12.43"
Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />
<UpdateSettings>
<OnLaunch
HoursBetweenUpdateChecks="12" />
</UpdateSettings>
<RepairUris>
<RepairUri></RepairUri>
<RepairUri></RepairUri>
</RepairUris>
</AppInstaller>
Pour plus d’informations sur le schéma XML, consultez la Référence du fichier App Installer.
Remarque
Le type de fichier App Installer est nouveau dans Windows 10, version 1709 (Windows 10 Fall Creators Update). Il n’existe aucune prise en charge du déploiement d’applications Windows 10 à l’aide d’un fichier App Installer sur les versions précédentes de Windows 10. L’élément HoursBetweenUpdateChecks est disponible à partir de Windows 10, version 1803.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour