Création d’un kit de développement logicielCreate a software development kit

Un kit de développement logiciel (SDK) est une collection d’API que vous pouvez référencer en tant qu’un seul élément dans Visual Studio.A software development kit (SDK) is a collection of APIs that you can reference as a single item in Visual Studio. Le Gestionnaire de références boîte de dialogue répertorie tous les kits de développement logiciel qui sont pertinents pour le projet.The Reference Manager dialog box lists all the SDKs that are relevant to the project. Lorsque vous ajoutez un kit SDK à un projet, les API sont disponibles dans Visual Studio.When you add an SDK to a project, the APIs are available in Visual Studio.

Il existe deux types de kits de développement logiciel :There are two types of SDKs:

  • Les kits de développement Platform SDK sont les composants obligatoires pour le développement d’applications pour une plateforme.Platform SDKs are mandatory components for developing apps for a platform. Par exemple, le Windows 8.1Windows 8.1 SDK est requis pour développer Windows 8.x StoreWindows 8.x Store applications.For example, the Windows 8.1Windows 8.1 SDK is required to develop Windows 8.x StoreWindows 8.x Store apps.

  • SDK d’extension est des composants facultatifs qui étendent une plateforme, mais ne sont pas obligatoires pour le développement d’applications pour cette plateforme.Extension SDKs are optional components that extend a platform but aren't mandatory for developing apps for that platform.

    Les sections suivantes décrivent l’infrastructure générale de kits de développement logiciel et comment créer un kit platform SDK et un SDK d’extension.The following sections describe the general infrastructure of SDKs and how to create a platform SDK and an extension SDK.

  • Kits SDK de plateformePlatform SDKs

  • SDK d’extensionExtension SDKs

Kits SDK de plateformePlatform SDKs

Les kits de développement Platform SDK sont requis pour développer des applications pour une plateforme.Platform SDKs are required to develop apps for a platform. Par exemple, le Windows 8.1Windows 8.1 SDK est nécessaire pour développer des applications pour Windows 8.1Windows 8.1.For example, the Windows 8.1Windows 8.1 SDK is required to develop apps for Windows 8.1Windows 8.1.

InstallationInstallation

Plateforme de tous les kits de développement logiciel sera installé àHKLM\Software\Microsoft\Microsoft SDK\[TPI] \v [TPV]\ @InstallationFolder = [racine SDK].All platform SDKs will be installed atHKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\@InstallationFolder = [SDK root]. En conséquence, le Windows 8.1Windows 8.1 SDK est installé dans HKLM\Software\Microsoft\Microsoft SDKs\Windows\v8.1.Accordingly, the Windows 8.1Windows 8.1 SDK is installed at HKLM\Software\Microsoft\Microsoft SDKs\Windows\v8.1.

Mise en pageLayout

Kits de développement logiciel Platform aura la disposition suivante :Platform SDKs will have the following layout:

\[InstallationFolder root]  
            SDKManifest.xml  
            \References  
                  \[config]  
                        \[arch]  
            \DesignTime  
                  \[config]  
                        \[arch]  
NœudNode DescriptionDescription
Références dossierReferences folder Contient les fichiers binaires qui contiennent des API qui peuvent être codées.Contains binaries that contain APIs that can be coded against. Il peut s’agir de fichiers de métadonnées Windows (WinMD) ou des assemblys.These could include Windows Metadata (WinMD) files or assemblies.
DesignTime dossierDesignTime folder Contient les fichiers qui sont nécessaires uniquement au moment de pré-exécution et de débogage.Contains files that are needed only at pre-run/debugging time. Il peut inclure des documents XML, bibliothèques, en-têtes, les fichiers binaires de boîte à outils au moment du design, les artefacts de MSBuild, etc.These could include XML docs, libraries, headers, Toolbox design-time binaries, MSBuild artifacts, and so forth

Documents XML, dans l’idéal, est placés dans le \DesignTime dossier, mais les documents XML pour les références continueront à être placé en même temps que le fichier de référence dans Visual Studio.XML docs would, ideally, be placed in the \DesignTime folder, but XML docs for references will continue to be placed alongside the reference file in Visual Studio. Par exemple, le document XML pour une référence\References\[configuration]\[arch]\sample.dll sera \References\[configuration]\[arch]\sample.xml, et la version localisée de ce document sera \References\[configuration]\[arch]\[locale]\sample.xml.For example, the XML doc for a reference\References\[config]\[arch]\sample.dll will be \References\[config]\[arch]\sample.xml, and the localized version of that doc will be \References\[config]\[arch]\[locale]\sample.xml.
Configuration dossierConfiguration folder Il peut y avoir uniquement trois dossiers : déboguer, Retail et CommonConfiguration.There can be only three folders: Debug, Retail and CommonConfiguration. Les auteurs de kit de développement logiciel peuvent placer leurs fichiers sous CommonConfiguration si le même ensemble de fichiers SDK doit être utilisé, quelle que soit la configuration qui cible le consommateur du Kit de développement logiciel.SDK authors can place their files under CommonConfiguration if the same set of SDK files should be consumed, regardless of the configuration that the SDK consumer will target.
Architecture dossierArchitecture folder Pris en charge architecture dossier peut exister.Any supported architecture folder can exist. Visual Studio prend en charge les architectures suivantes : x86, x64, ARM et neutre.Visual Studio supports the following architectures: x86, x64, ARM, and neutral. Remarque : Win32 mappé à x86 et AnyCPU mappe à neutre.Note: Win32 maps to x86, and AnyCPU maps to neutral.

MSBuild recherche uniquement sous \CommonConfiguration\neutral de développement logiciel Platform SDK.MSBuild looks only under \CommonConfiguration\neutral for Platform SDKs.
SDKManifest.xmlSDKManifest.xml Ce fichier décrit comment Visual Studio doit utiliser le Kit de développement.This file describes how Visual Studio should consume the SDK. Examinez le manifeste SDK pour Windows 8.1Windows 8.1:Look at the SDK Manifest for Windows 8.1Windows 8.1:

<FileList DisplayName = "Windows" PlatformIdentity = "Windows, version=8.1" TargetFramework = ".NET for Windows Store apps, version=v4.5.1; .NET Framework, version=v4.5.1" MinVSVersion = "14.0"> <File Reference = "Windows.winmd"> <ToolboxItems VSCategory = "Toolbox.Default" /> </File> </FileList>

DisplayName : la valeur de l’Explorateur d’objets affiche dans la liste de navigation.DisplayName: The value that the Object Browser displays in the Browse list.

PlatformIdentity : l’existence de cet attribut indique à Visual Studio et MSBuild que le SDK est un kit platform SDK et que les références ajoutées à partir de celui-ci ne doit pas être copiés localement.PlatformIdentity: The existence of this attribute tells Visual Studio and MSBuild that the SDK is a platform SDK and that the references added from it shouldn't be copied locally.

TargetFramework : cet attribut est utilisé par Visual Studio pour vous assurer qu’uniquement les projets qui ciblent les Frameworks mêmes tel que spécifié dans la valeur de cet attribut peut consommer le Kit de développement.TargetFramework: This attribute is used by Visual Studio to ensure that only projects that target the same Frameworks as specified in the value of this attribute can consume the SDK.

MinVSVersion : cet attribut est utilisé par Visual Studio pour utiliser uniquement les kits de développement logiciel qui s’y appliquent.MinVSVersion: This attribute is used by Visual Studio to consume only the SDKs that apply to it.

Référence : cet attribut doit être spécifié pour que les références qui contiennent des contrôles.Reference: This attribute must to be specified for only those references that contain controls. Pour plus d’informations sur la façon de spécifier si une référence contient des contrôles, voir ci-dessous.For information about how to specify whether a reference contains controls, see below.

SDK d’extensionExtension SDKs

Les sections suivantes décrivent ce que vous devez faire pour déployer un kit SDK d’extension.The following sections describe what you need to do to deploy an extension SDK.

InstallationInstallation

SDK d’extension peut être installé pour un utilisateur spécifique ou pour tous les utilisateurs sans spécifier une clé de Registre.Extension SDKs can be installed for a specific user or for all users without specifying a registry key. Pour installer un kit de développement logiciel pour tous les utilisateurs, utilisez le chemin d’accès suivant :To install an SDK for all users, use the following path:

% Programme Files%\Microsoft SDK<plateforme cible > \v\ExtensionSDKs%Program Files%\Microsoft SDKs<target platform>\v\ExtensionSDKs

Pour une installation spécifique à l’utilisateur, utilisez le chemin d’accès suivant :For a user-specific installation, use the following path:

Kits de développement logiciel de %USERPROFILE%\AppData\Local\Microsoft<plateforme cible > \v\ExtensionSDKs%USERPROFILE%\AppData\Local\Microsoft SDKs<target platform>\v\ExtensionSDKs

Si vous souhaitez utiliser un autre emplacement, vous devez effectuer une des deux opérations :If you want to use a different location, you must do one of two things:

  1. Spécifier dans une clé de Registre :Specify it in a registry key:

    Kits de développement logiciel HKLM\Software\Microsoft\Microsoft<plateforme cible > \v\ExtensionSDKs<SDKName ><SDKVersion >\HKLM\Software\Microsoft\Microsoft SDKs<target platform>\v\ExtensionSDKs<SDKName><SDKVersion>\

    et ajoutez une sous-clé (par défaut) qui a la valeur <path to SDK><SDKName><SDKVersion>.and add a (Default) subkey that has a value of <path to SDK><SDKName><SDKVersion>.

  2. Ajoutez la propriété MSBuild SDKReferenceDirectoryRoot à votre fichier projet.Add the MSBuild property SDKReferenceDirectoryRoot to your project file. La valeur de cette propriété est une liste délimitée par des points-virgules des répertoires dans lesquels résident le SDK d’Extension que vous souhaitez référencer.The value of this property is a semicolon delimited list of directories in which the Extension SDKs you want to reference reside.

Disposition d’installationInstallation layout

SDK d’extension ont la disposition d’installation suivantes :Extension SDKs have the following installation layout:

\<ExtensionSDKs root>  
           \<SDKName>  
                 \<SDKVersion>  
                        SDKManifest.xml  
                        \References  
                              \<config>  
                                    \<arch>  
                        \Redist  
                              \<config>  
                                    \<arch>  
                        \DesignTime  
                               \<config>  
                                     \<arch>  
  1. \< SDKName>\< SDKVersion>: le nom et la version de l’extension SDK est dérivé des noms de dossiers correspondants dans le chemin d’accès à la racine du Kit de développement logiciel.\<SDKName>\<SDKVersion>: the name and version of the extension SDK is derived from the corresponding folder names in the path to the SDK root. MSBuild utilise cette identité pour trouver le Kit de développement sur le disque, et Visual Studio affiche cette identité dans le propriétés fenêtre et Gestionnaire de références boîte de dialogue.MSBuild uses this identity to find the SDK on disk, and Visual Studio displays this identity in the Properties window and Reference Manager dialog.

  2. Références dossier : les fichiers binaires qui contiennent les API.References folder: the binaries that contain the APIs. Il peut s’agir de fichiers de métadonnées Windows (WinMD) ou des assemblys.These could be Windows Metadata (WinMD) files or assemblies.

  3. Redist dossier : les fichiers qui sont nécessaires pour l’exécution et de débogage et doivent obtenir un package d’application de l’utilisateur.Redist folder: the files that are needed for runtime/debugging and should get packaged as part of the user's application. Tous les fichiers binaires doivent être placés sous \redist\< config>\< arch>, et les noms binaire doivent avoir le format suivant pour garantir l’unicité : ] <société >. <produit >. <usage >. <extension > *.All binaries should be placed underneath \redist\<config>\<arch>, and the binary names should have the following format to ensure uniqueness: ]<company>.<product>.<purpose>.<extension>*. Par exemple, Microsoft.Cpp.Build.dll.For example, Microsoft.Cpp.Build.dll. Tous les fichiers portant des noms qui peuvent entrer en conflit avec les noms de fichiers à partir d’autres kits de développement logiciel (par exemple, les fichiers javascript, css, pri, xaml, png et jpg) doivent être placés sous * \redist\< config>\< arch> \< sdkname> * à l’exception des fichiers qui sont associés à XAML contrôle.All files with names that may collide with file names from other SDKs (for example, javascript, css, pri, xaml, png, and jpg files) should be placed underneath \redist\<config>\<arch>\<sdkname>* except for the files that are associated with XAML controls. Ces fichiers doivent être placés sous *\redist\< config>\< arch>\< componentname>\.These files should be placed underneath \redist\<config>\<arch>\<componentname>\.

  4. DesignTime dossier : les fichiers qui sont nécessaires au seul pré-exécution et de débogage de temps et ne doit pas être un package d’application de l’utilisateur.DesignTime folder: the files that are needed at only pre-run/debugging time and shouldn't be packaged as part of the user's application. Il peut s’agir de documents XML, bibliothèques, en-têtes, les fichiers binaires de boîte à outils au moment du design, les artefacts de MSBuild et ainsi de suite.These could be XML docs, libraries, headers, toolbox design-time binaries, MSBuild artifacts, and so forth. N’importe quel SDK est conçue pour la consommation par un projet natif doit avoir un SDKName.props fichier.Any SDK that is intended for consumption by a native project must have an SDKName.props file. L’exemple suivant montre un exemple de ce type de fichier.The following shows a sample of this type of file.

    <?xml version="1.0" encoding="utf-8"?>  
    <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
      <PropertyGroup>  
        <ExecutablePath>C:\Temp\ExecutablePath;$(ExecutablePath)</ExecutablePath>  
        <IncludePath>$(FrameworkSDKRoot)\..\v8.1\ExtensionSDKs\cppimagingsdk\1.0\DesignTime\CommonConfiguration\Neutral\include;$(IncludePath)</IncludePath>  
        <AssemblyReferencePath>C:\Temp\AssemblyReferencePath;(AssemblyReferencePath)</AssemblyReferencePath>  
        <LibraryPath>$(FrameworkSDKRoot)\..\v8.1\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>  
    

    Documents de référence XML sont placés en même temps que le fichier de référence.XML reference documents are placed alongside the reference file. Par exemple, le document de référence XML pour le \References\< config>\< arch>\sample.dll assembly est \References\ < config>\< arch>\sample.xml, et la version localisée de ce document est \References\< config>\< arch>\< paramètres régionaux>\sample.xml.For example, the XML reference document for the \References\<config>\<arch>\sample.dll assembly is \References\<config>\<arch>\sample.xml, and the localized version of that doc is \References\<config>\<arch>\<locale>\sample.xml.

  5. Configuration dossier : trois sous-dossiers : déboguer, Retail, et CommonConfiguration.Configuration folder: three subfolders: Debug, Retail, and CommonConfiguration. Les auteurs de kit de développement logiciel peuvent placer leurs fichiers sous CommonConfiguration lorsque le même ensemble de fichiers SDK doit être utilisé, quelle que soit la configuration ciblée par le consommateur SDK.SDK authors can place their files under CommonConfiguration when the same set of SDK files should be consumed, regardless of the configuration targeted by the SDK consumer.

  6. Architecture dossier : les architectures suivantes sont prises en charge : x86, x64, ARM, neutre.Architecture folder: the following architectures are supported: x86, x64, ARM, neutral. Win32 est mappé à x86 et AnyCPU mappe à neutre.Win32 maps to x86, and AnyCPU maps to neutral.

SDKManifest.xmlSDKManifest.xml

Ce fichier décrit comment Visual Studio doit utiliser le Kit de développement.This file describes how Visual Studio should consume the SDK. Voici un exemple.The following is an example.

<FileList>  
DisplayName = "My SDK"  
ProductFamilyName = "My SDKs"  
TargetFramework = ".NETCore, version=v4.5.1; .NETFramework, version=v4.5.1"  
MinVSVersion = "14.0"  
MaxPlatformVersion = "8.1"  
AppliesTo = "WindowsAppContainer + WindowsXAML"  
SupportPrefer32Bit = "True"  
SupportedArchitectures = "x86;x64;ARM"  
SupportsMultipleVersions = "Error"  
CopyRedistToSubDirectory = "."  
DependsOn = "SDKB, version=2.0"  
MoreInfo = "http://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>  

La liste suivante donne les éléments du fichier.The following list gives the elements of the file.

  1. DisplayName : la valeur qui apparaît dans le Gestionnaire de références, l’Explorateur de solutions, Explorateur d’objets et autres emplacements dans l’interface utilisateur pour Visual Studio.DisplayName: the value that appears in the Reference Manager, Solution Explorer, Object Browser, and other locations in the user interface for Visual Studio.

  2. ProductFamilyName : Globale SDK nom de produit.ProductFamilyName: The overall SDK product name. Par exemple, le Bibliothèque Windows pour JavaScript (WinJS)Windows Library for JavaScript (WinJS) SDK est nommé « Microsoft.WinJS.1.0 » et « Microsoft.WinJS.2.0 », qui appartiennent à la même famille de la famille de produits de kit de développement logiciel, « Microsoft.WinJS ».For example, the Bibliothèque Windows pour JavaScript (WinJS)Windows Library for JavaScript (WinJS) SDK is named "Microsoft.WinJS.1.0" and "Microsoft.WinJS.2.0", which belong to the same family of SDK products family, "Microsoft.WinJS". Cet attribut permet à Visual Studio et MSBuild établir cette connexion.This attribute allows Visual Studio and MSBuild to make that connection. Si cet attribut n’existe pas, le nom du SDK est utilisé comme nom de famille de produit.If this attribute doesn't exist, the SDK Name is used as the product family name.

  3. FrameworkIdentity : Spécifie une dépendance sur un ou plusieurs bibliothèques de composants de Windows que la valeur de cet attribut est placée dans le manifeste de l’application consommatrice.FrameworkIdentity: Specifies a dependency on one or more Windows component libraries The value of this attribute is put into the consuming app's manifest. Cet attribut s’applique uniquement aux bibliothèques de composants Windows.This attribute is applicable only to Windows component libraries.

  4. TargetFramework : Spécifie les kits SDK qui sont disponibles dans le Gestionnaire de références et de la boîte à outils.TargetFramework: Specifies the SDKs that are available in the Reference Manager and the toolbox. Il s’agit d’une liste délimitée par des points-virgules des monikers du framework cible, par exemple « .NET Framework, version = v2.0 ; .NET Framework, version = v4.5.1 ».This is a semicolon-delimited list of target framework monikers, for example ".NET Framework, version=v2.0; .NET Framework, version=v4.5.1". Si plusieurs versions du même framework cible sont spécifiées, le Gestionnaire de références utilise la version la plus basse spécifiée pour le filtrage à des fins.If several versions of the same target framework are specified, the Reference Manager uses the lowest specified version for filtering purposes. Par exemple, si « .NET Framework, version = v2.0 ; .NET Framework, version = v4.5.1 » est spécifié, Gestionnaire de références utilisera « .NET Framework, version = v2.0 ».For example, if ".NET Framework, version=v2.0; .NET Framework, version=v4.5.1" is specified, Reference Manager will use ".NET Framework, version=v2.0". Si un profil de framework cible spécifique est spécifié, uniquement ce profil sera utilisé par le Gestionnaire de références pour le filtrage à des fins.If a specific target framework profile is specified, only that profile will be used by the Reference Manager for filtering purposes. Par exemple, lorsque « Silverlight, version = v4.0, profil = WindowsPhone » est spécifié, les filtres de gestionnaire de références sur uniquement le profil Windows Phone ; un projet qui cible le Framework Silverlight 4.0 ne voit pas le Kit de développement dans le Gestionnaire de références.For example, when "Silverlight, version=v4.0, profile=WindowsPhone" is specified, Reference Manager filters on only the Windows Phone profile; a project targeting the full Silverlight 4.0 Framework does not see the SDK in the Reference Manager.

  5. MinVSVersion : Version minimale de Visual Studio.MinVSVersion: The minimum Visual Studio version.

  6. MaxPlatformVerson : La version de la plateforme cible maximale doit être utilisée pour spécifier les versions de la plateforme sur laquelle votre SDK d’Extension ne fonctionnera pas.MaxPlatformVerson: The maximum target platform version should be used to specify the platform versions on which your Extension SDK will not work. Par exemple, de Microsoft Visual C++ Runtime Package v11.0 doivent être référencés que par les projets Windows 8.For example, the Microsoft Visual C++ Runtime Package v11.0 should be referenced only by Windows 8 projects. Par conséquent, MaxPlatformVersion du projet Windows 8 est 8.0.Thus, the Windows 8 project's MaxPlatformVersion is 8.0. Cela signifie que le Gestionnaire de références exclut Microsoft Visual C++ Runtime Package pour un projet Windows 8.1 et MSBuild génère une erreur lorsqu’un Windows 8.1Windows 8.1 projet y fait référence.This means that the Reference Manager filters out Microsoft Visual C++ Runtime Package for a Windows 8.1 project, and MSBuild throws an error when a Windows 8.1Windows 8.1 project references it. Remarque : cet élément est pris en charge dans Visual Studio 2013Visual Studio 2013.Note: this element is supported starting in Visual Studio 2013Visual Studio 2013.

  7. AppliesTo : Spécifie les kits SDK qui sont disponibles dans le Gestionnaire de références en spécifiant les types de projet Visual Studio applicables.AppliesTo: Specifies the SDKs that are available in the Reference Manager by specifying applicable Visual Studio project types. Neuf valeurs sont reconnus : WindowsAppContainer VisualC, VB, CSharp, WindowsXAML, JavaScript, géré et natif.Nine values are recognized: WindowsAppContainer, VisualC, VB, CSharp, WindowsXAML, JavaScript, Managed, and Native. L’auteur du Kit de développement logiciel permettre utiliser et (« + »), ou («|»), et non (« ! ») opérateurs pour spécifier exactement l’étendue des types de projets qui s’appliquent au kit SDK.The SDK author can use and ("+'), or ("|"), not ("!") operators to specify exactly the scope of project types that apply to the SDK.

    WindowsAppContainer identifie les projets pour Windows 8.x StoreWindows 8.x Store applications.WindowsAppContainer identifies projects for Windows 8.x StoreWindows 8.x Store apps.

  8. SupportPrefer32Bit : Les valeurs prises en charge sont « True » et « False ».SupportPrefer32Bit: Supported values are "True" and "False". La valeur par défaut est « True ».The default is "True". Si la valeur est définie sur « False », MSBuild retourne une erreur pour Windows 8.x StoreWindows 8.x Store projets (ou un avertissement pour les projets de bureau) si le projet qui référence le SDK Prefer32Bit activé.If the value is set to "False", MSBuild returns an error for Windows 8.x StoreWindows 8.x Store projects (or a warning for desktop projects) if the project that references the SDK has Prefer32Bit enabled. Pour plus d’informations sur Prefer32Bit, consultez Build, page du Concepteur de projet (c#) ou page compiler, Concepteur de projets (Visual Basic).For more information about Prefer32Bit, see Build page, Project Designer (C#) or Compile page, Project Designer (Visual Basic).

  9. SupportedArchitectures : Une liste délimitée par des architectures prenant en charge le Kit de développement.SupportedArchitectures: A semicolon delimited list of architectures that the SDK supports. MSBuild affiche un avertissement si l’architecture SDK ciblé dans le projet de consommation n’est pas pris en charge.MSBuild displays a warning if the targeted SDK architecture in the consuming project isn't supported. Si cet attribut n’est pas spécifié, MSBuild affiche jamais ce type d’alerte.If this attribute isn't specified, MSBuild never displays this type of warning.

  10. SupportsMultipleVersions : Si cet attribut est défini erreur ou avertissement, MSBuild indique que le même projet ne peut pas référencer plusieurs versions de la même famille de kit de développement logiciel.SupportsMultipleVersions: If this attribute is set to Error or Warning, MSBuild indicates that the same project can't reference multiple versions of the same SDK family. Si cet attribut n’existe pas ou est défini sur autoriser, MSBuild n’affiche pas ce type d’erreur ou un avertissement.If this attribute doesn't exist or is set to Allow, MSBuild doesn't display this type of error or warning.

  11. AppX : Spécifie le chemin d’accès aux packages d’application pour la bibliothèque de composant de Windows sur le disque.AppX: Specifies the path to the app packages for the Windows component library on the disk. Cette valeur est passée au composant d’inscription de la bibliothèque de composant Windows pendant le débogage local.This value is passed to the registration component of the Windows component library during local debugging. La convention d’affectation de noms pour le nom de fichier est <société >.< Produit >. <Architecture >. <Configuration >. <Version > .appx.The naming convention for the file name is <Company>.<Product>.<Architecture>.<Configuration>.<Version>.appx. Configuration et Architecture sont facultatives dans le nom d’attribut et la valeur d’attribut si elles ne s’appliquent pas à la bibliothèque de composant de Windows.Configuration and Architecture are optional in the attribute name and the attribute value if they don't apply to the Windows component library. Cette valeur s’applique uniquement aux bibliothèques de composants Windows.This value is applicable only to Windows component libraries.

  12. CopyRedistToSubDirectory : Spécifie l’emplacement où les fichiers sous le \redist dossier doit être copié par rapport à la racine de package d’application (autrement dit, le emplacement du Package choisi dans le créer une application Package Assistant) et la racine de disposition de runtime.CopyRedistToSubDirectory: Specifies where the files under the \redist folder should be copied relative to the app package root (that is, the Package location chosen in the Create App Package wizard) and runtime layout root. L’emplacement par défaut est la racine du package d’application et F5 mise en page.The default location is the root of the app package and F5 layout.

  13. DependsOn : Une liste d’identités de kit de développement logiciel qui définissent les kits de développement logiciel dont dépend ce SDK.DependsOn: A list of SDK identities that define the SDKs on which this SDK depends. Cet attribut apparaît dans le volet de détails du Gestionnaire de référence.This attribute appears in the details pane of the Reference Manager.

  14. MoreInfo : L’URL vers la page web qui fournit une aide et des informations supplémentaires.MoreInfo: The URL to the web page that provides help and more information. Cette valeur est utilisée dans le lien informations supplémentaires dans le volet droit du Gestionnaire de référence.This value is used in the More Information link in the right pane of the Reference Manager.

  15. Type d’enregistrement : Spécifie l’inscription WinMD dans le manifeste d’application et est requis pour les WinMD natif, ce qui a une implémentation équivalent DLL.Registration Type: Specifies the WinMD registration in the app manifest and is required for native WinMD, which has a counterpart implementation DLL.

  16. Référence de fichier : Spécifiée pour que les références qui contiennent des contrôles ou sont les Winmd natifs.File Reference: Specified for only those references that contain controls or are native WinMDs. Pour plus d’informations sur la façon de spécifier si une référence contient des contrôles, consultez spécifier l’emplacement des éléments de boîte à outils ci-dessous.For information about how to specify whether a reference contains controls, see Specify the location of toolbox items below.

Spécifiez l’emplacement des éléments de boîte à outilsSpecify the location of toolbox items

L’élément ToolBoxItems de la SDKManifest.xml schéma spécifie la catégorie et l’emplacement des éléments de boîte à outils dans les kits SDK de plateforme et d’extension.The ToolBoxItems element of the SDKManifest.xml schema specifies the category and location of toolbox items in both platform and extension SDKs. Les exemples suivants montrent comment spécifier des emplacements différents.The following examples show how to specify different locations. Cela s’applique aux références WinMD ou DLL.This is applicable to either WinMD or DLL references.

  1. Placer des contrôles dans la catégorie par défaut de boîte à outils.Place controls in the toolbox default category.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Toolbox.Default"/>       
    </File>  
    
  2. Placez les contrôles sous un nom de catégorie particulier.Place controls under a particular category name.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory= "MyCategoryName"/>  
    </File>  
    
  3. Placez les contrôles sous les noms de catégorie particulière.Place controls under particular category names.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Graph">  
        <ToolboxItems/>  
        <ToolboxItems VSCategory = "Data">  
        <ToolboxItems />  
    </File>  
    
  4. Placer des contrôles sous les noms de catégorie différente dans Blend et Visual Studio.Place controls under different category names in Blend and 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">   
        <ToolboxItems />  
    </File>  
    
  5. Énumérer des contrôles spécifiques différemment dans Blend et Visual Studio.Enumerate specific controls differently in Blend and Visual Studio.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Graph">  
        <ToolboxItems/>  
        <ToolboxItems BlendCategory = "Controls/sample/Graph">  
        <ToolboxItems/>  
    </File>  
    
  6. Énumérer des contrôles spécifiques et les placer sous le chemin d’accès de courants de Visual Studio, ou uniquement dans le groupe tous les contrôles.Enumerate specific controls, and place them under the Visual Studio Common Path or only in the All Controls Group.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Toolbox.Common">  
        <ToolboxItems />  
        <ToolboxItems VSCategory = "Toolbox.All">  
        <ToolboxItems />  
    </File>  
    
  7. Énumérer des contrôles spécifiques et afficher uniquement un ensemble spécifique de ChooseItems sans les en cours dans la boîte à outils.Enumerate specific controls, and show only a specific set in ChooseItems without them being in the toolbox.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Toolbox.ChooseItemsOnly">  
        <ToolboxItems />  
    </File>  
    

Voir aussiSee also

Procédure pas à pas : Créer un kit de développement à l’aide de C++ Walkthrough: Create an SDK using C++
Procédure pas à pas : Créer un kit de développement à l’aide de c# ou Visual Basic Walkthrough: Create an SDK using C# or Visual Basic
Gérer les références dans un projetManage references in a project