Partager via


Procédure pas - à - pas : déployer un VSPackage

Dans cette procédure pas - à - pas, vous pouvez examiner une méthode de base pour déployer un VSPackage.

Mise en route

Utilisez deux ordinateurs pour cette procédure pas - à - pas, comme suit :

  • Un ordinateur de développement qui a Visual Studio et Kit de développement logiciel Visual Studio est installé.

  • Un ordinateur cible qui a Visual Studio installé mais n'a pas Kit de développement logiciel Visual Studio est installé.

Notes

Si vous avez un seul ordinateur, vous pouvez développer et déployer sur le même ordinateur.Toutefois, si vous le faites, vous ne pouvez pas nettoyer la base de registres à l'aide de l'utilitaire réinitialisez l'instance expérimentale de Visual Studio 2010 .Si vous avez le Virtual PC installé sur l'ordinateur, vous pouvez déployer vers une image virtuel.

Pour exécuter cette procédure, vous devez installer Kit de développement logiciel Visual Studio 2010. Pour plus d'informations sur le kit de développement Visual Studio, consultez Étendre la présentation de Visual Studio. Pour savoir comment télécharger le kit de développement Visual Studio, consultez Visual Studio Extensibility Developer Center sur le site Web MSDN.

Emplacements du modèle de projet de package Visual Studio

Le modèle de projet de package Visual Studio se trouve dans trois emplacements différents dans la boîte de dialogue Nouveau projet :

  1. Sous l'extensibilité Visual Basic. Le langage par défaut du projet est en Visual Basic.

  2. Sous l'extensibilité c#. Le langage par défaut du projet est c#.

  3. Sous d'autres projets contenus l'extensibilité. Le langage par défaut du projet est en C++.

créer un VSPackage de base

Tout d'abord, créez un VSPackage de base à déployer. Ce VSPackage ouvre immédiatement une boîte de dialogue en réponse à une commande de menu.

pour créer un VSPackage de base

  1. Créez un VSPackage nommé DeployPackage avec le modèle de projet de package Visual Studio. Cliquez sur OK.

  2. Dans la page de Sélectionner un langage de programmation , sélectionnez Visual C# ou Visual Basic.

  3. Ne modifiez pas les valeurs par défaut dans la page de Les informations de base d'un VSPackage .

  4. Dans la page de Sélectionnez les options d'un VSPackage , sélectionnez Commande de menu. Cliquez sur Suivant.

  5. modifiez nom de la commande à mon déployez la commande. Cliquez sur Suivant.

  6. projet de test d'intégrationclair. Cliquez sur Terminer.

    le modèle génère la solution de DeployPackage.

Déploiement Xcopy à l'aide de code base

Une façon de déployer un VSPackage est à l'aide de le déploiement xcopy, nommé d'après l'outil DOS qui copie un fichier à un emplacement. Vous copiez simplement votre VSPackage dans le dossier de votre choix sur l'ordinateur cible. Un déploiement telles que celle-ci échouera sans aucun doute, parce que les clés appropriées de base de registres n'ont pas été initialisées sur l'ordinateur cible.

Vous pouvez initialiser la base de registres à l'aide d'un fichier .reg qui contient les clés et les valeurs souhaitées. Vous pouvez générer le fichier .reg pour votre VSPackage à l'aide de l'utilitaire Regpkg.exe.

Notes

La meilleure façon de stocker des packages dans Visual Studio consiste à utiliser des fichiers .pkgdef.Cela permet le déploiement d'extensions sans nécessiter l'accès à la base de registres.Les fichiers de Pkgdef sont créés à l'aide de utilitaire de CreatePkgDef.

pour générer le fichier de base de registres

  1. Dans la fenêtre de (System definition modelCommande , accédez au dossier qui contient DeployPackage.dll. Cela se trouve généralement dans le projet \bin\Debug \.

  2. tapez la ligne suivante à l'invite de commandes.

    regpkg /regfile:DeployPackage.reg /codebase DeployPackage.dll

  3. Ouvrez le fichier résultant de DeployPackage.reg dans le Bloc-notes.

DeployPackage.reg doit ressembler au code suivant :

REGEDIT4

[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\10.0\InstalledProducts\DeployPackage]
@="#110"
"Package"="{bad3390c-b2a2-4bfc-a3ad-87e8119df413}"
"ProductDetails"="#112"
"PID"="1.0"
"LogoID"="#400"
[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\Packages\{bad3390c-b2a2-4bfc-a3ad-87e8119df413}]
@="Company.DeployPackage.DeployPackage, DeployPackage, Version=1.0.2796.21244, Culture=neutral, PublicKeyToken=125cdbd1e07e0d79"
"InprocServer32"="C:\\Windows\\system32\\mscoree.dll"
"Class"="Company.DeployPackage.DeployPackage"
"CodeBase"="D:\\DeployPackage\\DeployPackage\\bin\\Debug\\DeployPackage.dll"
[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\Menus]
"{bad3390c-b2a2-4bfc-a3ad-87e8119df413}"=", 1000, 1"

La clé de base de code est générée lorsque regpkg.exe est exécuté avec le commutateur /codebase, comme suit.

"CodeBase"="D:\\DeployPackage\\DeployPackage\\bin\\Debug\\DeployPackage.dllL"

Pour déployer votre VSPackage sur un ordinateur cible, vous devez effectuer les tâches suivantes :

  • Mettez à jour le chemin d'accès du code base.

  • Copiez les fichiers d'un VSPackage .dll et les fichiers .reg sur l'ordinateur cible.

  • mettez à jour la base de registres sur l'ordinateur cible.

  • Initialisez le système de menus de Visual Studio sur l'ordinateur cible.

Pour effectuer un déploiement sur l'ordinateur cible à l'aide de xcopy

  1. Modifiez le chemin d'accès du code base dans DeployPackage.reg le chemin d'accès où DeployPackage.dll sera installé sur l'ordinateur cible. Par exemple, si vous installez DeployPackage.dll au répertoire racine du lecteur D, la clé et la valeur de base de code doit se présenter comme suit :

    "CodeBase"="D:\\DeployPackage.dll"
    
  2. assurez-vous que le chemin d'accès InprocServer32 est l'emplacement de mscoree.dll sur l'ordinateur cible. Par exemple, si le système d'exploitation est installé sur le lecteur D, la clé InprocServer32 et la valeur doit se présenter comme suit :

    "InprocServer32"="D:\\Windows\\system32\\mscoree.dll"
    
  3. Enregistrez les modifications apportées à DeployPackage.reg et copiez DeployPackage.reg et DeployPackage.dll sur l'ordinateur cible. Veillez à copier DeployPackage.dll au chemin d'accès donné dans la clé de base de code.

  4. Exécutez la fenêtre de Visual StudioCommande sur l'ordinateur cible en tant qu'administrateur.

  5. À l'invite de commandes, naviguez jusqu'à l'endroit où vous DeployPackage.dll installé et tapez ensuite les deux lignes suivantes :

    REGEDIT /s deploypackage.reg

    devenv /setup /nosetupvstemplates

    la première ligne installe les différentes clés et valeurs dans la base de registres. La deuxième ligne initialise Visual Studio et son système de menus sur l'ordinateur cible.

    Notes

    Comme nous n'ajoutons pas le ou les modèles d'élément, nous pouvons utiliser le commutateur /nosetupvstemplates pour réduire le temps d'installation.

  6. début Visual Studio sur l'ordinateur cible.

  7. Dans le menu d' Outils , cliquez sur mon déployez la commande. Vous devez voir un message qui dispose le message suivant :

    Company.DeployPackage.DeployPackage.MenuItemCallback() intérieur

Félicitations ! Vous avez déployé avec succès votre VSPackage !

Le code base et le déploiement d'assembly

Pour utiliser le déploiement de code base, vous configurez votre VSPackage dans le dossier donné par la clé du code base. Ce dossier est généralement appelé après une société ou une technologie, par exemple, D : \MyCompany.

Le déploiement d'assembly est une autre façon de déployer votre VSPackage. À l'aide de le déploiement d'assembly, vous configurez votre VSPackage dans le dossier ou le sous-dossier de Visual StudioPrivateAssemblies.

Vous choisiriez généralement le déploiement de code base lorsque votre VSPackage est principalement utilisé par votre propre produit, et n'est pas connu à d'autres produits. Vous choisiriez le déploiement d'assembly lorsque votre VSPackage est destiné à être partagé par d'autres produits. Par exemple, un vérificateur d'orthographe serait probablement déployé dans le dossier de PrivateAssemblies.

Notes

Des désaccords de nom de fichier de l'assembly sont possibles dans le dossier de PrivateAssemblies.

Étant donné que chaque version de Visual Studio a son propre dossier de PrivateAssemblies, vous pouvez utiliser le déploiement d'assembly pour un VSPackage qui est conçu pour les scénarios côte à côte. Si vous avez un VSPackage qui est conçu pour fonctionner sous plusieurs versions de Visual Studio, vous devez envisager de l'installer dans le GAC.

Notes

Pour des raisons de performances, cliquez pas les assemblys avec nom fort de signe que vous placez dans le dossier de PrivateAssemblies, ou tout emplacement autre que le GAC.

Déploiement Xcopy à l'aide de PrivateAssemblies

Le déploiement d'assembly d'un VSPackage dans le dossier de PrivateAssemblies utilise une inscription d'un autre système que le déploiement de base de code. Vous pouvez utiliser l'utilitaire de regpkg.exe pour créer des clés, les sous-clés, et les valeurs nécessaires au déploiement d'assembly.

pour générer le fichier de base de registres

  1. Dans la fenêtre de (System definition modelCommande , accédez au dossier qui contient DeployPackage.dll. Cela se trouve généralement dans \bin\Debug du projet \.

  2. tapez la ligne suivante à l'invite de commandes :

    regpkg /regfile : DeployPackage.reg /assembly DeployPackage.dll

  3. Ouvrez le fichier résultant de DeployPackage.reg dans le Bloc-notes.

La clé de base de code est remplacée par la clé d'assembly, comme suit :

"Assembly"="DeployPackage, Version=1.0.2796.21244, Culture=neutral, PublicKeyToken=125cdbd1e07e0d79"

Pour déployer votre VSPackage sur un ordinateur cible, vous devez copier les fichiers d'un VSPackage .dll dans le dossier de PrivateAssemblies de l'ordinateur cible. Vous devez également copier les fichiers .reg sur l'ordinateur cible, mettre à jour la base de registres sur l'ordinateur cible, et initialiser le système de menus de Visual Studio sur l'ordinateur cible.

Pour déployer sur le dossier de PrivateAssemblies

  1. assurez-vous que le chemin d'accès InprocServer32 est l'emplacement de mscoree.dll sur l'ordinateur cible. Par exemple, si le système d'exploitation est installé sur le lecteur D, la clé InprocServer32 et la valeur doit se présenter comme suit :

    "InprocServer32"="D:\\Windows\\system32\\mscoree.dll"
    
  2. si vous avez déjà installé votre VSPackage à l'aide de code base, supprimez le dossier et son contenu.

  3. Copiez DeployPackage.reg et DeployPackage.dll dans le dossier de PrivateAssemblies sur l'ordinateur cible. L'emplacement standard de ce dossier est chemin d'installation de Visual Studio\Common7\IDE\PrivateAssemblies \.

    Notes

    Les informations d'identification d'administration peuvent être nécessaires pour copier dans ce dossier.

  4. Exécutez la fenêtre de Visual StudioCommande sur l'ordinateur cible en tant qu'administrateur.

  5. À l'invite de commandes, accédez au dossier \ PrivateAssemblies puis tapez les deux lignes suivantes :

    regedit deploypackage.reg

    devenv /setup

    la première ligne installe les différentes clés et valeurs dans la base de registres. La deuxième ligne initialise Visual Studio et son système de menus sur l'ordinateur cible.

    Deploypackage.reg n'est plus requis. vous pouvez le supprimer.

  6. début Visual Studio sur l'ordinateur cible.

  7. Dans le menu d' Outils , cliquez sur mon déployez la commande. Vous devez voir un message qui dispose le message suivant :

    Company.DeployPackage.DeployPackage.MenuItemCallback() intérieur

Félicitations ! Vous avez déployé votre VSPackage dans le dossier de PrivateAssemblies !

Déploiement à l'aide d'un projet d'installation

une approche plus facile à déployer un VSPackage est d'utiliser un projet d'installation de Visual Studio . Fichiers Windows Installer de produit de projets d'installation (.msi), qui gèrent de nombreuses tâches de déploiement pour vous, par exemple :

  • S'assurer que les composants requis sont rencontrés, tel que installer le common langage (CLR) runtime sur l'ordinateur cible.

  • Fourniture d'une interface utilisateur permettant d'activer la sélection du dossier cible pour l'installation.

  • Étapes de build personnalisée en cours de exécution, telles que la fusion de menus.

Pour plus d'informations, consultez Setup Projects.

La procédure suivante du projet d'installation importe les informations de Registre à partir d'un fichier .reg créé pour le déploiement de base de code. Si vous n'avez pas encore créé ce fichier, effectuez la procédure suivante en premier.

pour générer le fichier de base de registres

  1. Dans la fenêtre de (System definition modelCommande , accédez au dossier qui contient DeployPackage.dll. Cela se trouve généralement dans le projet \bin\Debug \.

  2. tapez la ligne suivante à l'invite de commandes :

    regpkg /regfile : DeployPackage.reg /codebase DeployPackage.dll

maintenant vous êtes prêt à créer et configurer le projet d'installation.

pour créer et configurer le projet d'installation

  1. ouvrez la solution de DeployPackage dans Visual Studio sur votre ordinateur de développement.

  2. Cliquez avec le bouton droit sur le nœud de solution, cliquez sur Ajouter, puis cliquez sur Nouveau projet.

  3. Développez Autres types de projets puis sélectionnez Configuration et déploiement.

  4. créez Projet d'installation nommé installation.

    Il ajoute le projet d'installation à votre solution.

  5. Cliquez avec le bouton droit sur le nœud du projet d'installation, cliquez sur Ajouter, puis cliquez sur Sortie de projet.

  6. Cliquez sur OK pour ajouter sortie principale du projet de DeployPackage.

    Le vérificateur de dépendance exécute et ajoute les dépendances au projet d'installation. La plupart de ces dépendances font référence aux fichiers binaires qui sont déjà présents sur un ordinateur cible qui a Visual Studio est installé.

  7. Sélectionnez toutes les dépendances détectées sauf Microsoft .NET Framework, cliquez avec le bouton droit sur la sélection, puis cliquez sur Exclure.

  8. Cliquez sur le nœud du projet d'installation.

    Les propriétés du projet s'affichent dans la fenêtre Propriétés.

  9. Modifiez la propriété ProductName au mon déploiement du package.

  10. Affectez à la propriété de titre au mon déployer le package.

  11. Cliquez sur l'icône de l'Éditeur du Registre sur la barre d'outils d' Explorateur de solutions .

    L'Éditeur du Registre s'affiche.

  12. Cliquez avec le bouton droit sur Registre sur l'ordinateur cible puis cliquez sur Importer.

    La boîte de dialogue de Registre d'importation s'affiche.

  13. Naviguez jusqu'à \bin\Debug\ folder of the DeployPackage project and select DeployPackage .reg. Cliquez sur Ouvrir.

    Les clés de Registre que vous avez généré pour le déploiement de code base sont ajoutées au nœud HKEY_LOCAL_MACHINE dans l'Éditeur du Registre.

Si vous examinez les clés de Registre dans \Software\Microsoft\VisualStudio\9.0\Packages \ nœud, vous trouvez deux chemin d'accès codé en dur. Ces doivent être remplacés par les chemins qui sont déterminés pendant l'installation.

Pour supprimer les chemins codés en dur

  1. Dans l'Éditeur du Registre, sélectionnez la clé du code base, puis sélectionnez la propriété dans la fenêtre de Propriétés .

  2. Modifiez le chemin d'accès pour être relatif au répertoire d'installation cible, comme suit :

    [TARGETDIR]deploypackage.dll
    
  3. Dans l'Éditeur du Registre, sélectionnez la clé InProcServer32 puis sélectionnez la propriété dans la fenêtre Propriétés.

  4. Modifiez le chemin d'accès pour être relatif au répertoire de système cible, comme suit :

    [SystemFolder]mscoree.dll
    

Après avoir installé sur l'ordinateur cible, vous devez exécuter devenv.exe avec le commutateur /setup. Vous pouvez ajouter cela à l'installation en tant qu'action personnalisée. Pour créer une action personnalisée, vous devez d'abord ajouter un projet pour créer une classe qui dérive de la classe d' Installer .

pour ajouter un projet de classe Installer

  1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

    La boîte de dialogue Nouveau projet s'affiche.

  2. créez Bibliothèque de classes Visual c# ou Visual Basic nommé DevenvSetupCustomAction.

  3. Supprimez le fichier Class1.cs ou Class1.vb.

  4. Cliquez avec le bouton droit sur le nœud du projet de DevenvSetupCustomAction, cliquez sur Ajouter, puis cliquez sur Nouvel élément.

  5. Créez un nouveau Classe Installer nommé DevenvSetup.

  6. Cliquez avec le bouton droit sur le nœud de DevenvSetup.cs ou de DevencSetup.vb puis cliquez sur Afficher le code.

  7. ajoutez les lignes suivantes aux instructions d' using ou d' Imports :

  8. Substituez la méthode d'installation en ajoutant le code suivant à la classe de DevenvSetup, juste après le constructeur :

    Ce code recherche le Registre de l'ordinateur cible pour l'EnvironmentPath nommé valeur de \Software\Microsoft\VisualStudio\9.0\Setup\VS \ clé. La valeur d'EnvironmentPath est le chemin d'accès complet à devenv.exe. Les séries devenv.exe de méthode d'installation avec le commutateur et les attentes de /setup est à terminer.

    Notes

    Si vous n'installez pas le ou les modèles d'élément, vous pouvez considérablement réduire le moment de l'installation en ajoutant le commutateur /nosetupvstemplates, comme suit :

maintenant que vous avez une action personnalisée, vous pouvez l'ajouter au projet d'installation.

pour ajouter une action personnalisée au projet d'installation

  1. Cliquez avec le bouton droit sur le nœud du projet d'installation, cliquez sur Ajouter, puis cliquez sur Sortie de projet.

    La boîte de dialogue Ajouter le groupe de sorties du projet apparaît.

  2. Sélectionnez DevenvSetupCustomAction dans la liste de Projet .

    Sortie principale de DevenvSetupCustomAction (actives) est ajouté au nœud détecté de dépendances.

  3. Sélectionnez le nœud du projet d'installation puis cliquez sur l'icône d' Éditeur des actions personnalisées dans la barre d'outils Explorateur de solutions .

    L'éditeur Actions personnalisées s'affiche.

  4. Cliquez avec le bouton droit sur le nœud installer puis cliquez sur Ajouter une action personnalisée.

    La boîte de dialogue Sélectionner un élément dans le projet s'affiche.

  5. Double-cliquez sur le dossier d'application puis sélectionnez Sortie principale de DevenvSetupCustomAction (actives). Cliquez sur OK.

    L'action personnalisée est ajoutée au nœud installer.

pour tester le projet d'installation

  1. Générez la solution de DeployPackage.

    DeployPackage.dll et DevenvSetupCustomAction.dll sont créés.

  2. Générez le projet d'installation.

    Setup.exe et Setup.msi sont créés.

  3. Fermez Visual Studio.

  4. Copiez le fichier setup.exe sur l'ordinateur cible. Vous pouvez exécuter le fichier setup.exe sur l'ordinateur de développement lorsque aucun ordinateur cible n'est disponible.

    Notes

    L'ordinateur doit avoir Visual Studio est installé.la version de Visual Studio doit correspondre à la clé de Registre qui est utilisée par l'action personnalisée.

  5. Exécutez setup.exe sur l'ordinateur cible.

    Notes

    Le devenv en cours de exécution /setup peut prendre du temps.Vous pouvez suivre sa progression à l'aide de le Gestionnaire des tâches.

  6. Installez DeployPackage, puis acceptez les valeurs par défaut.

  7. Exécutez Visual Studio.

  8. Dans le menu d' Outils , cliquez sur mon déployez la commande. Vous devez voir un message qui dispose le message suivant :

    Company.DeployPackage.DeployPackage.MenuItemCallback() intérieur

  9. fermez le message et la sortie Visual Studio.

  10. dans Panneau de configuration, (Windows Vista) sélectionnez Programmes et fonctionnalités ou (Windows XP) Ajouter ou supprimer des programmes.

  11. Désinstallez my déploiement du package.

  12. Exécutez Visual Studio.

  13. Vérifiez que mon déployez la commande n'apparaît plus dans le menu d' Outils .

Déploiement à l'aide de l'ensemble d'outils XML de Windows Installer

Une autre approche à déployer un VSPackage est d'utiliser l'ensemble d'outils XML de Windows Installer. L'ensemble d'outils compile les fichiers .wxs pour produire des fichiers .msi. Il est plus facile à créer des actions personnalisées, telles que la fusion de menus, à l'aide de les fichiers .wxs qu'avec les projets d'installation Windows Installer.

Pour plus d'informations sur l'ensemble d'outils, consultez http://wix.sourceforge. réseau.

Vous pouvez utiliser l'utilitaire de RegPkg pour créer un fichier .wxs pour stocker un VSPackage dans la base de registres. Vous insérez ce fichier dans un fichier plus complet .wxs d'affichage votre VSPackage et fusionne ses menus dans Visual Studio. Vous compilez ce fichier .wxs avec les outils de candle.exe et de light.exe pour produire un fichier .msi de votre déploiement d'un VSPackage.

En premier lieu, créez le fichier externe de DeployPackage.wxs et ajoutez -le au projet de DeployPackage.

pour créer le fichier de DeployPackage.wxs

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet de DeployPackage, cliquez sur Ajouter, puis cliquez sur Nouvel élément.

    La boîte de dialogue Ajouter un nouvel élément s'affiche.

  2. Sélectionnez le modèle d'élément du fichier texte, nommez le fichier DeployPackage.wxs, puis cliquez sur Ajouter. Le fichier vide s'affiche dans l'éditeur.

  3. Ajoutez les lignes suivantes au fichier :

<?xml version='1.0' encoding='windows-1252'?>

<?define VisualStudioRegistryRoot = "Software\Microsoft\VisualStudio\9.0" ?>

<Wix xmlns='https://schemas.microsoft.com/wix/2003/01/wi'>
  <Product Name='DeployPackage' Id='54748C47-DC70-43ec-A296-ECD7F30A548C'
    Language='1033' Codepage='1252' Version='1.0.0' Manufacturer='My Company'>

    <Package Id='????????-????-????-????-????????????' Keywords='Installer'
      Description="Deploy Package Installer"
      Comments='Demonstrates VSPackage deployment' Manufacturer='My Company'
      InstallerVersion='100' Languages='1033' Compressed='yes' SummaryCodepage='1252' />

    <Media Id='1' Cabinet='Sample.cab' EmbedCab='yes' />

    <!-- Properties -->
    <Property Id="DEVENV_EXE_PATH">
      <RegistrySearch Id="RegSearch_DevenvExe_Path" Root="HKLM" Key="$(var.VisualStudioRegistryRoot)\Setup\VS" Name="EnvironmentPath" Type="raw" />
    </Property>

    <!-- Launch conditions -->
    <Condition Message="An administrator must approve or install [ProductName]."> Privileged </Condition>
    <Condition Message="[ProductName] requires Visual Studio 2010."> DEVENV_EXE_PATH </Condition>

    <!-- Root directories -->
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder" Name="PFILES">
        <Directory Id="INSTALLDIR" Name="MyFolder" >

          <Component Guid="7D6D266D-4197-439b-ADB4-D51876269055" Id="MainExecutable">
            <File Id="Deploy.dll" Name="Deploy.dll" LongName="DeployPackage.dll" Source="bin\Debug\DeployPackage.dll" Vital="yes" DiskId="1" />
            <?include DeployFragment.wxs ?>
          </Component>
        </Directory>
      </Directory>
    </Directory>

    <Feature Id='Complete' Level='1'>
      <ComponentRef Id='MainExecutable' />
    </Feature>

    <InstallExecuteSequence>
      <Custom Action="CA_DeployPackage" Before="InstallFinalize" />
    </InstallExecuteSequence>

    <CustomAction Id="CA_DeployPackage" Property="DEVENV_EXE_PATH" ExeCommand="/setup /nosetupvstemplates" Impersonate="no" Execute="deferred" />

  </Product>
</Wix>
  1. Enregistrez les modifications apportées.

Le fichier externe de DeployPackage.wxs fait référence à un fichier intermédiaire nommé DeployFragment.wxs, que vous générez de DeployPackage.dll.

pour générer le fichier de DeployFragment.wxs

  1. Dans la fenêtre de (System definition modelCommande , accédez au dossier qui contient DeployPackage.dll. Cela se trouve généralement dans le projet \bin\Debug \.

  2. tapez la ligne suivante à l'invite de commandes :

    regpkg /wixfile:.. \.. \DeployFragment.wxs /codebase DeployPackage.dll

    RegPkg crée le fichier de DeployPackage.wxs dans le dossier du projet de DeployPackage.

  3. Dans Visual Studio, cliquez avec le bouton droit sur le nœud du projet de DeployPackage, pointez sur Ajouter, puis cliquez sur Élément existant.

    Le bos de dialogue d' Ajouter un élément existant s'affiche.

  4. Naviguez jusqu ' à le dossier du projet de DeployPackage.

  5. Définir le filtre de fichiers pour afficher Tous les fichiers, sélectionnez le fichier de DeployFragment.wxs, puis cliquez sur Ajouter.

    le fichier de DeployFragment.wxs est ajouté au projet de DeployPackage.

  6. ouvrez le fichier de DeployFragment.wxs pour modifier.

  7. Modifiez la valeur de l'élément de Registre nommé CodeBase afin qu'il corresponde à l'attribut de nom de l'élément du fichier de DeployPackage.wxs.

    <Registry Name="CodeBase" Value="[#Deploy.dll]" Type="string" />
    
  8. Enregistrez les modifications apportées.

Pendant qu'une explication complète des éléments du fichier .wxs n'est pas traitée dans cette procédure pas - à - pas, voici quelques points clés pour vous aider à démarrer.

  • De nombreux éléments de l'ensemble d'outils prennent GUID comme identification Ces GUID doit être remplacé lorsque vous créez un nouveau fichier .wxs. GUID entre les balises d'inclure ne doit pas être remplacé, car ils appartiennent au VSPackage.

  • L'élément du fichier est un attribut de nom qui utilise (voire 8,3) un nom mis en forme abrégée, et est utilisé uniquement à des fins de identification. Le VSPackage réel est fourni par le LongName et les attributs source. Par convention, l'attribut d'identificateur est le même que l'attribut de nom.

  • L'attribut de nom de l'élément du fichier de DeployPackage.wxs doit correspondre à la valeur du Registre CodeBase nommé par élément de DeployFragment.wxs. Souvenez -vous que l'attribut de nom est (voire 8,3) un nom de fichier mis en forme abrégée.

  • L'élément CustomAction spécifie l'action personnalisée. Les personnifiés et exécutent des attributs sont définis de telle sorte que Visual Studio a des privilèges élevés sous Windows Vista lorsque l'action personnalisée fonctionne. L'attribut d'ExeCommand utilise le commutateur /nosetupvstemplates pour tirer parti du fait que vous n'installez pas le ou les modèles de projet. Cela diminue considérablement le temps d'installation.

Maintenant que votre fichier .wxs terminé, vous pouvez le compiler pour créer le fichier d'installation .msi.

pour compiler le fichier de DeployPackage.wxs

  1. Dans la fenêtre de (System definition modelCommande , naviguez jusqu ' à le dossier du projet de DeployPackage. ce dossier contient le fichier DeployPackage.wxs.

  2. Ajoutez le chemin d'accès complet de l'ensemble d'outils à la variable de chemin d'accès d'environnement. Par exemple :

    set Path=%Path%;C:\Program Files\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\Toolset
    
  3. tapez la ligne suivante à l'invite de commandes.

    candle DeployPackage.wxs

    Cela crée un fichier objet de DeployPackage.wixobj.

  4. tapez la ligne suivante à l'invite de commandes.

    light DeployPackage.wixobj

    Cela crée un fichier objet de DeployPackage.msi.

Pour tester le fichier de déploiement .msi :

  • installez le VSPackage sur l'ordinateur cible.

  • Vérifiez que le VSPackage s'exécute sur l'ordinateur cible.

  • désinstallez le VSPackage à partir de l'ordinateur cible.

pour tester le projet d'installation

  1. Copiez DeployPackage.msi sur l'ordinateur cible. Vous pouvez l'exécuter sur l'ordinateur de développement lorsque aucun ordinateur cible n'est disponible.

    Notes

    L'ordinateur doit avoir Visual Studio est installé.la version de Visual Studio doit correspondre à la clé de Registre qui est utilisée par la condition de lancement et par l'action personnalisée.

  2. exécutez DeployPackage.msi sur l'ordinateur cible.

    Notes

    Aucun Assistant ne s'affiche.Il est possible pour light.exe ajoute un Assistant à l'aide d'une bibliothèque d'ensemble d'outils.Pour plus d'informations, consultez http://wix.sourceforge.réseau.

  3. Exécutez Visual Studio.

  4. Dans le menu d' Outils , cliquez sur Mon déploiement du package. Vous devez voir un message qui dispose le message suivant :

    Company.DeployPackage.DeployPackage.MenuItemCallback() intérieur

  5. Fermez le message et fermez Visual Studio.

  6. dans Panneau de configuration, (Windows Vista) sélectionnez Programmes et fonctionnalités ou (Windows XP) Ajouter ou supprimer des programmes.

  7. désinstallation DeployPackage.

  8. Exécutez Visual Studio.

  9. Vérifiez que mon déployez la commande n'apparaît plus dans le menu d' Outils .

Voir aussi

Autres ressources

Installer les VSPackages

Installer les VSPackages à l'aide de Windows Installer