Procédure pas à pas : déploiement manuel d'une application ClickOnce

Article
08/21/2008

Mise à jour : novembre 2007

Cette procédure pas à pas décrit les étapes nécessaires à la création d'un déploiement ClickOnce complet à l'aide de la version de ligne de commande ou graphique de l'outil Manifest Generation and Editing (Mage).

Si vous n'utilisez pas régulièrement Visual Studio, si vous devez automatiser le processus de déploiement ou utiliser des fonctionnalités de déploiement avancées telles que le déploiement d'applications approuvées, il est recommandé d'utiliser l'outil de ligne de commande Mage.exe pour créer vos manifestes ClickOnce. La procédure pas à pas suivante décrit toutes les étapes requises pour générer un déploiement ClickOnce complet à l'aide de la version de ligne de commande (Mage.exe) ou de la version Windows Forms (MageUI.exe) de l'outil Manifest Generation and Editing.

Composants requis

Cette procédure pas à pas a été écrite dans l'hypothèse où vous disposez d'une application Windows Forms prête à être déployée, nommée dans cet exemple WindowsFormsApp1. Vous devez également installer le Kit de développement logiciel (SDK) Windows.

Plusieurs décisions doivent être prises avant de créer un déploiement. Avant toute chose, vous devez décider du mode de distribution du déploiement : via le Web, à partir d'un partage de fichiers ou à partir d'un CD. Pour plus d'informations, consultez Vue d'ensemble du déploiement ClickOnce.

Ensuite, vous devez déterminer si votre application doit s'exécuter avec un niveau de confiance élevé. Comme indiqué dans Vue d'ensemble du déploiement d'applications approuvées, les applications ClickOnce s'exécutent dans une zone de confiance partielle et les autorisations dont elles disposent varient selon qu'elles sont hébergées dans un intranet ou sur Internet. Si une application doit accéder aux données de l'ordinateur client, communiquer avec des périphériques locaux, appeler des fonctions API Windows ou exécuter d'autres opérations susceptibles de présenter un risque de sécurité, elle doit déclarer un niveau de confiance plus élevé. Si votre application exige une confiance totale, par exemple, un accès complet au système de l'utilisateur, vous pouvez utiliser Mage.exe pour le définir facilement. Si vous souhaitez définir un jeu d'autorisations personnalisé pour votre application, vous pouvez copier la section des autorisations intranet ou Internet d'un autre manifeste, la modifier selon vos besoins et l'ajouter au manifeste d'application à l'aide d'un éditeur de texte ou de MageUI.exe.

Les deux méthodes de déclaration d'un niveau de confiance plus élevé dans un manifeste ClickOnce sont l'élévation d'autorisations et le déploiement d'applications approuvées. Dans les deux cas, votre déploiement doit être signé avec un certificat Authenticode généré avec l'outil MakeCert.exe ou obtenu auprès d'une autorité de certification (CA). Si vous choisissez d'utiliser le déploiement d'applications approuvées, vous devez également effectuer une installation unique du certificat sur tous les ordinateurs client. Pour plus d'informations, consultez Vue d'ensemble du déploiement d'applications approuvées.

Pour déployer une application avec l'outil de ligne de commande Mage.exe

Ouvrez une invite de commandes du Kit de développement logiciel (SDK) Windows et basculez vers le répertoire dans lequel vous souhaitez stocker vos fichiers ClickOnce.
Créez un répertoire dont le nom indique la version actuelle de votre déploiement. S'il s'agit du premier déploiement de l'application, choisissez par exemple 1.0.0.0.

Remarque :

La version de votre déploiement peut différer de la version de vos fichiers d'application.
Créez un sous-répertoire nommé bin et placez-y tous vos fichiers d'application, y compris les fichiers exécutables, les assemblys, les ressources et les fichiers de données.

Remarque :
La version de votre déploiement peut différer de la version de vos fichiers d'application.

Générez le manifeste d'application par un appel à Mage.exe :

mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin

Signez le manifeste d'application avec votre certificat numérique :
```
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
```
Générez le manifeste de déploiement par un appel à Mage.exe. Par défaut, Mage.exe marque votre déploiement ClickOnce comme une application installée, afin qu'elle puisse être exécutée à la fois en ligne et hors connexion. Pour que l'application soit uniquement accessible lorsque l'utilisateur est en ligne, utilisez l'indicateur -i avec la valeur f. Si vous utilisez la valeur par défaut et que les utilisateurs installent votre application à partir d'un site Web ou d'un partage de fichiers, assurez-vous que la valeur de l'indicateur -providerUrl pointe vers l'emplacement du manifeste d'application sur le serveur Web ou le partage.
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest -providerUrl http://www.adatum.com/WindowsFormsApp1/WindowsFormsApp1.application
```

Signez le manifeste de déploiement avec votre certificat :

mage -Sign WindowsFormsApp1.application -CertFile mycert.pfx

Copiez tous les fichiers dans le répertoire actif, y compris le dossier de version et le dossier \bin, vers la destination du déploiement. Il peut s'agir d'un dossier d'un site Web ou d'un site FTP, d'un partage de fichiers ou d'un CD.
Fournissez à vos utilisateurs l'URL, l'UNC ou le média physique requis pour installer votre application. Si vous fournissez une URL ou un UNC, vous devez communiquer aux utilisateurs le chemin d'accès complet au manifeste de déploiement. Si, par exemple, WindowsFormsApp1 est déployé sur http://webserver01/ dans le répertoire WindowsFormsApp1, le chemin d'accès complet de l'URL est http://webserver01/WindowsFormsApp1/WindowsFormsApp1.deploy.

Déploiement de l'application avec l'outil graphique MageUI.exe

Ouvrez une invite de commandes du Kit de développement logiciel (SDK) Windows et basculez vers le répertoire dans lequel vous souhaitez stocker vos fichiers ClickOnce.
Créez un sous-répertoire nommé bin et placez-y tous vos fichiers d'application, y compris les fichiers exécutables, les assemblys, les ressources et les fichiers de données.
Créez un sous-répertoire dont le nom indique la version actuelle de votre déploiement. S'il s'agit du premier déploiement de l'application, choisissez par exemple 1.0.0.0.

Remarque :

La version de votre déploiement peut différer de la version de vos fichiers d'application.
Déplacez le répertoire \bin dans le répertoire créé à l'étape 2 puis démarrez l'outil graphique :
```
MageUI.exe
```
Créez un nouveau manifeste d'application en sélectionnant Fichier, Nouveau, puis Manifeste d'application dans le menu.
Sous l'onglet Nom par défaut, entrez le nom et le numéro de version de ce déploiement.
Sélectionnez l'onglet Fichiers et cliquez sur le bouton Parcourir en regard de la zone de texte Répertoire d'application.
Sélectionnez le répertoire qui contient vos fichiers d'application créés à l'étape 2, puis cliquez sur OK dans la boîte de dialogue de sélection de dossier.
Cliquez sur le bouton Remplir pour ajouter tous vos fichiers d'application à la liste de fichiers. Si votre application contient plusieurs fichiers exécutables, marquez le fichier exécutable principal de ce déploiement comme application de démarrage en sélectionnant Point d'entrée dans la liste déroulante Type de fichier. (Si votre application ne contient qu'un seul fichier exécutable, MageUI.exe le marque pour vous.)
Sélectionnez l'onglet Autorisations requises et sélectionnez le niveau de confiance que votre application doit déclarer. La valeur par défaut est Confiance totale, laquelle convient à la plupart des applications.
Sélectionnez Fichier, puis Enregistrer dans le menu, et enregistrez le manifeste d'application. Vous êtes invité à signer le manifeste d'application lorsque vous l'enregistrez.
Si vous possédez un certificat stocké en tant que fichier dans votre système de fichiers, utilisez l'option Signer avec le fichier de certificat et sélectionnez le certificat dans le système de fichiers à l'aide du bouton de sélection ....

- ou -

Si votre certificat est conservé dans un magasin de certificats accessible à partir de votre ordinateur, sélectionnez l'option Signer avec le certificat stocké, puis choisissez le certificat dans la liste fournie.
Sélectionnez Fichier, Nouveau, Manifeste de déploiement dans le menu pour créer votre manifeste de déploiement, puis sous l'onglet Nom, indiquez un nom et un numéro de version (1.0.0.0 dans cet exemple).
Sélectionnez l'onglet Éditeur, puis spécifiez des valeurs pour Éditeur et Produit. (Produit est le nom donné à votre application dans le menu Démarrer de Windows lorsque vous installez votre application localement.)
Basculez vers l'onglet Mettre à jour, et spécifiez la fréquence de mise à jour souhaitée de cette application. Si votre application utilise l'API de déploiement de ClickOnce pour vérifier elle-même les mises à jour, désactivez la case à cocher intitulée Cette application doit rechercher des mises à jour.
Basculez vers l'onglet Référence d'application. Vous pouvez remplir préalablement toutes les valeurs sous cet onglet en cliquant sur le bouton Sélectionner un manifeste et en sélectionnant le manifeste d'application créé au cours des étapes précédentes.
Choisissez Enregistrer et enregistrez le manifeste de déploiement sur le disque. Vous êtes invité à signer le manifeste d'application lorsque vous l'enregistrez.
Si vous possédez un certificat stocké en tant que fichier dans votre système de fichiers, utilisez l'option Signer avec le fichier de certificat et sélectionnez le certificat dans le système de fichiers à l'aide du bouton de sélection ....

- ou -

Si votre certificat est conservé dans un magasin de certificats accessible à partir de votre ordinateur, sélectionnez l'option Signer avec le certificat stocké, puis choisissez le certificat dans la liste fournie.
Copiez tous les fichiers dans le répertoire actif, y compris le dossier de version et le dossier \bin, vers la destination du déploiement. Il peut s'agir d'un dossier d'un site Web ou d'un site FTP, d'un partage de fichiers ou d'un CD.
Fournissez à vos utilisateurs l'URL, l'UNC ou le média physique requis pour installer votre application. Si vous fournissez une URL ou un UNC, vous devez communiquer aux utilisateurs le chemin d'accès complet au manifeste de déploiement. Si, par exemple, WindowsFormsApp1 est déployé sur http://webserver01/ dans le répertoire WindowsFormsApp1, le chemin d'accès complet de l'URL est http://webserver01/WindowsFormsApp1/WindowsFormsApp1.deploy.

Remarque :
La version de votre déploiement peut différer de la version de vos fichiers d'application.

Étapes suivantes

Lorsque vous déployez une nouvelle version de l'application, vous devez créer un nouveau répertoire dont le nom fait référence à la nouvelle version, par exemple 1.1.0.0, et déplacer les nouveaux fichiers d'application dans un dossier \bin de ce nouveau répertoire. Vous devez générer un nouveau manifeste d'application, le stocker dans le nouveau répertoire et le faire signer par l'éditeur. Dès que vous avez récupéré le manifeste signé, vous pouvez utiliser Mage.exe pour mettre à jour le manifeste de déploiement et le faire pointer vers le nouveau manifeste d'application :

mage -Update WindowsFormsApp1.application -Version 1.1.0.0 -AppManifest 1.1.0.0\WindowsFormsApp1.exe.manifest

Les utilisateurs de MageUI.exe peuvent exécuter la même opération en ouvrant leur manifeste de déploiement, en sélectionnant l'onglet Référence d'application et en cliquant une nouvelle fois le bouton Sélectionner un manifeste.

Après avoir mis à jour la référence du manifeste d'application, vous devrez resigner le manifeste de déploiement dans la mesure où toute modification d'un manifeste rend sa signature numérique non valide.