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

Article
10/31/2023

Important

L’utilisation d’un fichier d’installation d’application incorporé est disponible dans Windows version 10.0.21300.0. Pour utiliser cette fonctionnalité, vérifiez que MaxVersionTested fait référence à cette version ou à une version plus récente du système d’exploitation Windows.

Le fichier Programme d’installation d’application 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 créer et publier votre application Windows avec un fichier App Installer intégré, vous devez vous assurer que le SDK 2104 de Windows 10 (ou plus récent) a été installé et que les propriétés du projet indiquent Windows 10 21H1 (ou plus récent) comme versions ciblées (MaxVersionTested et MinVersion). Si cela n’a pas été configuré, l’application Windows ne définit pas les configurations appInstaller incorporées sur l’appareil lors de l’installation de l’application Windows.

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 programme d’installation d’application incorporée.

Remarque

Les conseils suivants supposent que vous avez précédemment créé le fichier Programme d’installation d’application à l’aide de Visual Studio pour automatiser la création d’un fichier de programme d’installation d’application, à l’aide du kit de ressources MSIX ou manuellement. Pour obtenir des conseils sur la création d’un fichier programme d’installation d’application, consultez l’un des articles de documentation suivants :

Ouvrir l’application Windows pour la modification

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

Lancez l’outil d’empaquetage Microsoft MSIX (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, localisez votre application Windows, puis sélectionnez le bouton Ouvrir .
Sélectionnez le bouton Ouvrir le package.

Importer le fichier du programme d’installation d’application 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 à l’intérieur de la fenêtre de l’invite, accédez au fichier du programme d’installation de l’application et sélectionnez le bouton Ouvrir.
Sélectionnez le bouton Enregistrer.

Mettre à jour appxManifest

Les étapes suivantes vous guideront tout au long de la mise à jour d’AppxManifest pour qu’il pointe vers le fichier Du programme d’installation d’application 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 package.
Sélectionnez le bouton Ouvrir le fichier pour ouvrir appxManifest dans une fenêtre du Bloc-notes.

Vérifiez que les propriétés <Package> incluent les espaces de noms et les espaces de noms ignorés 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> incluez les paramètres enfants et <uap13:AutoUpdate> suivants :

<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 de fichier du programme d’installation d’application est « Update.appinstaller ».

Fermer et empaqueter l’application Windows

Les étapes suivantes vous guident 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 exigences de votre organization ou client.

Dans l’outil d’empaquetage MSIX sélectionnez le bouton Enregistrer.
Dans la fenêtre à l’invite, sélectionnez le bouton Oui, Incrémenter .
Accédez à l’emplacement dans lequel 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, assurez-vous que vous travaillez sur un appareil Windows 10 avec le Windows 10 SDK 2104 ou supérieur installé. Ce Kit de développement logiciel (SDK) est requis pour s’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 de l’application

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

Dans votre projet Visual Studio, 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, puis sélectionnez le bouton Ajouter.
Dans l’Explorateur de solutions, double-cliquez sur Update.appinstaller pour ouvrir le fichier pour révision.
Vérifiez que le fichier programme d’installation de l’application est correct, puis fermez le fichier.

Mettre à jour d’AppxManifest

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

Ce guide part du principe que :

Le Windows 10 SDK 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 du programme d’installation d’application est Update.appinstaller

Dans votre projet Visual Studio, sélectionnez Générer dans le menu supérieur.
Sélectionnez Générer la solution dans le menu déroulant. Assurez-vous que la génération de l’application Windows a réussi.
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.