Distribution d'un composant Windows Runtime géré
Vous pouvez distribuer votre composant Windows Runtime par copie des fichiers. Toutefois, si votre composant est constitué de nombreux fichiers, l'installation peut être fastidieuse pour vos utilisateurs. En outre, des erreurs de placement des fichiers ou l'impossibilité de définir les références peuvent leur occasionner des problèmes. Vous pouvez empaqueter un composant complexe sous la forme d'un kit de développement logiciel de l'extension Visual Studio, pour en faciliter l'installation et l'utilisation. Les utilisateurs doivent uniquement définir une référence pour le package entier. Ils peuvent facilement localiser et installer votre composant à l'aide de la boîte de dialogue Extensions et mises à jour, comme indiqué dans Installation et gestion des outils et extensions Visual Studio, dans MSDN Library.
Planification d'un composant Windows Runtime distribuable
Choisissez des noms uniques pour les fichiers binaires, tels que vos fichiers .winmd. Nous recommandons le format suivant pour en garantir l'unicité :
company.product.purpose.extension
Par exemple : Microsoft.Cpp.Build.dll
Vos fichiers binaires seront installés dans des packages d'application, éventuellement avec les fichiers binaires d'autres développeurs. Consultez la rubrique relative aux kits de développement logiciel de l'extension dans Procédure de création d'un Kit de développement logiciel (SDK), dans MSDN Library.
Pour décider du mode de distribution de votre composant, tenez compte de sa complexité. Un kit de développement logiciel de l'extension ou un gestionnaire de package similaire est recommandé lorsque :
Votre composant comporte plusieurs fichiers.
Vous fournissez des versions de votre composant pour plusieurs plateformes (x86 et ARM, par exemple).
Vous fournissez à la fois une version déboguée et une version finale de votre composant.
Votre composant comprend des fichiers et des assemblys qui sont utilisés uniquement au moment de la conception.
Un kit de développement logiciel de l'extension est particulièrement utile si plusieurs éléments ci-dessus sont vrais.
Notes
Pour les composants complexes, le Système de gestion de packages de NuGet offre une alternative open source aux kits de développement logiciel de l'extension. Comme les kits de développement logiciel de l'extension, NuGet vous permet de créer des packages qui simplifient l'installation des composants complexes. Pour une comparaison des packages NuGet et des kits de développement logiciel de l'extension Visual Studio, consultez Ajout de références à l'aide de NuGet par rapport à un kit de développement logiciel de l'extension, dans MSDN Library.
Distribution par copie des fichiers
Si votre composant comporte un seul fichier .winmd, ou un fichier .winmd et un fichier d'index de ressource (.pri), vous pouvez simplement mettre le fichier .winmd à la disposition des utilisateurs pour copie. Les utilisateurs pourront placer le fichier où ils souhaitent dans un projet, utiliser la boîte de dialogue Ajouter un élément existant pour ajouter le fichier .winmd au projet, puis utiliser la boîte de dialogue Gestionnaire de références pour créer une référence. Si vous incluez un fichier .pri ou un fichier .xml, demandez aux utilisateurs de placer ces fichiers avec le fichier .winmd.
Notes
Visual Studio 2012 produit toujours un fichier .pri lorsque vous générez votre composant Windows Runtime, même si votre projet ne comprend pas de ressources. Si vous avez une application test pour votre composant, vous pouvez déterminer si le fichier .pri est utilisé en examinant le contenu du package d'application dans le dossier bin\debug\AppX. Si le fichier .pri de votre composant n'apparaît pas à cet emplacement, vous n'avez pas besoin de le distribuer. Vous pouvez aussi utiliser l'outil MakePRI.exe pour faire un dump du fichier de ressources de votre projet de composant Windows Runtime. Par exemple, dans la fenêtre d'invite de commandes Visual Studio, tapez :
makepri dump /if MyComponent.pri /of MyComponent.pri.xml
Pour en savoir plus sur les fichiers .pri, consultez l'article Système de gestion des ressources (Windows).
Distribution par kit de développement logiciel de l'extension
Un composant complexe inclut généralement des ressources Windows, mais reportez-vous à la remarque à propos de la détection des fichiers .pri vides à la section précédente.
Pour créer un kit de développement logiciel de l'extension
Vérifiez que le Kit de développement logiciel Visual Studio 2012 est installé. Vous pouvez télécharger le Kit de développement logiciel Visual Studio sur la page Téléchargements de Visual Studio.
Créez un projet à l'aide du modèle Projet VSIX. Vous pouvez rechercher le modèle sous Visual C# ou Visual Basic, dans la catégorie Extensibilité. Ce modèle est installé dans le cadre du Kit de développement logiciel Visual Studio 2012. (Procédure pas à pas : création d'un SDK à l'aide de C# ou de Visual Basic, dans MSDN Library, montre l'utilisation de ce modèle dans un scénario très simple.) )
Déterminez la structure des dossiers de votre Kit de développement logiciel (SDK). La structure des dossiers commence au niveau racine de votre projet VSIX, avec les dossiers Références, Package redistribuable et DesignTime.
Références est l'emplacement des fichiers binaires que les utilisateurs peuvent programmer. Le kit de développement logiciel de l'extension crée des références à ces fichiers dans les projets Visual Studio de vos utilisateurs.
Package redistribuable est l'emplacement d'autres fichiers qui doivent être distribués avec vos fichiers binaires, dans les applications créées à l'aide de votre composant.
DesignTime est l'emplacement des fichiers utilisés uniquement lorsque les développeurs créent des applications qui utilisent votre composant.
Dans chacun de ces dossiers, vous pouvez créer des dossiers de configuration. Les noms autorisés sont debug, retail et CommonConfiguration. Le dossier CommonConfiguration est réservé aux fichiers qui sont identiques, qu'ils soient utilisés par les versions commerciales ou de débogage. Si vous distribuez uniquement des versions commerciales de votre composant, vous pouvez tout placer dans CommonConfiguration et omettre les deux autres dossiers.
Dans chaque dossier de configuration, vous pouvez fournir des dossiers d'architecture pour les fichiers spécifiques à la plateforme. Si vous utilisez les mêmes fichiers pour toutes les plateformes, vous pouvez fournir un dossier unique nommé neutre. Vous pouvez trouver des informations sur la structure des dossiers, notamment d'autres noms de dossiers d'architecture, dans Procédure de création d'un Kit de développement logiciel (SDK), dans MSDN Library. Procédure de création d'un Kit de développement logiciel (SDK) présente les kits de développement logiciel de l'extension et de plateforme. Il peut s'avérer utile de réduire la section sur les kits de développement logiciel de plateforme, pour éviter toute confusion. )
Créez un fichier du manifeste SDK. Le manifeste spécifie les informations sur le nom et la version, les architectures prises en charge par votre Kit de développement logiciel (SDK), les versions du. NET Framework et d'autres informations sur la façon dont Visual Studio utilise votre Kit de développement logiciel (SDK). Vous pouvez trouver plus de détails, ainsi qu'un exemple dans Procédure de création d'un Kit de développement logiciel (SDK).
Générez et distribuez le kit de développement logiciel de l'extension. Pour des informations plus détaillées, notamment sur la recherche et la signature du package VSIX, consultez Déploiement VSIX, dans MSDN Library.
Voir aussi
Autres ressources
Procédure de création d'un Kit de développement logiciel (SDK)
Système de gestion de package de NuGet
Système de gestion des ressources (Windows)
Installation et gestion des outils et extensions Visual Studio