Partager via


pages de démarrage personnalisées de déploiement

Vous pouvez déployer des pages de démarrage personnalisées à l'aide de le déploiement VSIX ou en copiant les fichiers aux emplacements appropriés de l'ordinateur cible.

Déploiement VSIX à l'aide de le modèle de projet de page de démarrage

Lorsque vous créez une page de démarrage à l'aide de le modèle de projet de page de démarrage, puis générez le projet, Visual Studio crée un fichier .vsix que vous pouvez distribuer. Dans une page de démarrage dans un fichier .vsix fournit les options suivantes pour le déploiement, selon votre public référencé :

  • Vous pouvez mettre à jour le fichier .vsix sur un partage réseau ou sur un site Web public. Lorsqu'un utilisateur ouvre le fichier, la page de démarrage est installée automatiquement.

  • Vous pouvez télécharger le fichier .vsix Visual Studio Gallery dans afin que les utilisateurs puissent l'installer à l'aide de Gestionnaire d'extensions.

Le modèle de projet de page de démarrage crée une copie de la page de démarrage Visual Studio par défaut afin que vous puissiez modifier la copie et conserver l'original.

Vous pouvez obtenir le modèle de projet de page de démarrage à l'aide de Gestionnaire d'extensions ou en le téléchargeant du site Web.

Déploiement VSIX sans utiliser le modèle de projet de page de démarrage

Un déploiement réussi VSIX requiert une extension à installer dans les dossiers identifiés par la procédure d'enregistrement VSIX et par Gestionnaire d'extensions. Étant donné que le modèle de projet de page de démarrage spécifie déjà les dossiers corrects, nous vous recommandons de l'utiliser chaque fois que vous souhaitez empaqueter une extension pour le déploiement VSIX. Toutefois, si vous avez un cas où vous ne pouvez pas utiliser le modèle, vous pouvez créer un déploiement VSIX sans utiliser.

Pour créer un déploiement VSIX sans utiliser le modèle de projet de page de démarrage, créez d'abord un fichier .vsix pour la page initiale de l'un ou l'autre de ces deux façons :

Pour que Visual Studio identifie une page de démarrage, élément de contenu du manifeste VSIX doit contenir un élément de CustomExtension avec l'attribut d' Type à « StartPage ». Une extension de page de démarrage qui a été installée à l'aide de le déploiement VSIX s'affiche dans la liste de Personnaliser la page de démarrage sur la page d'options de Démarrage comme [Extension installée] nom d'extension.

Si votre package de page initiale inclut des assemblys, vous devez ajouter l'alignement de liaison de chemin d'accès afin qu'ils soient disponibles au démarrage de Visual Studio. Pour ce faire, assurez -vous que votre package inclut un fichier .pkgdef qui contient les informations suivantes.

[$RootKey$\BindingPaths\{Insert a new GUID here}]
"$PackageFolder$"=""

Déploiement VSIX pour tous les utilisateurs

Par défaut, les extensions déployées dans des packages VSIX s'installent uniquement pour l'utilisateur actuel. Vous pouvez créer une page de démarrage installation pour tous les utilisateurs de l'ordinateur cible en créant un déploiement de Tout-Utilisateurs.

pour créer un déploiement de Tout-Utilisateurs

  1. Ouvrez le fichier extension.vsixmanifest en mode Code.

  2. Dans élément d'identificateur du manifeste de VSIX, ajoutez élément d'AllUsers avec une valeur d' true.

    <AllUsers>true</AllUsers>
    

    Cela provoque le programme d'installation de VSIX qu'il doit demander des autorisations d'administration, puis installe les fichiers à \Common7\IDE\Extensions.

  3. Ouvrez le fichier .pkgdef.

  4. Modifiez le .pkgdef pour définir la page de démarrage par défaut sous HKLM en ajoutant le code suivant, où MyStartPage.xaml est le nom du fichier .xaml qui contient votre page de démarrage.

    [$RootKey$ \StartPage\Default]

    « URI " = " $PackageFolder$ \MyStartPage.xaml »

    Cela indique Visual tenu de consulter dans le nouvel emplacement de la page de démarrage.

déploiement de copie du fichier

Vous ne devez pas créer un fichier .vsix pour déployer une page de démarrage personnalisée. À la place, vous pouvez copier le balisage et les fichiers de prise en charge directement dans \StartPages de l'utilisateur \. La liste de Personnaliser la page de démarrage sur la page d'options de Démarrage répertorie chaque fichier .xaml dans ce dossier, ainsi que le chemin d'accès, par exemple, documente \Visual Studio 2010\StartPages \nom de fichier.xaml. Si votre page de démarrage inclut des références aux assemblys privés, vous devez les copier et les coller dans \PrivateAssemblies \.

Pour une page de démarrage que vous avez créée sans l'empaqueter dans un fichier .vsix, nous vous recommandons d'utiliser une stratégie de base de copie du fichier, par exemple, un script batch, ou une autre technologie de déploiement qui vous permet de placer ces fichiers dans les répertoires requis.

pour installer manuellement une page de démarrage personnalisée

  1. Copiez le fichier .xaml qui contient le balisage de page de démarrage, avec tous les fichiers de prise en charge autres que des assemblys, et les coller dans. \Dossier mes Documents\Visual Studio 2010\StartPages \.

  2. Si la page de démarrage nécessite des assemblys, copiez -les et collez -les dans. \dossier d'installation de Visual Studio\Common7\IDE\PrivateAssemblies \.

  3. Dans la liste de Personnaliser la page de démarrage sur la page d'options de Démarrage , sélectionnez la nouvelle page de démarrage. Pour plus d'informations, consultez Personnalisation de la page de démarrage pour Visual Studio.

Voir aussi

Tâches

Procédure pas - à - pas : Ajout d'une référence de DLL à la page de démarrage

Autres ressources

Personnalisation de la page de démarrage pour Visual Studio

Déploiement d'une extension Visual Studio