Partager via

Déploiement de compléments d'application (Office System 2003)

  • Article

Mise à jour : novembre 2007

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

  • Projets au niveau de l'application

Version de Microsoft Office

  • Microsoft Office 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Le déploiement d'un complément Microsoft Office 2003 créé à l'aide Visual Studio Tools pour Office implique généralement l'utilisation des fichiers suivants :

  • L'assembly complémentaire principal, ainsi que tout assembly dépendant, notamment des ressources, des satellites ou des bibliothèques d'assistance

  • Le manifeste d'application

  • Le manifeste de déploiement (si applicable)

Lors du déploiement de votre solution, tenez compte des instructions de base suivantes :

Pour déployer le complément, exécutez les étapes suivantes :

  • Copiez le manifeste d'application créé par le processus de génération et les entrées de Registre requises sur chaque ordinateur client.

  • Copiez les assemblys de complément (et, facultativement, le manifeste de déploiement) à l'emplacement du déploiement.

L'emplacement de déploiement peut être un dossier local sur l'ordinateur client, ou un emplacement distant, notamment un partage réseau. Pour plus d'informations, consultez Modèles de déploiement (Office System 2003) et Comment : déployer des solutions Office (Office System 2003).

Remarque :

Aucune option de déploiement ne permet à l'utilisateur final d'utiliser la boîte de dialogue Compléments COM dans des applications Microsoft Office 2003 pour installer un complément créé à l'aide de Visual Studio Tools pour Office.

Utilisation du projet d'installation

Lorsque vous créez un projet de complément à l'aide de Visual Studio Tools pour Office, un projet d'installation est automatiquement ajouté à la solution. Si vous souhaitez déployer directement votre solution sur l'ordinateur client, vous pouvez utiliser ce projet pour générer un fichier Windows Installer (.msi). Le programme d'installation copie les fichiers de solution sur l'ordinateur client et crée les entrées de Registre requises pour exécuter le complément. Pour plus d'informations sur le projet d'installation, consultez Projets d'installation pour les compléments d'application (Office System 2003). Pour plus d'informations sur les entrées de Registre requises, consultez Entrées du Registre pour les compléments d'application.

Limitations du projet d'installation

Le projet d'installation par défaut présente plusieurs limitations :

  • Par défaut, le projet d'installation ne définit pas la stratégie de sécurité. La confiance totale doit être accordée à l'assembly de complément et à tous les assemblys référencés pour le complément à exécuter. Vous pouvez ajouter une étape supplémentaire au projet d'installation afin de configurer la stratégie de sécurité ou demander à l'administrateur de définir celle-ci. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

  • Par défaut, le projet d'installation ne vérifie pas, ou n'installe pas, le runtime de Visual Studio Tools pour Office et l'assembly PIA (Primary Interop Assembly) pour l'application Microsoft Office. Si ces composants ne sont pas installés sur l'ordinateur de l'utilisateur final, le complément ne s'exécute pas. Pour plus d'informations sur les composants requis, consultez Comment : préparer les ordinateurs des utilisateurs finaux à exécuter des solutions Office (Office System 2003).

Utilisation de l'Assistant Publication

Si vous souhaitez activer les mises à jour automatiques des assemblys, vous pouvez utiliser l'Assistant Publication. Celui-ci crée un manifeste de déploiement pour la solution et copie tous les fichiers requis à l'emplacement de déploiement.

La commande Publier disponible dans le menu contextuel du projet dans l'Explorateur de solutions démarre l'Assistant Publication. Il vous suffit d'identifier l'emplacement du dossier dans lequel vous souhaitez publier la solution. L'Assistant y copiera alors le manifeste de déploiement. L'Assistant copie également les assemblys et un manifeste d'application mis à jour dans un sous-dossier du dossier de déploiement principal. Le nom du sous-dossier contient un numéro de version. Si l'option Incrémenter auto. la révision avec chaque version est sélectionnée dans le volet Publier du Concepteur de projets, un nouveau sous-dossier est créé chaque fois que vous publiez la solution. Les versions antérieures restent disponibles. Les manifestes d'application et de déploiement permettent de s'assurer que la solution utilise systématiquement l'assembly approprié. Pour plus d'informations, consultez les rubriques Manifestes d'application et de déploiement dans les solutions Office, Comment : déployer des fichiers solution à l'aide de l'Assistant Publication (Office System 2003) et Publier, page du Concepteur de projets (Office System 2007).

Limitations de l'Assistant Publication

L'Assistant Publication présente plusieurs limitations :

  • L'Assistant Publication ne crée pas les entrées de Registre requises pour l'exécution du complément. Si vous utilisez cet Assistant pour déployer un complément, vous devez créer ces entrées de Registre vous-même (par exemple, en utilisant un fichier de Registre (.reg)). L'Assistant Publication ne remplace et ne supprime pas non plus les entrées du Registre créées sur l'ordinateur de développement lorsque vous générez votre projet. Pour plus d'informations sur la génération de projets, consultez Vue d'ensemble du processus de génération de solutions Office. Pour plus d'informations sur les entrées de Registre requises, consultez Entrées du Registre pour les compléments d'application.

  • L'Assistant Publication n'accorde pas une confiance totale à l'assembly de complément dans la stratégie de sécurité de l'utilisateur final. La confiance totale doit être accordée à l'assembly de complément et à tous les assemblys référencés pour le complément à exécuter. Pour plus d'informations, consultez Spécifications de sécurité pour exécuter des solutions Office (Office System 2003).

Mise à jour d'assemblys déployés (suivi des versions)

Si vous déployez une solution nommée OutlookAddin1 dans le dossier C:\DeployFolder, la structure de fichiers présentera l'aspect suivant :

C:\DeployFolder

Ce dossier contient le fichier et le sous-dossier suivants :

  • Le manifeste de déploiement (OutlookAddin1.application).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Ce dossier contient les fichiers suivants :

    • Les assemblys.

    • Le manifeste d'application (OutlookAddin1.dll.manifest).

    • Une copie du manifeste de déploiement.

Si vous mettez à jour l'assembly et republiez la solution, la structure de répertoires présentera l'aspect suivant :

C:\DeployFolder

Ce dossier contient le fichier et les sous-dossiers suivants :

  • Le manifeste de déploiement (mis à jour pour pointer sur le manifeste d'application consigné dans C:\DeployFolder\OutlookAddin1_1.0.0.1).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Ce dossier contient les fichiers suivants :

    • Les assemblys d'origine.

    • Le manifeste d'application d'origine.

    • Le manifeste de déploiement d'origine.

    C:\DeployFolder\OutlookAddin1_1.0.0.1

    Ce dossier contient les fichiers suivants :

    • Les assemblys mis à jour.

    • Le manifeste d'application mis à jour.

    • Une copie du manifeste de déploiement mis à jour.

Cette structure est répétée chaque fois que vous mettez à jour l'assembly de complément.

Utilisation de MSBuild à partir de la ligne de commande

Vous pouvez également utiliser MSBuild dans une invite de commandes pour publier votre solution. Lorsque vous utilisez MSBuild dans une invite de commandes, vous pouvez publier vos fichiers solution à un emplacement donné et, simultanément, modifier le manifeste de déploiement et le manifeste d'application mis à jour pour qu'ils pointent sur un emplacement différent. Pour exécuter MSBuild dans une invite de commandes pour publier votre solution, utilisez la syntaxe suivante :

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Par exemple, si vous souhaitez publier un projet C# nommé OutlookAddin1 dans le dossier partagé \\PublishServer\PublishFolder, mais que vous prévoyez de déplacer ultérieurement le manifeste de déploiement, le manifeste d'application mis à jour et l'assembly de complément dans le dossier \\DeploymentServer\DeploymentFolder, vous exécuterez la commande suivante :

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

Pour plus d'informations sur l'utilisation de MSBuild dans une invite de commandes, consultez Génération d'applications ClickOnce à partir de la ligne de commande.

Déploiement de compléments sous Windows Vista

Si les utilisateurs finaux exécutent votre solution sous Windows Vista, vous devrez prendre en compte les restrictions de sécurité de Windows Vista lorsque vous configurez le déploiement. Sinon, les utilisateurs ne seront pas en mesure d'installer les mises à jour.

Si vous utilisez l'Assistant Publication pour publier des mises à jour de complément sur un emplacement HTTP ou réseau, les utilisateurs finaux travaillant sur des ordinateurs qui fonctionnent sous Windows Vista pourront uniquement charger des mises à jour d'assembly aux conditions suivantes :

  • Le manifeste d'application est installé dans un dossier de l'ordinateur de l'utilisateur final susceptible d'être modifié par une application disposant d'autorisations standard.

    - ou -

  • L'utilisateur exécute l'application Microsoft Office avec des autorisations d'administrateur.

Lorsque vous publiez une mise à jour d'un complément, le runtime de Visual Studio Tools pour Office essaie de copier le manifeste d'application mis à jour sur l'ordinateur de l'utilisateur final la prochaine fois que l'utilisateur ouvre l'application. Le runtime utilise ensuite les informations contenues dans le manifeste mis à jour pour charger l'assembly mis à jour. Sous Windows Vista, les applications exécutées avec des autorisations standard ne peuvent pas écraser les fichiers de certains dossiers, dont %ProgramFiles%. Par conséquent, si le manifeste d'application est installé dans un dossier exigeant des autorisations d'administrateur, l'application pourra uniquement charger l'assembly mis à jour si l'utilisateur lance l'application en tant qu'administrateur. L'utilisateur peut également lancer l'application avec des autorisations standard si le manifeste d'application est installé dans un dossier qui ne requiert pas d'autorisations d'administrateur, tel que %UserProfile%.

Remarque :

Par défaut, le projet d'installation créé avec les projets de complément installe le manifeste d'application dans le dossier %CommonProgramFiles%.

Manifestes d'application et de déploiement

Les manifestes d'application et de déploiement permettent à un complément de se mettre à jour automatiquement avec l'assembly le plus récent. Pour plus d'informations, consultez Manifestes d'application et de déploiement dans les solutions Office.

Vous pouvez modifier le manifeste d'application ou de déploiement à plusieurs reprises pour une même solution pendant la durée de vie de cette dernière. Deux raisons principales justifient la mise à jour des manifestes :

Voir aussi

Concepts

Déploiement de solutions Office (Office System 2003)

Projets d'installation pour les compléments d'application (Office System 2003)

Projets d'installation et de déploiement

Référence

Entrées du Registre pour les compléments d'application