Déploiement de solutions Office

Article
08/10/2011

Vous pouvez déployer des solutions Office à l'aide des technologies de déploiement ClickOnce ou Windows Installer (MSI). Les solutions Office utilisent ClickOnce tel qu'il est implémenté dans Visual Studio Tools pour Office Runtime et .NET Framework 3.5. Cela diffère légèrement des fonctionnalités disponibles dans les applications Windows Forms, qui utilisent uniquement les fonctionnalités de .NET Framework. ClickOnce est conçu pour simplifier le déploiement et la maintenance car les solutions ClickOnce sont installées avec des privilèges d'utilisateur.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour Microsoft Office 2010 et la version 2007 de Microsoft® Office System. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Si vous utilisez Windows Installer pour distribuer vos fichiers, vous devez malgré tout répondre aux conditions de sécurité de Visual Studio Tools pour Office Runtime et ClickOnce avant que les utilisateurs puissent exécuter vos solutions Microsoft Office. Pour plus d'informations sur le modèle de sécurité des solutions Office, consultez Sécurisation des solutions Office.

Le principal avantage de l'utilisation de Windows Installer est la possibilité de déployer des solutions Office pour tous les utilisateurs, plutôt que pour l'utilisateur actuel uniquement. Pour plus d'informations sur le déploiement des solutions Office avec Windows Installer, consultez Déploiement d'une solution Office à l'aide de Windows Installer.

Pour des informations générales sur ClickOnce, consultez Sécurité et déploiement ClickOnce.

Le processus de déploiement implique les considérations suivantes :

Spécifications de solution Office.
Déploiement d'une solution Office.
Installation d'une solution Office.
Mise à jour d'une solution Office.
Déploiement pendant le développement.
Cache ClickOnce.

Spécifications de solution Office

Avant que vos solutions Microsoft Office ne puissent être exécutées, certains composants doivent être installés sur l'ordinateur, tel que le .NET Framework 3.5 et Visual Studio Tools pour Office Runtime. Vous pouvez souvent déployer ces composants avec votre solution. Pour obtenir la liste des composants requis, consultez Composants requis pour les solutions Office en vue du déploiement et Comment : installer les composants requis sur les ordinateurs des utilisateurs finaux pour exécuter des solutions Office.

De plus, vous devez envisager comment déterminer le niveau de confiance des solutions. Pour plus d'informations sur la sécurité, consultez Sécurisation des solutions Office.

Déploiement d'une solution Office

Lorsque vous déployez une solution Office, vous pouvez utiliser l'Assistant Publication ou la page de propriétés Publier pour configurer les paramètres de déploiement suivants :

Numéro de version.
Composants requis.
Intervalles de mise à jour.

Une fois ces paramètres de déploiement configurés, Visual Studio publie les fichiers de solution vers l'emplacement de publication.

Si vous effectuez le déploiement à l'aide d'un CD ou d'un lecteur amovible, conservez le champ Emplacement d'installation vide et attribuez le paramètre Jamais à Mises à jour. Pour plus d'informations, consultez Comment : déployer une solution Office à l'aide de ClickOnce et Publication de solutions Office.

Installation d'une solution Office.

Après avoir copié la solution dans l'emplacement d'installation, les utilisateurs finaux peuvent la télécharger et l'installer. Vous pouvez installer des solutions de plusieurs manières : en exécutant le programme d'installation, en ouvrant le manifeste de déploiement (fichier .vsto) ou en ouvrant le document. Pour plus d'informations, consultez Comment : installer une solution Office ClickOnce et Comment : désinstaller une solution Office ClickOnce.

Si vos utilisateurs installent la solution en ouvrant le manifeste de déploiement, vous devrez peut-être configurer le Serveur IIS pour qu'il reconnaisse le type MIME .vsto. Pour plus d'informations, consultez Comment : préparer IIS pour le déploiement de solutions Office.

Déploiement avancé

Si vous souhaitez créer un programme d'installation personnalisé pour votre solution Office, vous pouvez exécuter directement le programme d'installation de la solution Office (VSTOInstaller.exe). Pour plus d'informations, consultez Personnalisation de l'installation de la solution Office.

Vous pouvez également déployer vos projets au niveau du document et au niveau de l'application dans un package unique et les solutions combinées peuvent être installées et désinstallées comme un groupe. Par exemple, si votre société de logiciels Contoso développe un complément Outlook et une feuille de calcul Excel, vous pouvez les installer et désinstaller ensemble comme solutions Office Contoso via Ajout/Suppression de programmes dans Windows XP ou Programmes et fonctionnalités dans Windows Vista. Pour plus d'informations, consultez Procédure pas à pas : déploiement de plusieurs solutions Office en un seul programme d'installation ClickOnce pour .NET Framework 4.

Si vous devez exécuter des actions supplémentaires après l'installation, vous pouvez personnaliser votre installation dans un processus appelé action de post-déploiement. Par exemple, vous pouvez copier des documents ou des classeurs vers l'ordinateur de l'utilisateur final, créer des clés de Registre supplémentaires ou modifier un fichier de configuration. Pour plus d'informations, consultez Procédure pas à pas : copie d'un document sur l'ordinateur de l'utilisateur final après une installation ClickOnce.

Mise à jour d'une solution Office

Vous pouvez configurer une solution pour qu'elle recherche des mises à jour à des intervalles spécifiés et qu'elle les installe automatiquement. Le paramètre par défaut pour les mises à jour automatiques est tous les sept jours. Une fois cet intervalle défini et la solution installée, l'intervalle ne peut pas être modifié sans installer une mise à jour. Si vos utilisateurs souhaitent forcer une mise à jour en dehors d'intervalles de mise à jour réguliers, la solution Office peut être mise à jour manuellement.

Vous pouvez déployer des mises à jour à l'aide de l'Assistant Publication. Cet Assistant génère un nouveau manifeste de l'application et copie les fichiers solution dans les mêmes emplacements de publication que la version antérieure. Les mises à jour sont facultatives et les utilisateurs peuvent annuler toute mise à jour de solution pendant l'étape de téléchargement et exécuter le complément.

L'action de publication met également à jour le manifeste de déploiement afin qu'il pointe sur l'emplacement de la nouvelle version de la solution. Lorsque la solution installée de l'utilisateur final recherche ensuite des mises à jour selon l'intervalle spécifié, elle télécharge et installe la version déployée la plus récente. Vous pouvez mettre à jour des versions d'une solution en mettant à jour les manifestes et les fichiers solution à l'emplacement de déploiement. Pour plus d'informations, consultez Comment : mettre à jour des solutions Office déployées.

Pour revenir à une version précédente d'une solution Office, consultez Comment : restaurer une version antérieure d'une solution Office ClickOnce.

Dans le cas où l'emplacement de publication a changé, le chemin d'accès peut être modifié dans le programme d'installation sans revenir à Visual Studio pour utiliser la page Assistant Publication ou Publier du Concepteur de projets. Pour plus d'informations, consultez Comment : modifier le chemin d'installation d'une solution Office.

Vous pouvez modifier manuellement les manifestes d'application et de déploiement dans les solutions Office. Les manifestes d'application et de déploiement doivent être de nouveau signés après leur modification, à l'aide de l'outil Manifest Generation and Editing (mage.exe et mageui.exe). Pour plus d'informations, consultez Comment : modifier des propriétés de déploiement.

Déploiement pendant le développement

Si vous testez votre complément d'application en publiant et en installant la solution sur votre ordinateur de développement, désinstallez celle-ci avant de la publier à nouveau ou d'apporter davantage de modifications au code et d'effectuer un nouveau test en appuyant sur F5. Lorsque vous installez une solution publiée, l'assembly du complément est installé dans le cache ClickOnce. Le programme d'installation crée également des clés de Registre de manière à permettre à l'application Office de rechercher et de charger l'assembly. Dans la mesure où la régénération de la solution met à jour les clés de Registre, vous devez désinstaller la première version avant de publier ou d'exécuter la deuxième.

Pour tester votre déploiement sur votre ordinateur de développement, créez un autre compte d'utilisateur pour installer et tester le complément d'application.

Si vous développez plusieurs solutions Office, tous les compléments Office s'exécutent parce qu'une génération est considérée comme une installation. Nous vous recommandons d'exécuter la commande Nettoyer la solution du menu Génération avant de fermer une solution.

Cache ClickOnce

Les solutions Office ClickOnce sont installées dans le cache de l'application ClickOnce ou le Global Assembly Cache (GAC). Le cache ClickOnce est une famille de répertoires masqués qui contient tous les fichiers de la solution, y compris les assemblys, les fichiers de configuration, les paramètres de l'application et les paramètres utilisateur, et les répertoires de données. Les solutions Office ClickOnce utilisent le même cache que les applications ClickOnce Windows Forms. Des liaisons vers d'autres emplacements réseau ou Internet peuvent être ouvertes pendant que vous travaillez à partir du cache ClickOnce, et la solution mise en cache peut également fonctionner en mode hors connexion. Pour les personnalisations au niveau du document, celui-ci n'est pas installé dans le cache de ClickOnce et peut être situé sur l'ordinateur d'un utilisateur ou sur un partage de fichiers réseau. Pour plus d'informations sur le cache ClickOnce, consultez Vue d'ensemble du cache ClickOnce.

Vous pouvez également stocker des assemblys dans le GAC. Si vos solutions Office doivent exécuter une action de post-déploiement (PDA) après chaque installation, vous pouvez stocker l'action de post-déploiement dans le GAC. Par exemple, les actions de post-déploiement qui doivent être exécutées après l'installation de chaque modèle Visio peuvent être stockées dans le GAC.

Migration des données lors de la mise à jour de solutions

Les solutions Office migrent les données locales en mémoire cache d'une version à l'autre pendant la mise à jour.

Si vous exécutez une instance d'une version antérieure d'une solution pendant une mise à jour, toute modification que vous apportez aux données mises en cache dans l'instance exécutée pendant la mise à jour n'est pas migrée. Pour vous assurer de la migration correcte des données, fermez toutes les instances d'une solution avant de la mettre à jour.

Fichier de données

Les fichiers avec les extensions .xml, .mdb et .mdf sont copiés automatiquement vers le répertoire de données d'application. Vous ne pouvez pas configurer ces fichiers de données à l'aide de la boîte de dialogue Fichiers d'application. Pour trouver le répertoire de données, utilisez la propriété DataDirectory. Pour plus d'informations, consultez Accès aux données locales et distantes dans les applications ClickOnce.

Pour rechercher par réflexion vos fichiers dans un autre répertoire, appelez la méthode GetExecutingAssembly, puis utilisez les propriétés CodeBase ou EscapedCodeBase pour obtenir le chemin d'accès au répertoire. Vous pouvez alors utiliser le chemin qualifié complet pour trouver vos fichiers.