Comment : créer un Kit de développement logiciel (SDK)

Un kit de développement logiciel (SDK) est une collection de fichiers qu' Visual Studio traite comme un élément unique de référence.La boîte de dialogue Gestionnaire de références répertorie tous les Kit de développement logiciel qui sont appropriés au projet qui appelle la boîte de dialogue Gestionnaire de références .Lorsque vous ajoutez un Kit de développement logiciel à un projet, tout le contenu est disponible via Intellisense, Boîte à outils, builders, l'Explorateur d'objets, la génération, le déploiement, le débogage, et l'empaquetage.

Il existe deux types de Kit de développement logiciel :

• Les Kits de développement Platform SDK sont les composants de liaison pour développer des applications pour une plateforme.Par exemple, Windows 8 Kit de développement logiciel est requis pour développer des applications d' Windows Store .

• L'extension Kit de développement logiciel sont des composants facultatifs qui étendent une plateforme mais ne sont pas obligatoire pour développer des applications pour cette plateforme.

Les sections suivantes décrivent l'infrastructure générale des Kit de développement logiciel et comment créer une plateforme Kit de développement logiciel et une extension Kit de développement logiciel.

• Moniker de plateforme cible

• Kits de développement Platform SDK

• Extension Kit de développement logiciel

Moniker de plateforme cible

Visual Studio 2012 prend en charge deux nouvelles propriétés :

1. Identificateur (TPI) de plateforme cible: Les valeurs valides de cette propriété incluent les différentes plateformes pour lesquelles vous pouvez développer des logiciels.Les fenêtres est un exemple d'une plateforme.

2. Version (TPV) de plateforme cible: Cette propriété identifie la version de la plateforme cible.Par exemple, pour Windows 8, le TPV est 8,0, et les TPIs est windows.

Ensemble, ces deux propriétés constituent le moniker (TPM) de plateforme cible, qui forme la base de Windows 8 et le Kit de développement logiciel référençant l'infrastructure.Par exemple, le module de plateforme sécurisée pour Windows 8 est « fenêtres, version=8.0 ».

Kits de développement Platform SDK

Les Kits de développement Platform SDK sont requis pour développer des applications pour une plateforme.Par exemple, Windows 8 Kit de développement logiciel est requis pour développer des applications pour Windows 8.

Installation

Tout plateforme Kit de développement logiciel être installé à HKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\@InstallationFolder = [racine du Kit de développement logiciel].Par conséquent, Windows 8 Kit de développement logiciel est installé sur HKLM\Software\Microsoft\Microsoft Kit de développement logiciel windows\\ v8.0.

Disposition

Les Kits de développement Platform SDK auront la disposition suivante :

\[InstallationFolder root]
            SDKManifest.xml
            \References
                  \[config]
                        \[arch]
            \DesignTime
                  \[config]
                        \[arch]

Nœud	Description
Dossier Références	Contient les binaires qui contiennent les API par rapport auxquelles peut être codé.Elles peuvent inclure des fichiers ou des assemblys de (WinMD) de métadonnées windows.
Dossier de DesignTime	Contient les fichiers nécessaires uniquement au moment géré par pre/débogage.Elles peuvent inclure les documents XML, bibliothèques, en-têtes, binaires au moment de le design de boîte à outils, artefacts MSBuild, etc. Attention Les documents XML idéalement seraient définis dans\dossier de DesignTime, mais les documents XML pour les références continueront à être placés à côté du fichier de référence dans Visual Studio 2012.Par exemple, XML documentation de référence \References\[config]\[arch]\sample.dll être \References\[config]\[arch]\sample.xml, et localisé version de ce document être \References\[config]\[arch]\[paramètres régionaux]\sample.xml.
Fichier de configuration	Il peut y avoir qu'trois dossiers : déboguez, version commerciale et CommonConfiguration.Les auteurs du Kit de développement logiciel peuvent définir leurs fichiers sous CommonConfiguration si le même jeu de fichiers du Kit de développement logiciel est consommé, indépendamment du paramètre que le consommateur du Kit de développement logiciel ciblera.
Dossier d'architecture	Dossier charge d'architecture en peuvent exister.Visual Studio 2012 prend en charge les architectures suivantes : x86, x64, ARM, et neutre.Remarque : Mappe Win32 au x86, et cartes AnyCPU au neutre. Dans .NET Framework 4.5, MSBuild est codé en dur pour consulter uniquement sous\\ CommonConfiguration neutre pour les Kits de développement Platform SDK.
SDKManifest.xml	Ce fichier décrit comment Visual Studio doit utiliser le Kit de développement logiciel.Examinez le manifeste du Kit de développement logiciel pour Windows 8: <FileList DisplayName = “Windows” PlatformIdentity = “Windows, version=8.0” TargetFramework = “.NET for Windows Store apps, version=v4.5; .NET Framework, version=v4.5” MinVSVersion = “11.0”> <File Reference = “Windows.winmd”> <ToolboxItems VSCategory = “Toolbox.Default” /> </File> </FileList> DisplayNameLa valeur que l'Explorateur d'objets affiche dans la liste parcourir. PlatformIdentityL'existence de cet attribut indique Visual Studio et MSBuild que le Kit de développement logiciel est une plateforme Kit de développement logiciel et que les références ajoutées à partir de celle-ci ne doivent pas être copiées localement. TargetFrameworkCet attribut est utilisé par Visual Studio pour garantir que seuls les projets qui ciblent même Infrastructures que spécifié dans la valeur de cet attribut peut utiliser le Kit de développement logiciel. MinVSVersionCet attribut est utilisé par Visual Studio pour utiliser uniquement les Kit de développement logiciel qui lui sont appliquées. RéférenceCet attribut doit être spécifié uniquement pour les références qui contiennent des contrôles.Pour plus d'informations sur la spécification si une référence contient des contrôles, consultez ci-dessous.

Dans Visual Studio

Référence gestionnaire surveiller plateforme cible moniker (TPM) puis remplacer valeur de propriété dans HKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\@InstallFolder = [racine du Kit de développement logiciel] pour déterminer l'emplacement sur disque du Kit de développement Platform SDK.Le gestionnaire de référence ensuite :

1. Ouvrez le manifeste du Kit de développement logiciel pour déterminer si la plateforme Kit de développement logiciel s'applique à la version de Visual Studio dans laquelle le gestionnaire de référence a été appelé et si la plateforme Kit de développement logiciel s'applique selon le Framework cible du projet appelant le gestionnaire de référence.Si la plateforme Kit de développement logiciel s'applique aux deux nombres, le gestionnaire de référence utilise la propriété d'identificateur de plateforme cible pour le nom de l'onglet dans lequel pour énumérer la plateforme le Kit de développement logiciel de référence.Si la plateforme Kit de développement logiciel est introuvable sur le disque, l'onglet s'affiche toujours, mais le volet central affiche le message « [des TPIs] Kit de développement logiciel est introuvable sur l'ordinateur ».

2. Énumérez toutes les références spécifiées sous [racine d'InstallFolder]\references\CommonConfiguration\neutral dossier dans les [TPIs] | Classes principales tableau.

L'utilisateur peut ensuite ajouter les références dans le Kit de développement Platform SDK à leur projet et les utiliser dans le code à mesure qu'ils n'importe quel assembly ou WinMD.

Extension Kit de développement logiciel

L'extension Kit de développement logiciel étendent une plateforme mais ne sont pas obligatoire pour développer des applications pour cette plateforme.Par exemple, le Bing Maps et Windows Live Kit de développement logiciel étendent Windows 8 mais ne sont pas nécessaires par les développeurs pour ce système d'exploitation.

Installation

L'extension Kit de développement logiciel peut être placée dans un des quatre emplacements :

• \Program Files\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs

• \Users\[nom d'utilisateur]\AppData\Local\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs

• Dans le fichier projet comme <PropertyGroup><SDKReferenceDirectoryRoot>dir1;dir2</SDKReferenceDirectoryRoot></PropertyGroup> où dir1 et dir2 identifient deux emplacements quelconques sur le disque

• HKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs\[SDKName]\[SDKVersion]\@default = [Kit de développement logiciel racine où [racine du Kit de développement logiciel] est [chemin d'accès du Kit de développement logiciel]\[SDKName]\[SDKVersion]\

Pour les trois premiers emplacements, aucune clé de Registre n'est requise.Vous pouvez simplement supprimer l'extension Kit de développement SDK dans l'emplacement à l'échelle, spécifique à l'utilisateur, ou personnalisé, et Visual Studio prendra simplement le Kit de développement logiciel.Si aucun de ces mécanismes ne convient, vous pouvez spécifier l'emplacement personnalisé du Kit de développement logiciel en utilisant le chemin d'accès au Registre dans le quatrième emplacement.

Disposition

L'extension Kit de développement logiciel aura la disposition suivante :

\[ExtensionSDKs root]
           \[SDKName]
                 \[SDKVersion]
                        SDKManifest.xml
                        \References
                              \[config]
                                    \[arch]
                        \Redist
                              \[config]
                                    \[arch]
                        \DesignTime
                               \[config]
                                     \[arch]

Nœud	Description
\[SDKName]\[SDKVersion]	Formulaire l'identité de l'extension Kit de développement logiciel.En d'autres termes, le nom et la version de l'extension Kit de développement logiciel est dérivé des noms de dossiers correspondants dans le chemin d'accès à la racine du Kit de développement logiciel.MSBuild utilise cette identité pour rechercher le Kit de développement logiciel sur le disque, et Visual Studio affiche cette identité dans la fenêtre Propriétés et le gestionnaire de référence.
Dossier Références	Se compose des binaires qui contiennent les API par rapport auxquelles peut être codé.Il peut s'agir des fichiers ou des assemblys de (WinMD) de métadonnées windows.
Dossier de composants redistribuables	Se compose de fichiers nécessaires pour l'exécution/débogage et doivent être empaquetés dans le cadre de l'application de l'utilisateur.Deux règles s'appliquent : Tout fichier binaire doit être défini sous \redist\[config]\[arch], et les noms des fichiers binaires doivent avoir le format suivant pour garantir l'unicité : [société].[product key].[objectif].[extension] .Par exemple, Microsoft.Cpp.Build.dll. Tout fichier avec le nom qui peut se heurter des noms de fichiers d'autres Kit de développement logiciel (par exemple, Javascript, CSS, PRI, XAML, PNG, et fichiers de jpg) doit être défini sous \redist\[config]\[arch]\[sdkname]\ à l'exception de les fichiers associés aux contrôles XAML.Ce fichier doit être défini sous \redist\[config]\[arch]\[componentname]\.
Dossier de DesignTime	Se compose des fichiers qui sont temps nécessaire uniquement géré par pre/débogage et ne doivent pas être empaquetés dans le cadre de l'application de l'utilisateur.Il peut s'agir des documents XML, bibliothèques, en-têtes, binaires au moment de le design de boîte à outils, artefacts MSBuild, etc. Attention Tout Kit de développement logiciel destiné à la consommation par un projet natif doit avoir un fichier d' SDKName.props.Le code suivant illustre un exemple de ce type de fichier. <?xml version="1.0" encoding="utf-8"?> <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"> <PropertyGroup> <ExecutablePath>C:\Temp\ExecutablePath;$(ExecutablePath)</ExecutablePath> <IncludePath>$(FrameworkSDKRoot)\..\v8.0\ExtensionSDKs\cppimagingsdk\1.0\DesignTime\CommonConfiguration\Neutral\include;$(IncludePath)</IncludePath> <AssemblyReferencePath>C:\Temp\AssemblyReferencePath;$(AssemblyReferencePath)</AssemblyReferencePath> <LibraryPath>$(FrameworkSDKRoot)\..\v8.0\ExtensionSDKs\cppimagingsdk\1.0\DesignTime\Debug\ARM;$(LibraryPath)</LibraryPath> <SourcePath>C:\Temp\SourcePath\X64;$(SourcePath)</SourcePath> <ExcludePath>C:\Temp\ExcludePath\X64;$(ExcludePath)</ExcludePath> <_PropertySheetDisplayName>DevILSDK, 1.0</_PropertySheetDisplayName> </PropertyGroup> </Project> Remarque Les documents XML idéalement seraient définis dans\dossier de DesignTime, mais les documents XML pour les références continueront à être placés à côté du fichier de référence dans Visual Studio 2012.Par exemple, XML documentation de référence \References\[config]\[arch]\sample.dll être \References\[config]\[arch]\sample.xml, et localisé version de ce document être \References\[config]\[arch]\[paramètres régionaux]\sample.xml.
Fichier de configuration	Il peut y avoir qu'trois dossiers : déboguez, version commerciale et CommonConfiguration.Les auteurs du Kit de développement logiciel peuvent définir leurs fichiers sous CommonConfiguration lorsque le même jeu de fichiers du Kit de développement logiciel doit être consommé, quelle que soit la valeur ciblée par le consommateur du Kit de développement logiciel.
Dossier d'architecture	Dossier charge d'architecture en peuvent exister.Visual Studio 2012 prend en charge les architectures suivantes : x86, x64, ARM, neutre.Mappe Win32 au x86, et cartes AnyCPU au neutre.
SDKManifest.xml	Ce fichier décrit comment Visual Studio doit utiliser le Kit de développement logiciel.Examinez le manifeste suivant de l'exemple Kit de développement logiciel. <FileList DisplayName = “My SDK” ProductFamilyName = “My SDKs” FrameworkIdentity-Debug = “Name=MySDK.10.Debug, MinVersion=1.0.0.0” FrameworkIdentity-Retail = “Name=MySDK.10, MinVersion=1.0.0.0” TargetFramework = “.NETCore, version=v4.5; .NETFramework, version=v4.5” MinVSVersion = “11.0” AppliesTo = "WindowsAppContainer + WindowsXAML" SupportPrefer32Bit = “OS” SupportedArchitectures = “x86;x64;ARM” SupportsMultipleVersions = “Error” AppX-Debug-x86 = “.\AppX\Debug\x86\Microsoft.MySDK.x86.Debug.1.0.appx” AppX-Debug-x64 = “.\AppX\Debug\x64\Microsoft.MySDK.x64.Debug.1.0.appx” AppX-Debug-ARM = “.\AppX\Debug\ARM\Microsoft.MySDK.ARM.Debug.1.0.appx” AppX-Release-x86 = “.\AppX\Retail\x86\Microsoft.MySDK.x86.1.0.appx” AppX-Release-x64 = “.\AppX\Retail\x64\Microsoft.MySDK.x64.1.0.appx” AppX-Release-ARM = “.\AppX\Retail\ARM\Microsoft.MySDK.ARM.1.0.appx” CopyRedistToSubDirectory = “.” DependsOn = “SDKB, version=2.0” MoreInfo = “https://msdn.microsoft.com/MySDK”> <File Reference = “MySDK.Sprint.winmd” Implementation = “XNASprintImpl.dll”> <Registration Type = “Flipper” Implementation = “XNASprintFlipperImpl.dll” /> <Registration Type = “Flexer” Implementation = “XNASprintFlexerImpl.dll” /> <ToolboxItems VSCategory = “Toolbox.Default” /> </File> </FileList> NœudDescription DisplayNameLa valeur qui apparaît dans le gestionnaire de référence, l'explorateur de solutions, l'Explorateur d'objets, et d'autres emplacements de l'interface utilisateur de Visual Studio. ProductFamilyNameLe nom de produit global du Kit de développement logiciel.Par exemple, Bibliothèque Windows pour JavaScript (WinJS) Kit de développement logiciel expédiera des Kit de développement logiciel avec le nom « Microsoft.WinJS.1.0 » et « Microsoft.WinJS.2.0 », qui appartiennent à la même famille de la famille de produits du Kit de développement logiciel, « Microsoft.WinJS ».Cet attribut permet à Visual Studio et à MSBuild pour générer ce rapport.Si cet attribut n'existe pas, le nom du Kit de développement logiciel est utilisé comme nom de famille de produits. FrameworkIdentityApplicable uniquement aux bibliothèques de composants Windows.La valeur de cet attribut est placée dans le manifeste d'application consommante pour indiquer la dépendance sur une ou plusieurs bibliothèques de composants Windows. TargetFrameworkÉvaluez utilisé pour déterminer quels Kit de développement logiciel sont disponibles dans le gestionnaire et la boîte à outils de référence.Cela peut être une liste délimitée par des points-virgules des monikers du Framework cible.Si plusieurs versions de la même infrastructure cible sont spécifiées, le gestionnaire de référence utilisera la plus basse version spécifiée pour filtrer les objectifs.Par exemple, si « .NET Framework, version=v2.0 ; le .NET Framework, version=v4.0 » est spécifié, le gestionnaire de référence utilise « .NET Framework, version=v2.0 ».Si un profil spécifique du .NET framework cible est spécifié, que ce profil sera utilisé par le gestionnaire de référence pour filtrer les objectifs.Par exemple, lorsque « Silverlight, version=v4.0, profile=WindowsPhone » est spécifié, le gestionnaire de référence filtrera uniquement sur les windows phone le profil ; un projet ciblant l'infrastructure complète Silverlight 4,0 ne verra pas le Kit de développement SDK dans le gestionnaire de référence. MinVSVersionUtilisé pour filtrer les Kit de développement logiciel révèlent dans chaque version de Visual Studio. AppliesTo Évaluez utilisé pour déterminer quels Kit de développement logiciel sont disponibles dans le gestionnaire de référence en spécifiant les types applicables de projet Visual Studio.Dans Visual Studio 2012, neuf valeurs sont identifiées : WindowsAppContainer, VisualC, VB, CSharp, WindowsXAML, JavaScript, géré, et natif.L'auteur du Kit de développement logiciel peut utiliser et (" + '), ou ("|"), pas ("! ") opérateurs pour spécifier exactement la portée des types de projet qui s'appliquent au Kit de développement logiciel. Remarque WindowsAppContainer identifie les projets pour les applications d' Windows Store . SupportPrefer32BitLes valeurs prises en charge sont « true » et « False ».Si la valeur a la valeur « true », le résultat est le même que si l'attribut n'ont pas été définies ; autrement dit, l'hypothèse par défaut est que Prefer32Bit est pris en charge.Si la valeur a la valeur « False », MSBuild retourne une erreur pour les projets d' Windows Store (ou un avertissement pour les projets de bureau) si le projet qui référence le Kit de développement logiciel a Prefer32Bit activé.Pour plus d'informations sur Prefer32Bit, consultez l'une des rubriques suivantes, selon le langage de programmation : Générer, page du Concepteur de projets (C#) Page Compiler, Concepteur de projets (Visual Basic) . SupportedArchitecturesUne liste délimitée par des points-virgules des architectures que le Kit de développement logiciel en charge.MSBuild affiche un avertissement si l'architecture ciblée du Kit de développement SDK dans le projet consommateur n'est pas prise en charge.Si cet attribut n'est pas spécifié, MSBuild n'affiche jamais ce type d'avertissement. SupportsMultipleVersionsSi cet attribut a la valeur Erreur ou à Avertissement, MSBuild indique que le même projet ne peut pas référencer plusieurs versions de la même famille du Kit de développement logiciel.Si cet attribut n'existe pas ou est défini à Autoriser, MSBuild n'affiche pas ce type d'erreur ou d'avertissement. AppXApplicable uniquement aux bibliothèques de composants Windows.Cette valeur d'attribut spécifie le chemin d'accès aux modules d'application pour la bibliothèque de composant Windows sur le disque, et le chemin d'accès est passé au composant d'inscription de la bibliothèque de composant Windows pendant le débogage local.La convention d'affectation de noms pour le nom de fichier est [société].[Product key].[Architecture].[Valeur].[Version] .appx.La configuration et l'architecture sont facultatives dans nom de l'attribut et la valeur d'attribut si elles ne s'appliquent pas à la bibliothèque de composant Windows. CopyRedistToSubDirectoryL'auteur du Kit de développement logiciel peut déterminer sous lequel les fichiers\dossier de composants redistribuables obtiendront copiés relatif à la racine du package d'application (autrement dit, Emplacement du package sélectionnez dans l'Assistant de module d'Applications de créer) et à la racine d'exécution de disposition.L'emplacement par défaut est la racine du package d'application et de la disposition sur F5. DependsOnListe délimitée d'identités du Kit de développement logiciel qui définissent le Kit de développement logiciel dont ce Kit de développement logiciel dépend.Cet attribut apparaît dans le volet d'informations de le gestionnaire de référence. MoreInfoContient l'URL de la page Web qui fournit le consommateur du Kit de développement logiciel à l'aide.Cette valeur est utilisée dans plus d'informations dans le volet de droite du gestionnaire de référence. Référence de fichierCet attribut doit être spécifié pour que ces assembly/références de WinMD qui contiennent des contrôles ou sont le natif WinMD dont le type d'inscription doit être spécifié. Type d'inscriptionCet attribut spécifie l'alignement de WinMD dans le manifeste d'application et est utile pour le natif WinMD, qui a une DLL implémentation d'homologues. Boîte à outils Le tableau suivant décrit les attributs pris en charge. Jeu dans la boîte à outilsExemple de SDKManifest.xml (applicable à toute référence – WinMD ou DLL) Énumérer tous les contrôles, et placez-les dans la catégorie de boîte à outils par défaut. <File Reference = “sample.winmd”> <ToolboxItems VSCategory = “Toolbox.Default”/> </File> Énumérer tous les contrôles, et placez-les sous un nom particulier de catégorie. <File Reference = “sample.winmd”> <ToolboxItems VSCategory= “MyCategoryName”/> </File> Énumérez les contrôles spécifiques, et placez-les sous des noms particuliers de catégorie. <File Reference = “sample.winmd”> < ToolboxItems VSCategory = “Graph”> <item Type = “sample.bargraph”/> <Item Type = “sample.piegraph”/> < ToolboxItems/> < ToolboxItems VSCategory = “Data”> <Item Type = “sample.datagrid”/> <Item Type = “sample.dataconnection”/> < ToolboxItems /> </File> Énumérez les contrôles spécifiques, et placez-les sous différents noms de catégorie dans la fusion et Visual Studio. // Blend accepts a slightly different structure for the category name because it allows a path rather than a single category. <File Reference = “sample.winmd”> < ToolboxItems VSCategory = “Graph” BlendCategory = “Controls/sample/Graph”> <item Type = “sample.bargraph”/> <Item Type = “sample.piegraph”/> < ToolboxItems /> </File> Énumérez les contrôles spécifiques différemment dans la fusion et Visual Studio. <File Reference = “sample.winmd”> < ToolboxItems VSCategory = “Graph”> <item Type = “sample.bargraph”/> <Item Type = “sample.piegraph”/> <ToolboxItems/> < ToolboxItems BlendCategory = “Controls/sample/Graph”> <Item Type = “sample.piegraph”/> <ToolboxItems/> </File> Énumérez les contrôles spécifiques, et placez-les sous le chemin commun de Visual Studio ou uniquement à tout le groupe de contrôles. <File Reference = “sample.winmd”> < ToolboxItems VSCategory = “Toolbox.Common”> <item Type = “sample.bargraph”/> <Item Type = “sample.piegraph”/> < ToolboxItems /> < ToolboxItems VSCategory = “Toolbox.All”> <Item Type = “sample.datagrid”/> <Item Type = “sample.dataconnection”/> < ToolboxItems /> </File> Énumérez les contrôles spécifiques, et le afficher uniquement un spécifique défini dans ChooseItems sans eux étant dans la boîte à outils. <File Reference = “sample.winmd”> < ToolboxItems VSCategory = “Toolbox.ChooseItemsOnly”> <item Type = “sample.bargraph”/> <Item Type = “sample.piegraph”/> < ToolboxItems /> </File>

Dans Visual Studio

Référence gestionnaire surveiller plateforme cible moniker (TPM) puis remplacer valeur de propriété dans \Program Files\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs, \Users\[username]\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs et HKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\ExtensionSDKs\ pour déterminer l'emplacement sur disque de l'extension Kit de développement logiciel.

Le gestionnaire de référence ouvre le manifeste du Kit de développement logiciel de chaque extension Kit de développement logiciel pour déterminer si l'extension Kit de développement logiciel s'applique à la version de Visual Studio dans laquelle le gestionnaire de référence a été appelé, si l'extension Kit de développement logiciel s'applique selon le Framework cible du projet qui a appelé le gestionnaire de référence, et si les valeurs d'attribut d'AppliesTo correspondent aux fonctions publiées du système de projet qui a appelé le gestionnaire de référence.Si l'extension Kit de développement logiciel s'applique à tous les nombres, le gestionnaire de référence affichera le DisplayName, la version, et les dépendances du Kit de développement logiciel puis remplira plus d'informations selon correctement le manifeste de l'extension Kit de développement logiciel.

Une extension Kit de développement logiciel apparaît comme entrée unique dans le gestionnaire de référence.Une fois ajoutée, il apparaît comme un nœud unique dans Explorateur de solutions pour les applications managées et des applications d' Windows Store générées pour windows à l'aide de JavaScript.Le Kit de développement logiciel apparaît également comme entrée unique dans les pages de propriétés des projets Visual C++.L'utilisateur maintenant ne doit pas gérer une autre action.L'utilisateur est défini pour Intellisense, la boîte à outils, les concepteurs, l'Explorateur d'objets, la génération, le déploiement, le débogage, et l'empaquetage.

[!REMARQUE]

1. Selon la configuration et l'architecture ciblées par projet, Visual Studio sélectionne les références de la moins spécifique à la plus spécifique.Par exemple, si la configuration ciblée du Kit de développement logiciel est le débogage et l'architecture ciblée du Kit de développement logiciel est x86, Visual Studio énumèrera toutes les références, en commençant par\\\références commonconfiguration neutre, puis références commonconfiguration\\\x86, puis références\\ debug\neutre, et enfin références\\ debug\x86.Il supprime tous les doublons de confiance moindre et spécifiques passe toutes les références au compilateur pour Intellisense.Cette façon des références de cueillette permet à l'auteur du Kit de développement logiciel la souplesse pas de devoir dupliquer leurs références sous des dossiers multiples\\ configuration architecture.

2. Si le projet référence un Kit de développement logiciel qui dépend d'un autre Kit de développement logiciel, Visual Studio ne consommeront pas automatiquement le deuxième Kit de développement logiciel.L'utilisateur doit ajouter manuellement une référence au deuxième Kit de développement logiciel.Pour faciliter l'utilisateur à déduire des dépendances du Kit de développement logiciel, dans la boîte de dialogue gestionnaire de référence, lorsqu'un Kit de développement logiciel est spécifié sous l'onglet d'extensions, le volet d'informations affiche le nom et la version du Kit de développement logiciel, et (si le Kit de développement logiciel dépend d'un autre Kit de développement logiciel windows) le nom de la dépendance du Kit de développement logiciel.Lorsque les dépendances du Kit de développement logiciel ne sont pas satisfaites, MSBuild retourne un avertissement qui invite l'utilisateur à ajouter des dépendances.

3. FrameworkIdentity : Visual Studio la recherche d'abord pour FrameworkIdentity-[config]-[arch], puis FrameworkIdentity-[config], puis FrameworkIdentity-[arch], puis FrameworkIdentity.Lorsqu'il trouve une correspondance, il stocke la valeur de l'attribut correspondant.

4. AppX : Les tests de programme de résolution du Kit de développement logiciel pour choisir l'attribut d'AppX le plus spécifique par architecture ; préférence par ordre décroissant : AppX-[config]-[arch] (ou AppX-[config] dans le cas neutre), puis AppX-[arch], et enfin AppX.Par exemple, si un manifeste du Kit de développement logiciel spécifiait les attributs suivants d'AppX : « AppX-x86 », « AppX-debug-x86 », « AppX-x64 », « AppX- ARM », « AppX- AIE » et « AppX », et le projet ciblaient debug et x86, les sélections « AppX-debug-x86 » du programme de résolution du Kit de développement logiciel, « AppX-x64 », « AppX- ARM », « AppX- AIE » et « AppX ».

5. Dans un modèle de projet qui référence un Kit de développement logiciel, vous devez spécifier la référence du Kit de développement logiciel de la manière suivante :

   <ItemGroup> <SDKReference Include="MySDK, Version=1.0">    <Name>My SDK</Name>  </SDKReference> </ItemGroup>

Voir aussi

Tâches

Procédure pas à pas : création d'un SDK à l'aide de C++

Procédure pas à pas : création d'un SDK à l'aide de C#

Concepts

Gestion des références de projet