Utilisation d’un fichier d’installation d’application incorporé pour mettre à jour votre application

2025-04-30

Important

L’utilisation d’un fichier App Installer incorporé est disponible dans Windows version 10.0.21300.0. Pour utiliser cette fonctionnalité, assurez-vous que MaxVersionTested référence cette version ou une version plus récente du système d’exploitation Windows.

Le fichier App Installer fournit un chemin de mise à jour qu’une application Windows peut parcourir la recherche de mises à jour et de réparations.

Lorsque vous utilisez Visual Studio pour générer et publier votre application Windows avec un fichier App Installer incorporé, vous devez vous assurer que le Kit de développement logiciel (SDK) Windows 10 2104 (ou version ultérieure) a été installé et que les propriétés du projet ont Windows 10 21H1 (ou version ultérieure) comme versions cibles (MaxVersionTested et MinVersion). S’il n’a pas été configuré, l’application Windows ne définit pas les configurations AppInstaller incorporées sur l’appareil lorsque l’application Windows est installée.

Guide pratique pour l’outil d’empaquetage MSIX

Les étapes suivantes vous guident tout au long de l’utilisation de l’outil d’empaquetage MSIX pour modifier une application Windows préexistante afin d’inclure une application d’installation d’application incorporée.

Remarque

Les instructions suivantes supposent que vous avez précédemment créé le fichier App Installer à l’aide de Visual Studio pour automatiser la création d’un fichier d’installation d’application, avec l’utilisation de MSIX Toolkit ou manuellement. Pour obtenir des conseils sur la création d’un fichier d’installation d’application, consultez l’un des articles docs suivants :

Ouvrir l’application Windows pour modification

Les étapes suivantes vous guideront tout au long de l’utilisation de l’application Microsoft MSIX Packaging Tool pour commencer à modifier une application Windows.

Lancez l’outil Microsoft MSIX Packaging Tool (disponible dans le Microsoft Store : outil d’empaquetage MSIX).
Sélectionnez le bouton éditeur de package pour modifier un package existant.
Sélectionnez le bouton Parcourir , puis, dans la fenêtre d’invite, recherchez votre application Windows et sélectionnez le bouton Ouvrir .
Sélectionnez le bouton Ouvrir le package .

Importer le fichier App Installer dans l’application Windows

Les étapes suivantes vous guident tout au long de l’incorporation d’un fichier App Installer dans une application Windows préexistante à l’aide de l’application Microsoft MSIX Packaging Tool. Ces étapes supposent que vous avez déjà ouvert votre application Windows pour modification à l’aide de l’application Microsoft MSIX Packaging Tool.

Sur le côté gauche de l’outil d’empaquetage MSIX, sélectionnez Fichiers de package.
Développez l’entrée Package à l’intérieur de l’arborescence.
Cliquez avec le bouton droit sur Package et sélectionnez Ajouter un fichier dans le menu déroulant.
Sélectionnez le bouton Parcourir dans la fenêtre d'invite, naviguez jusqu'au fichier du programme d'installation de l'application, puis sélectionnez le bouton Ouvrir.
Sélectionnez le bouton Enregistrer.

Mettre à jour appxManifest

Les étapes suivantes vous guident tout au long de la mise à jour d’AppxManifest pour pointer vers le fichier App Installer précédemment ajouté à l’application Windows.

Sur le côté gauche de l’outil d’empaquetage MSIX, sélectionnez Informations sur le package.
Faites défiler jusqu’au bas de la section informations sur le forfait.
Sélectionnez le bouton Ouvrir un fichier pour ouvrir AppxManifest dans une fenêtre bloc-notes.

Vérifiez que les propriétés <Package> incluent les espaces de noms et les espaces de noms ignorables suivants :

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">

À l’intérieur de <Properties> les paramètres <uap13:AutoUpdate> et enfants suivants doivent être inclus :

<Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>

Enregistrez les modifications que vous avez apportées à AppxManifest.
Fermez la fenêtre du Bloc-notes AppxManifest et revenez à l’outil d’empaquetage MSIX.

Remarque

Les instructions ci-dessus supposent que le nom du fichier Du programme d’installation d’application est « Update.appinstaller ».

Fermer et empaqueter l’application Windows

Les étapes suivantes vous guideront tout au long de l’empaquetage de votre application Windows en tant que version plus récente. Ces étapes supposent que vous avez configuré vos préférences de signature pour répondre aux besoins de votre organisation ou client.

Dans l’outil d’empaquetage MSIX , sélectionnez le bouton Enregistrer .
Dans la fenêtre contextuelle, sélectionnez le bouton Oui, Incrémenter.
Accédez à l’emplacement où vous souhaitez enregistrer votre application Windows nouvellement mise à jour, puis sélectionnez le bouton Enregistrer .
Cliquez sur le bouton Fermer.
Fermez la fenêtre Outil d’empaquetage MSIX .

Guide pratique pour Visual Studio

Avant de commencer, vérifiez que vous travaillez sur un appareil Windows 10 avec le Kit de développement logiciel (SDK) Windows 10 2104 ou version ultérieure installé. Ce Kit de développement logiciel (SDK) est requis pour vous assurer que les propriétés Version cible et Version minimale sont définies avec les valeurs appropriées lorsque vous générez votre application.

Incorporer le fichier du programme d’installation d’application

Les étapes suivantes vous guideront tout au long de l’incorporation de votre fichier App Installer dans votre projet Visual Studio (UWP) d’application Windows.

Dans votre projet Visual Studio, dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom de votre application Windows.
Sélectionnez Ajouter un>>élément existant dans le menu déroulant.
Accédez à votre fichier Programme d’installation d’application, sélectionnez-le et sélectionnez le bouton Ajouter .
Dans l’Explorateur de solutions, double-cliquez sur Update.appinstaller pour ouvrir le fichier à réviser.
Vérifiez que le fichier du programme d’installation de l’application est correct et fermez le fichier.

Mise à jour d’AppxManifest

Les étapes suivantes fournissent des conseils sur la mise à jour d’AppxManifest dans votre projet Visual Studio pour cibler le fichier du programme d’installation d’application nouvellement incorporé.

Ce guide suppose :

Le Kit de développement logiciel (SDK) Windows 10 2104 ou version ultérieure est installé
Les propriétés du projet sont définies pour cibler Windows 10, version 2104 ou ultérieure.
Le nom du fichier de l'installateur d'applications est Update.appinstaller

Dans votre projet Visual Studio, sélectionnez Générer dans le menu supérieur.
Sélectionnez Générer une solution dans le menu déroulant. Vérifiez que la build de l’application Windows réussit.
Sélectionnez Ordinateur local dans le ruban pour tester les fonctionnalités de l’application Windows.
Fermez l’application Windows peu après son lancement et arrêtez le débogage.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Package.appxmanifest
Sélectionnez Afficher le code dans le menu déroulant.

Vérifiez que les propriétés <Package> incluent les espaces de noms et les espaces de noms ignorables suivants :

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">

À l’intérieur de <Properties> les paramètres <uap13:AutoUpdate> et enfants suivants doivent être inclus :

<Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>

Enregistrez vos modifications dans le fichier, puis fermez.

Création de votre application Windows

Les étapes suivantes vous guideront tout au long de la création du package d’application Windows pour l’installation sur les systèmes d’exploitation pris en charge.

Dans votre projet Visual Studio, cliquez avec le bouton droit sur le nom de l’application Windows.
Sélectionnez Publier>>des packages d’application... dans le menu déroulant.
Sélectionnez le bouton radio Téléchargement latéral dans la boîte de dialogue Créer des paquets d’application.
Cliquez sur le bouton Suivant.
Sélectionnez le bouton radio Oui, utiliser le certificat actuel :.
Importez un certificat existant ou générez automatiquement un certificat pour signer votre application Windows.
Cliquez sur le bouton Suivant.
Spécifiez la configuration de la solution, la version et la build facultative d’un bundle d’applications Windows pour votre application Windows.
Cliquez sur le bouton Créer.