Création d’un Kit de développement logiciel (SDK)Creating a Software Development Kit

Un kit de développement logiciel (SDK) est un ensemble d’API que vous pouvez référencer comme 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 de développement à 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 des 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 Kit de développement logiciel 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 de développement logiciel de plateforme 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 de développement Platform SDKPlatform SDKs

  • SDK d’extensionExtension SDKs

Kits de développement Platform SDKPlatform 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 Kit de développement logiciel est requis pour développer des applications 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 tous les kits de développement logiciel sera installé à des kits de développement logiciel HKLM\Software\Microsoft\Microsoft\[TPI] \v [TPV]\ @InstallationFolder = [racine du Kit de développement logiciel].All platform SDKs will be installed at HKLM\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
Dossier référencesReferences folder Contient les fichiers binaires qui contiennent des API qui peut être codées sur.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.
Dossier DesignTimeDesignTime folder Contient des fichiers qui sont nécessaires uniquement au moment de pre-exécution/débogage.Contains files that are needed only at pre-run/debugging time. Il peut inclure les documents XML, bibliothèques, en-têtes, fichiers binaires de boîte à outils au moment du design, les artefacts de MSBuild et ainsi de suiteThese could include XML docs, libraries, headers, Toolbox design-time binaries, MSBuild artifacts, and so forth

Les documents XML, dans l’idéal, se trouveraient dans le dossier \DesignTime, mais les documents XML pour les références continuent à ê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 de \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.
Dossier de configurationConfiguration folder Il peut y avoir uniquement trois dossiers : debug, vente au détail 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 du Kit de développement logiciel doit être consommé, 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.
Dossier de l’architectureArchitecture folder N’importe quel dossier de l’architecture prise en charge 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 est 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>

Nom d’affichage : 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 Kit de développement est une plateforme du Kit de développement logiciel 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 que seuls les projets qui ciblent les mêmes infrastructures comme spécifié dans la valeur de cet attribut peut utiliser 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 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 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:

%Program Files%\Microsoft SDKs\<target platform>\v<platform version number>\ExtensionSDKs

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

%USERPROFILE%\AppData\Local\Microsoft SDKs\<target platform>\v<platform version number>\ExtensionSDKs

Si vous souhaitez utiliser un autre emplacement, vous devez effectuer une des deux choses :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:

    HKLM\Software\Microsoft\Microsoft SDKs\<target platform>\v<platform version number>\ExtensionSDKs\<SDKName>\<SDKVersion>\

    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 de deux-points délimités de semi de répertoires dans lesquels résident le SDK d’Extension que vous souhaitez référencer.The value of this property is a semi colon 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. \< nom du SDK>\< SDKVersion>: le nom et la version de l’extension du Kit de développement logiciel est dérivé les 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. Le dossier Références : 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. Dossier Redist : les fichiers qui sont nécessaires pour l’exécution et de déboguer 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 >. <objectif >. <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 dont le nom peut 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> \< nom du SDK>\ sauf les fichiers qui sont associées à 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. Le dossier DesignTime : les fichiers qui sont nécessaires à la seule pre-exécution/débogage temps et ne doit pas être insérés dans le cadre de l’application.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 des documents XML, bibliothèques, en-têtes, 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çu pour la consommation par un projet natif doit avoir un nom du SDKfichier .props.Any SDK that is intended for consumption by a native project must have an SDKName.props file. Le code suivant illustre 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. Dossier de configuration : trois sous-dossiers : débogage, commerciale 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 du Kit de développement logiciel doit être consommé, quelle que soit la configuration ciblée par le consommateur du Kit de développement logiciel.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. Dossier de l’architecture : 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 fournit les éléments du fichier.The following list gives the elements of the file.

  1. Nom d’affichage : la valeur qui apparaît dans le Gestionnaire de références, l’Explorateur de solutions, Explorateur d’objets, ou d’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 SDK, « 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 de kit de développement logiciel 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 une ou plusieurs bibliothèques de composants 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 de développement logiciel 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 = version 2.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 de la même infrastructure cible sont spécifiées, le Gestionnaire de références utilise la version la plus ancienne 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 = version 2.0 ; .NET Framework, version = v4.5.1 » est spécifié, Gestionnaire de références utilise « .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 du framework cible spécifique est spécifié, seulement 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 = version 4.0, profil = WindowsPhone » est spécifié, des filtres de gestionnaire de références sur le profil de Windows Phone uniquement ; un projet ciblant 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 : Visual Studio version minimale.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 doit être référencée 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, les 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 de 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 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 depuis Visual Studio 2013.Note: this element is supported starting in Visual Studio 2013.

  7. AppliesTo : Spécifie les kits de développement logiciel 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, managé 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 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 Kit de développement a 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, Project Designer (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 : un point-virgule des architectures qui prend en charge par le Kit de développement.SupportedArchitectures: a semi-colon delimited list of architectures that the SDK supports. MSBuild affiche un avertissement si l’architecture du Kit de développement logiciel 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 faire référence à 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 a la valeur 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 pour les packages d’application de la bibliothèque des composants 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 de l’inscription de la bibliothèque des composants 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 > .aspx.The naming convention for the file name is <Company>.<Product>.<Architecture>.<Configuration>.<Version>.appx. Architecture et configuration sont facultatives dans le nom d’attribut et la valeur d’attribut si elles ne s’appliquent à la bibliothèque des composants 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 la copie des fichiers dans le dossier \redist relatif à la racine de package d’application (autrement dit, le emplacement du Package choisi dans l’Assistant Création d’un Package App) et 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 de la mise en page F5.The default location is the root of the app package and F5 layout.

  13. DependsOn : Une liste des 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 à la page web qui fournit plus d’informations et une aide.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 le WinMD natif, ce qui a une implémentation de l’homologue 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 des fichiers Winmd natif.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 en spécifiant l’emplacement des éléments de boîte à outils ci-dessous.For information about how to specify whether a reference contains controls, see Specifying the Location of Toolbox Items below.

En spécifiant l’emplacement des éléments de boîte à outilsSpecifying the Location of Toolbox Items

L’élément ToolBoxItems du schéma SDKManifest.xml spécifie la catégorie et l’emplacement des éléments de boîte à outils de plateforme et de kits SDK 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. Placez 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 des noms de catégorie particulier.Place controls under particular category names.

    <File Reference = "sample.winmd">  
        <ToolboxItems VSCategory = "Graph">  
        <ToolboxItems/>  
        <ToolboxItems VSCategory = "Data">  
        <ToolboxItems />  
    </File>  
    
  4. Placez les contrôles sous les noms de catégories différentes 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éation d’un kit de développement à l’aide de C++ Walkthrough: Creating an SDK using C++
Procédure pas à pas : Création d’un kit de développement à l’aide de c# ou Visual Basic Walkthrough: Creating an SDK using C# or Visual Basic
Gestion des références dans un projetManaging references in a project