Déploiement d'une solution Office à l'aide de Windows Installer
Apprenez comment créer un fichier Windows Installer (.msi) de votre solution d' Office 2013 ou d' Office 2010 à l'aide de Visual Studio 2012.
À l'aide de Visual Studio 2012 pour créer un fichier Windows Installer, vous pouvez déployer une solution d' Office 2013 ou d' Office 2010 qui requiert l'accès d'administration sur l'ordinateur de l'utilisateur final.Par exemple, vous pouvez utiliser un tel fichier pour installer les utilisateurs d'une solution qu'une seule fois pour chaque d'un ordinateur.Vous pouvez également déployer une solution Office à l'aide de ClickOnce, mais cette solution doit être installé séparément pour chaque utilisateur de l'ordinateur.
Pour afficher une liste complète des différences entre le déploiement de déploiement Windows Installer et ClickOnce, consultez Choix d'une stratégie de déploiement.
Dans cette rubrique
Téléchargez les exemples
Édition d'InstallShield Limited get
Déterminez comment accorder un niveau de confiance à la solution
Créez un projet d'installation
Ajoutez la sortie de projet
Ajoutez le déploiement et des manifestes d'application
Configurez les modules subordonnés comme composants requis
Spécifier où installer la solution sur l'ordinateur de l'utilisateur
Configure an add-in
Configurez une personnalisation au niveau de le document
Générez le projet d'installation
Pour plus d'informations sur le déploiement d'une solution Office à l'aide de ClickOnce, consultez Déploiement d'une solution Office à l'aide de ClickOnce.
Pour plus d'informations sur la création d'un fichier Windows Installer à l'aide de Visual Studio 2010, consultez Déploiement de Visual Studio 2010 tools pour la solution Office à l'aide de windows installer.
Téléchargez les exemples
Cette rubrique font référence aux exemples téléchargeables suivants.
Exemples |
Description |
---|---|
Un complément Excel que vous pouvez installer sur un ordinateur qui exécute une version de 32 bits ou 64 bits Office. |
|
Une personnalisation au niveau de le document Excel que vous pouvez installer sur un ordinateur qui exécute une version de 32 bits ou 64 bits Office. |
Déterminez comment accorder un niveau de confiance à la solution
Avant qu'une solution puisse fonctionner sur les ordinateurs d'utilisateur, vous devez approuver dans ou des façons suivantes, ou les utilisateurs doivent répondre à une invite d'approbation lorsqu'ils installent la solution.
Signer les manifestes à l'aide d'un certificat qui identifie un et un éditeur approuvé.Pour plus d'informations, consultez La confiance à la solution lors de la signature de l'application et les manifestes de déploiement.
Installez la solution dans le répertoire program files sur l'ordinateur de l'utilisateur.
[!REMARQUE]
Pour les personnalisations au niveau de le document, l'emplacement du document doit également être approuvé.Pour plus d'informations, consultez Octroi de niveaux de confiance à des documents.
Édition d'InstallShield Limited get
Vous pouvez créer un fichier Windows Installer à l'aide de InstallShield Limited (ÎLE), qui est libre si vous avez installé Visual Studio.L'ÎLE remplace les fonctionnalités des modèles de projet pour l'installation et le déploiement que les versions antérieures de Visual Studio sont proposés.
Pour obtenir InstallShield Limited
Dans la barre de menus, sélectionnez Fichier, Nouveau, Project.
La boîte de dialogue Nouveau projet s'affiche.
Dans le volet modèles, développez Autres types de projets, puis choisissez le modèle Configuration et déploiement .
Dans la liste des types de projet pour Configuration et déploiement, choisissez Activer InstallShield Limited Edition, puis choisissez le bouton OK .
Une page qui fournit des informations sur l'obtention InstallShield Limited.
Dans cette page, cliquez sur le lien Ouvrez le site Web de téléchargement .
Sur la page de téléchargement de InstallShield Limited, entrez les informations requises dans les champs appropriés, puis cliquez sur le lien Télécharger .
Une fois que vous avez téléchargé, installer, et lancé le produit, le modèle Projet d'édition d'InstallShield Limited apparaît dans Visual Studio.
Créez un projet d'installation
Dans Visual Studio, ouvrez le projet Office à déployer.
Les exemples de complément d'application qui sont associés à cette rubrique contient un projet nommé ExcelAddIn.Les exemples de personnalisation au niveau de le document contient un projet nommé ExcelWorkbook.Cette rubrique se rapportera au projet Office dans votre solution à l'aide de l'un de ces deux noms.
Dans la barre de menus, cliquez sur Fichier, Ajouter, Nouveau projet.
La boîte de dialogue Ajouter un nouveau projet s'ouvre.
Dans le volet modèles, développez Autres types de projets, puis choisissez le modèle Configuration et déploiement .
Dans la liste des types de projet pour Configuration et déploiement, choisissez Projet d'édition d'InstallShield Limited, nommez le projet, puis choisissez le bouton OK .
Le projet d'installation d'InstallShield que vous venez de créer s'affiche dans votre solution.
Les exemples de cette rubrique contient un projet d'installation nommé OfficeAddInSetup.Cette rubrique se rapportera au projet d'installation dans votre solution en utilisant le même nom.
Ajoutez la sortie de projet
Vous configurez le projet d' OfficeAddInSetup pour inclure la sortie de votre projet Office.Pour les projets de complément d'application, la sortie de projet est l'assembly de solution uniquement.Pour les projets de personnalisation au niveau de le document, la sortie de projet inclut non seulement l'assembly de solution mais également le document lui-même.
Pour ajouter la sortie de projet
Dans Explorateur de solutions, développez le nœud du projet d' OfficeAddInSetup, puis sélectionnez le fichier Assistant au projet, le montre l'illustration suivante.
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
En bas de la page Assistant au projet, choisissez le bouton Fichiers d’application, le montre l'illustration suivante.
Dans la page Fichiers d’application, choisissez le bouton Ajouter les sorties du projet .
Dans la boîte de dialogue Sélecteur de sortie de Visual Studio, activez la case à cocher Sortie principale, puis choisissez le bouton OK .
Ajoutez le déploiement et des manifestes d'application
Dans la page Fichiers d’application, choisissez le bouton Ajouter des fichiers .
Dans la boîte de dialogue Ouvrir, accédez au répertoire de sortie du projet d' ExcelAddIn .
Généralement, le répertoire de sortie est un sous-dossier de bin\version finale du répertoire racine du projet, selon la configuration de build que vous choisissez.
Dans le répertoire de sortie, choisissez les fichiers d' ExcelAddIn.vsto et d' ExcelAddIn.dll.manifest, puis choisissez le bouton Ouvrir .
La page Fichiers d’application contient maintenant le fichier de sortie de projet, le manifeste de déploiement, et le manifeste de l'application, comme le présente l'illustration suivante.
Configurez les modules subordonnés comme composants requis
Dans votre application d'installation, vous devez inclure non seulement les composants suivants mais également tous les autres composants requis pour que votre solution puisse être exécutée.
La version du .NET Framework que votre solution Office cible.
Microsoft Visual Studio 2010 tools pour Office Runtime.
Ajoutez le .NET Framework 4 ou .NET Framework 4,5 en tant que composant requis
Dans Explorateur de solutions, développez le nœud du projet d' OfficeAddInSetup, développez le nœud Spécifiez les données d'application, puis sélectionnez le fichier Composants redistribuables, le montre l'illustration suivante.
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
La page Composants redistribuables s'ouvre.
Dans la liste de composants redistribuables approprié, activez la case à cocher pour la version .NET Framework que votre solution cible.
Par exemple, si votre solution cible .NET Framework 4.5, activez la case à cocher Microsoft .NET Framework 4,5 % .Une boîte de dialogue peut s'avérer demandante si vous souhaitez installer le composant redistribuable, d'InstallShield exige avant de pouvoir ajouter le composant comme composant requis.Si cette boîte de dialogue ne s'affiche pas, le composant existe déjà sur votre ordinateur.
Si cette boîte de dialogue s'affiche, cliquez sur le bouton Oui pour télécharger le composant redistribuable.
[!REMARQUE]
Un message d'erreur peut indiquer que le téléchargement a échoué.Vous pouvez généralement ignorer cette erreur.Pour vérifier si vous avez correctement téléchargé le fichier, accédez au dossier suivant sur votre ordinateur :
Pour les systèmes d'exploitation 32 bits : %ProgramFiles%InstallShield 2012SpringLE\\\SetupPrerequisites\Microsoft.réseauVersion\\\FullOrClient
Pour les systèmes d'exploitation 64 bits : %ProgramFiles (x86) %InstallShield 2012SpringLE\\\SetupPrerequisites\Microsoft.réseauVersion\\\FullOrClient
Si le fichier n'est pas dans non plus de ces dossiers, vous devez le télécharger et le placer dans le répertoire approprié.
Pour télécharger le .NET Framework 4, consultez https://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe
Pour télécharger le client.NET Framework 4, consultez https://download.microsoft.com/download/5/6/2/562A10F9-C9F4-4313-A044-9C94E0A8FAC8/dotNetFx40_Client_x86_x64.exe
Pour télécharger le .NET Framework 4,5, consultez https://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/
[!REMARQUE]
Pour localiser l'URL d'une condition préalable répertoriée dans la page Composants redistribuables, ouvrez le fichier approprié de .prq d' %ProgramFiles%InstallShield 2012SpringLE\\\SetupPrerequisites\sur votre ordinateur.Dans chaque fichier de .prq, l'URL s'affiche dans l'attribut d' URL de l'élément d' <file> .
Ajoutez Visual Studio 2010 tools pour Office Runtime
La page Composants redistribuables contient un élément nommé Runtime Microsoft VSTO 2010, mais il fait référence à une version antérieure du runtime.Par conséquent, vous devez créer manuellement un fichier de configuration qui fait référence à la version la plus récente.Vous devez ensuite mettre ce fichier dans le même répertoire que les fichiers de configuration pour tous les autres éléments qui apparaissent dans la page Composants redistribuables .
Pour ajouter Visual Studio 2010 tools pour Office Runtime en tant que composant requis
Ouvrez le bloc-notes, puis collez XML suivant dans un fichier texte.
<?xml version="1.0" encoding="UTF-8"?> <SetupPrereq> <conditions> <condition Type="32" Comparison="2" Path="HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4R" FileName="Version" ReturnValue="10.0.40303" Bits="2"></condition> </conditions> <files> <file LocalFile="<ISProductFolder>\SetupPrerequisites\VSTOR\vstor_redist.exe" URL="https://go.microsoft.com/fwlink/?LinkId=140384" CheckSum="b6639489e159b854b6dc43d5cb539043" FileSize="0,40023024"></file> </files> <execute file="vstor_redist.exe" returncodetoreboot="1641,3010" requiresmsiengine="1"> </execute> <properties Id="Your GUID goes here" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." > </properties> </SetupPrereq>
Génère un GUID à l'aide de le programme Générateur de GUID sur votre ordinateur.
Pour localiser le programme Générateur de GUID sur votre ordinateur, ouvrez le menu Démarrer et le type Concepteur de GUID dans la zone de recherche.
Dans le programme Générateur de GUID, sélectionnez la case d'option Format de Registre, choisissez le bouton Copier, puis choisissez le bouton Quitter .
Dans le bloc-notes, remplacez le texte Your GUID goes here collant GUID à la place.
L'élément d' <properties> de votre fichier ressemble au code ci-dessous.
<properties Id="{87989B73-21DC-4403-8FD1-0C68A41A6D8C}" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." > </properties>
Dans la barre de menus dans le bloc-notes, choisissez Fichier, Enregistrer.
Dans la boîte de dialogue Enregistrer sous, accédez à votre dossier Bureau .
Dans la liste Type de fichier, choisissez Tous les fichiers (*.*).
Dans la zone Nom de fichier, entrez Visual Studio 2010 tools pour Office Runtime.prq, puis choisissez le bouton Enregistrer .
[!REMARQUE]
Assurez-vous que vous ajoutez .prq à la fin de le nom de fichier pour identifier ce fichier en tant que nécessaire.
Fermez le Bloc-notes.
De votre dossier Bureau, copiez Visual Studio 2010 tools pour le fichier Office Runtime.prq à l'un des répertoires suivants sur votre ordinateur.
Pour les systèmes d'exploitation 32 bits : %ProgramFiles%InstallShield 2012SpringLE\\\\ SetupPrerequisites
Pour les systèmes d'exploitation 64 bits : %ProgramFiles (x86) %InstallShield 2012SpringLE\\\\ SetupPrerequisites
Dans la page Redistribuable du projet InstallShield, choisissez le bouton Actualiser pour actualiser la liste de composants redistribuables, comme le présente l'illustration suivante.
Dans la liste de composants redistribuables, activez la case à cocher Visual Studio 2010 Tools pour Office Runtime .
Une boîte de dialogue peut s'avérer demandante si vous souhaitez installer le composant redistribuable.Si cette boîte de dialogue ne s'affiche pas, vous pouvez passer à la section de Spécifier où installer la solution sur l'ordinateur de l'utilisateur de cette rubrique.
Si cette boîte de dialogue s'affiche, cliquez sur le bouton Oui pour télécharger le composant redistribuable.
-
[!REMARQUE]
Un message d'erreur peut indiquer que le téléchargement a échoué.Vous pouvez ignorer cette erreur.Pour vérifier si vous avez correctement téléchargé le fichier, accédez au dossier suivant sur votre ordinateur :
Pour les systèmes d'exploitation 32 bits : %ProgramFiles%InstallShield 2012SpringLE\\\SetupPrerequisites\\ VSTOR
Pour les systèmes d'exploitation 64 bits : %ProgramFiles (x86) %InstallShield 2012SpringLE\\\SetupPrerequisites\\ VSTOR
Important
InstallShield peut avoir téléchargé une version antérieure du runtime.Pour vous assurer que vous disposez de la dernière version, téléchargez la dernière version de Visual Studio 2010 tools pour Office Runtime de Le Centre de téléchargement Microsoft, puis placez -la dans le dossier approprié.
Spécifier où installer la solution sur l'ordinateur de l'utilisateur
Dans Explorateur de solutions, développez le nœud OfficeAddInSetup, développez le nœud Planifiez votre installation, puis sélectionnez le fichier Informations générales .
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
Dans la liste de propriétés, cliquez sur le bouton Parcourir en regard de la propriété InstallDir .
Dans la boîte de dialogue Définissez INSTALLDIR, choisissez un dossier sur l'ordinateur de l'utilisateur dans lequel vous souhaitez installer la solution.
[!REMARQUE]
Vous pouvez également créer des sous-répertoires dans la boîte de dialogue Définissez INSTALLDIR en ouvrant le menu contextuel pour n'importe quel dossier dans la liste.
Configurez un complément d'application
Cette section s'applique uniquement si you'redeploying un complément d'application.Si vous déployez une personnalisation au niveau de le document, vous pouvez passer immédiatement à Configurez une personnalisation au niveau de le document la section.
Vous devez créer des clés de Registre pour permettre à l'application Office de découvrir et de charger le complément.L'emplacement de la clé de Registre dépend de l'application Office.Pour plus d'informations, consultez Entrées du Registre pour les compléments d'application.
Pour configurer le Registre
Dans Explorateur de solutions, développez le nœud du projet d' OfficeAddInSetup, développez le nœud Planifiez votre installation, puis sélectionnez le fichier Informations générales .
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
Les propriétés du projet d'installation s'affichent.
Dans la liste pour la propriété AllUSERS, spécifiez si vous souhaitez que cette solution à installer pour tous les utilisateurs de l'ordinateur ou uniquement pour l'utilisateur qui installe la solution.
Pour installer la solution pour tous les utilisateurs, choisissez ALLUSERS=1 (installation de chaque ordinateur).
Dans Explorateur de solutions, sélectionnez le nœud Assistant au projet .
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
En bas de la page Assistant au projet, choisissez le bouton Registre d'application, le montre l'illustration suivante.
La page Registre d'application s'affiche.
Sous Voulez-vous configurer les données de Registre que votre application sera installé ?, sélectionnez la case d'option Oui .
Dans la liste L'affichage de Registre de l'ordinateur de destination, choisissez HKEY_USER_SELECTABLE.
Le dossier HKEY_USER_SELECTABLE est installé dans la ruche de Registre appropriée selon ce que vous avez choisi pour la propriété ALLUSERS précédemment dans cette procédure.Si vous définissez cette propriété à ALLUSERS=1 (installation de chaque ordinateur), votre solution est installée dans la ruche de Registre HKEY_LOCAL_MACHINE.
Ouvrez le menu contextuel pour le dossier HKEY_USER_SELECTABLE, choisissez Nouveau, puis choisissez Clé.
Un dossier nommé Nouvelle clé n°1 apparaît sous le dossier HKEY_USER_SELECTABLE .
Renommez le nouveau dossier SOFTWARE.
Ouvrez le menu contextuel pour le dossier SOFTWARE, choisissez Nouveau, puis choisissez Clé.
Un dossier nommé Nouvelle clé n°1 apparaît sous le dossier SOFTWARE .
Renommez le nouveau dossier Microsoft, puis continuer à créer des sous-dossiers jusqu'à ce qu'ils représentent la hiérarchie principale entière.
La hiérarchie principale entière est HKEY_USER_SELECTABLE\Software\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.
Si vous créez un programme d'installation pour les versions 64 bits Office, la hiérarchie complète est HKEY_USER_SELECTABLE\Software\Wow6432Node\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.
L'illustration suivante montre la hiérarchie des clés lorsque vous avez terminé cet exercice.
[!REMARQUE]
Comme meilleure pratique, démarrez le nom de votre complément par le nom de votre société.Cette convention augmente le niveau de probabilité que la clé sera seule et diminue la possibilité de conflit avec un complément d'un autre fournisseur.Les compléments qui ont le même nom peut, par exemple, remplacer les clés de chacun d'inscription.Cette approche ne peut pas garantir que la clé sera seule mais peut réduire des collisions de noms potentielles.
Ouvrez le menu contextuel pour la clé SampleCompany.ExcelAddIn, choisissez Nouveau, puis choisissez Valeur de chaîne.
La nouvelle valeur de chaîne s'affiche dans la liste les données de Registre de l'ordinateur de destination .Le nom de la valeur de chaîne est mis en surbrillance afin que vous puissiez la renommer.
Renommez la valeur à la description.
Répétez ce processus pour créer les valeurs suivantes.
Type valeur
Nom
Valeur de chaîne
FriendlyName
DWORD
LoadBehavior
Valeur de chaîne
Manifeste
Ouvrez le menu contextuel pour la valeur Description, puis choisissez Modifier.
La boîte de dialogue Modifier les données s'affiche.
Dans la zone de texte Données de la valeur, entrez le complément de démonstration excel, puis choisissez le bouton OK .
Cette description s'affiche lorsque l'utilisateur ouvre l'application Office, ouvre la boîte de dialogue Options, puis, dans le volet de Macros complémentaires, choisit le complément.
Ouvrez le menu contextuel pour la valeur Nom convivial, puis choisissez Modifier.
La boîte de dialogue Modifier les données s'affiche.
Dans la zone de texte Données de la valeur, entrez le complément de démonstration excel, puis choisissez le bouton OK .
Cette chaîne s'affiche dans la boîte de dialogue Compléments COM dans l'application Office.Par défaut, la valeur de la chaîne est l'ID du complément
Ouvrez le menu contextuel pour la valeur LoadBehavior, puis choisissez Modifier.
La boîte de dialogue Modifier les données s'affiche.
Dans la zone de texte Données de la valeur, entrez 3, puis choisissez le bouton OK .
Une valeur de 3 charge le complément lorsque l'application démarre.Pour plus d'informations sur les valeurs de LoadBehavior, consultez Entrées du Registre pour les compléments d'application.
Ouvrez le menu contextuel pour la valeur Manifeste, puis choisissez Modifier.
La boîte de dialogue Modifier les données s'affiche.
Dans la zone de texte Données de la valeur, entrez file:///[INSTALLDIR]ExcelAddIn.vsto|vstolocal, puis choisissez le bouton OK .
Visual Studio 2010 tools pour Office Runtime utilise ce chemin d'accès pour localiser le manifeste de déploiement.La partie d' [INSTALLDIR] de ce chemin d'accès est un qui mappe à INSTALLDIR la propriété dans la page de propriétés Informations générales de votre projet d'installation d'InstallShield.Cette propriété spécifie l'emplacement sur l'ordinateur cible pour installer le complément.Le suffixe d' |vstolocal garantit que votre solution est débitée du dossier d'installation, pas le cache ClickOnce.
L'illustration suivante montre comment les valeurs apparaissent après avoir terminé cet exercice.
Important
Si vous créez une zone de formulaire personnalisée dans un complément pour Outlook, vous devez créer des entrées du Registre pour stocker la zone d'Outlook.Pour plus d'informations, consultez Entrées de Registre pour des zones de formulaire Outlook.
Configurez une personnalisation au niveau de le document
Cette section s'applique uniquement si vous déployez une personnalisation au niveau de le document.Si vous déployez un complément d'application, vous pouvez passer immédiatement à la section de Générez le projet d'installation .
Les personnalisations au niveau de le document n'utilisent pas les clés de Registre.À la place, les propriétés de document personnalisées contiennent l'emplacement du manifeste de déploiement.
Pour modifier les propriétés personnalisées, vous créez un programme qui supprime la personnalisation au niveau de le document, modifie les propriétés appropriées, puis rattache la personnalisation au document.Vous créez ensuite une action personnalisée qui lance le programme, et vous ajoutez cette action à votre projet d'installation.
Pour créer un programme qui modifie les propriétés du document
Dans la barre de menus, cliquez sur Fichier, Ajouter, Nouveau projet.
La boîte de dialogue Ajouter un nouveau projet s'affiche.
Dans le volet modèles, sous le nœud pour le langage que vous souhaitez utiliser, sélectionnez le dossier Fenêtres .
Dans la liste des types de projet pour Fenêtres, choisissez le modèle Application console .
Nommez le projet SetExcelDocumentProperties, puis choisissez le bouton OK .
Dans Explorateur de solutions, choisissez le bouton Afficher tous les fichiers, ouvrez le menu contextuel du nœud de projet de SetExcelDocumentProperties, puis choisissez Ajouter une référence.
Dans la boîte de dialogue Gestionnaire de références, sélectionnez l'onglet de Extensions, puis activez la case à cocher en regard de les assemblys suivants, puis choisissez le bouton OK .
Microsoft.VisualStudio.Tools.Applications.Runtime
Microsoft.VisualStudio.Tools.Applications.ServerDocument
Dans Explorateur de solutions, sélectionnez le fichier Program.cs (pour les applications de c) ou le fichier Module1.vb (pour les applications Visual Basic).
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
Remplacez le contenu du fichier complet par le code suivant.
Imports Microsoft.VisualStudio.Tools.Applications.Runtime Imports Microsoft.VisualStudio.Tools.Applications Module Module1 Sub Main() Dim assemblyLocation As String = "" Dim solutionID As Guid Dim deploymentManifestLocation As Uri = Nothing Dim documentLocation As String = "" Dim nonpublicCachedDataMembers As String() = Nothing Dim CommandLineArgs As _ System.Collections.ObjectModel.ReadOnlyCollection(Of String) = _ My.Application.CommandLineArgs For i As Integer = 0 To CommandLineArgs.Count - 1 Console.WriteLine(CommandLineArgs(i)) Dim oArugment As String() = CommandLineArgs(i).Split("=") Select Case oArugment(0) Case "/assemblyLocation" assemblyLocation = oArugment(1) Case "/deploymentManifestLocation" If Not Uri.TryCreate(oArugment(1), UriKind.Absolute, _ deploymentManifestLocation) Then MsgBox("Error creating URI") End If Case "/documentLocation" documentLocation = oArugment(1) Case "/solutionID" solutionID = Guid.Parse(oArugment(1)) End Select Next Try ServerDocument.RemoveCustomization(documentLocation) ServerDocument.AddCustomization(documentLocation, assemblyLocation, _ solutionID, deploymentManifestLocation, _ True, nonpublicCachedDataMembers) Console.WriteLine("Insallation Location Modified Successfully") Catch ex As System.IO.FileNotFoundException Console.WriteLine("The specified document does not exist.") Console.ReadLine() Catch ex As System.IO.IOException Console.WriteLine("The specified document is read-only.") Console.ReadLine() Catch ex As InvalidOperationException Console.WriteLine("The customization could not be removed.\n" & ex.Message) Console.ReadLine() Catch ex As DocumentNotCustomizedException Console.WriteLine("The document could not be customized.\n" & ex.Message) Console.ReadLine() End Try End Sub End Module
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using Microsoft.VisualStudio.Tools.Applications.Runtime; using Microsoft.VisualStudio.Tools.Applications; namespace SetExcelDocumentProperties { class Program { static void Main(string[] args) { string assemblyLocation = ""; Guid solutionID = new Guid(); Uri deploymentManifestLocation = null; string documentLocation = ""; string[] nonpublicCachedDataMembers = null; for (int i = 0; i <= args.Count() - 1; i++) { Console.WriteLine(args[i]); string[] oArugment = args[i].Split('='); switch (oArugment[0]) { case "/assemblyLocation": assemblyLocation = oArugment[1]; break; case "/deploymentManifestLocation": if (!Uri.TryCreate(oArugment[1], UriKind.Absolute, out deploymentManifestLocation)) { Console.WriteLine("Error creating URI"); } break; case "/documentLocation": documentLocation = oArugment[1]; break; case "/solutionID": solutionID = Guid.Parse(oArugment[1]); break; } } try { ServerDocument.RemoveCustomization(documentLocation); ServerDocument.AddCustomization(documentLocation, assemblyLocation, solutionID, deploymentManifestLocation, true, out nonpublicCachedDataMembers); } catch (System.IO.FileNotFoundException) { Console.WriteLine("The specified document does not exist."); } catch (System.IO.IOException) { Console.WriteLine("The specified document is read-only."); } catch (InvalidOperationException ex) { Console.WriteLine("The customization could not be removed.\n" + ex.Message); } catch (DocumentNotCustomizedException ex) { Console.WriteLine("The document could not be customized.\n" + ex.Message); } } } }
Compilez le projet.
Pour ajouter une action personnalisée qui exécute votre programme
Dans Explorateur de solutions, développez le nœud du projet d' OfficeAddInSetup, puis sélectionnez le fichier Assistant au projet, le montre l'illustration suivante.
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
En bas de la page Assistant au projet, choisissez le bouton Fichiers d’application, le montre l'illustration suivante.
Dans la page Fichiers d’application, choisissez le bouton Ajouter les sorties du projet .
La boîte de dialogue Sélecteur de sortie de Visual Studio s'affiche.
Sous le nœud SetExcelDocumentProperties, activez la case à cocher Sortie principale, puis choisissez le bouton OK .
Dans Explorateur de solutions, sous le nœud OfficeAddInSetup, développez le nœud Définir des spécifications et les actions d'installation, puis sélectionnez le dossier Actions personnalisées .
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
Une liste d'événements s'affichent dans un volet à gauche de l'écran.
[!REMARQUE]
Seuls certains événements qui apparaissent dans cette liste sont disponibles dans la version d'InstallShield Limited.Dans cette procédure, vous lancerez le programme à l'aide de l'événement Après l'installation complétez la boîte de dialogue de succès .
Dans la liste des événements, sous Actions personnalisées pendant l'installation, ouvrez le menu contextuel pour l'événement Après l'installation complétez la boîte de dialogue de succès, puis choisissez Nouvel EXE.
Une action personnalisée nommée NewCustomAction1 apparaît sous l'événement Après l'installation complétez la boîte de dialogue de succès .Un ensemble de propriétés pour l'action personnalisée s'affiche dans un volet en regard de les événements.
Important
Deux événements Après l'installation complétez la boîte de dialogue de succès s'affichent dans la liste d'événements.Assurez-vous que vous choisissez l'instance de l'événement Après l'installation complétez la boîte de dialogue de succès qui apparaît sous le nœud Actions personnalisées pendant l'installation .
Dans la liste pour la propriété Emplacement source, choisissez Installés avec le produit.
Choisissez le bouton Parcourir en regard de la propriété Nom de fichier .
Dans la boîte de dialogue Recherchez un fichier de destination, accédez au fichier SetExcelDocumentProperties.Primary.output, puis choisissez le bouton Ouvrir .
L'emplacement de ce fichier dépend du dossier que vous avez spécifié pour la propriété InstallDir du projet d'installation.Par exemple, si vous définissez cette propriété à un dossier nommé [PersonalFolder] DemoWorkbookApp, vous pouvez rechercher le fichier SetExcelDocumentProperties.Primary.output par le recherche à [ProgramFilesFolder] de DemoWorkbookApp \.
Dans les étapes à venir, vous obtenez l'ID de solution de le document puis passerez cet ID comme paramètre à l'application console.Vous passerez l'emplacement du document, du manifeste de déploiement, et l'assembly de document.
Ouvrez le menu contextuel pour l'application pour le projet d' ExcelWorkbook, puis choisissez Ouvrir le dossier dans l'Explorateur Windows ou Ouvrir le dossier dans l'Explorateur de fichiers selon le système d'exploitation.
Le dossier qui contient votre solution s'ouvre.
Ouvrez le fichier projet de votre solution dans le bloc-notes.Pour les projets Visual Basic, le nom de fichier est ExcelWorkbook.vbproj.Pour les projets de c, le nom de fichier est ExcelWorkbook.csproj.
Dans le fichier projet, rechercher l'élément d' <SolutionID>, copiez la valeur au presse-papiers, puis fermez le bloc-notes.
Vous passez cette valeur dans l'application console comme paramètre.
Dans la page de propriétés NewCustomAction1, affectez à la propriété Ligne de commande à la ligne suivante de texte.
/assemblyLocation="[INSTALLDIR]ExcelWorkbook.dll" /deploymentManifestLocation="[INSTALLDIR]ExcelWorkbook.vsto" /documentLocation="[INSTALLDIR]ExcelWorkbook.xlsx" /solutionID="Your Solution ID"
Remplacez Your Solution ID par l'ID de solution que vous avez copié dans le presse-papiers.
Important
Examinez votre programme d'installation pour vérifier que l'application console que cette action personnalisée s'exécute peut accéder à des documents dans le dossier [INSTALLDIR] .Certains dossiers sur l'ordinateur de l'utilisateur peuvent nécessiter un accès administratif (par exemple, le répertoire program files).Si vous déployez votre solution à un dossier qui requiert l'accès d'administration, vous devez ouvrir la boîte de dialogue Propriétés du fichier setup.exe, sélectionnez l'onglet de Compatibilité, puis activez la case à cocher Exécutez ce programme en tant qu'administrateur avant de distribuiez le programme d'installation.Si vous ne souhaitez pas que les utilisateurs pour exécuter le programme d'installation avec des autorisations d'administration, affectez à la propriété [INSTALLDIR] vers un répertoire auquel l'utilisateur a probablement déjà accès, tels que le répertoire Documents .Pour plus d'informations, consultez la section Spécifier où installer la solution sur l'ordinateur de l'utilisateur de cette rubrique.
Générez le projet d'installation
Dans Explorateur de solutions, développez le nœud Préparer à la version finale, puis sélectionnez le fichier Libérations .
Dans la barre de menus, sélectionnez Afficher, Ouvrir.
L'explorateur Builds s'ouvre dans un volet latéral afin de pouvoir sélectionner le type de version finale que vous souhaitez créer.
Dans l'explorateur Builds, sélectionnez le dossier SingleImage .
Dans le volet situé en regard de l'explorateur Builds, choisissez Install.Exe tableau.
Dans la page de propriétés Install.Exe, dans la liste Emplacement de composants requis d'InstallShield, choisissez Récupère Setup.exe.
Dans la barre de menus, sélectionnez Build, Gestionnaire de configurations.
Dans la liste Configuration de la solution active, choisissez SingleImage.
Dans le tableau Contextes de projet, dans la colonne Configuration du projet d' OfficeAddInSetup, choisissez SingleImage, puis choisissez le bouton Fermer .
Dans la barre de menus, sélectionnez Build, Génération OfficeAddInSetup.
Une fois la génération terminée, vous pouvez rechercher le fichier setup.exe du projet d' OfficeAddInSetup à l'emplacement suivant : OfficeAddInSetupProjectRoot\OfficeAddInSetup\Express\SingleImage\DiskImages\DISK1\
Voir aussi
Référence
Entrées du Registre pour les compléments d'application
Concepts
Vue d'ensemble des propriétés de document personnalisées
Octroi de niveaux de confiance à des solutions Office
Octroi de niveaux de confiance à des documents
Autres ressources
Composants requis pour les solutions Office en vue du déploiement
Déploiement d'une solution Office
Déploiement de Visual Studio 2010 tools pour la solution Office à l'aide de windows installer