Vytvoření sady SDK (Software Development Kit)Create a software development kit

Sada SDK (Software Development Kit) je kolekce rozhraní API, která můžete odkazovat jako na jednu položku v sadě Visual Studio.A software development kit (SDK) is a collection of APIs that you can reference as a single item in Visual Studio. Dialogové okno Správce odkazů obsahuje seznam všech sad SDK, které jsou relevantní pro projekt.The Reference Manager dialog box lists all the SDKs that are relevant to the project. Když přidáte sadu SDK do projektu, rozhraní API jsou k dispozici v sadě Visual Studio.When you add an SDK to a project, the APIs are available in Visual Studio.

Existují dva typy sad SDK:There are two types of SDKs:

  • Sady SDK platforem jsou povinné komponenty pro vývoj aplikací pro platformu.Platform SDKs are mandatory components for developing apps for a platform. Windows 8.1Windows 8.1 Sada SDK je například nutná pro vývoj Windows 8.x StoreWindows 8.x Store aplikací.For example, the Windows 8.1Windows 8.1 SDK is required to develop Windows 8.x StoreWindows 8.x Store apps.

  • Sady SDK rozšíření jsou volitelné komponenty, které šíří platformu, ale nejsou povinné pro vývoj aplikací pro tuto platformu.Extension SDKs are optional components that extend a platform but aren't mandatory for developing apps for that platform.

V následujících částech jsou popsány obecné infrastruktury sady SDK a postup vytvoření sady SDK platformy a sady SDK rozšíření.The following sections describe the general infrastructure of SDKs and how to create a platform SDK and an extension SDK.

Sady SDK platformyPlatform SDKs

Sady SDK platformy se vyžadují pro vývoj aplikací pro platformu.Platform SDKs are required to develop apps for a platform. Windows 8.1Windows 8.1 Sada SDK je například nutná pro vývoj aplikací pro 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.

InstalaceInstallation

Všechny sady SDK platformy se nainstalují na HKLM\Software\Microsoft\Microsoft\sady SDK [TPI] \v [\ TPV]@InstallationFolder = [kořen SDK] .All platform SDKs will be installed at HKLM\Software\Microsoft\Microsoft SDKs\[TPI]\v[TPV]\@InstallationFolder = [SDK root]. Proto se sada SDK nainstaluje na HKLM\Software\Microsoft\Microsoft SDKs\Windows\v8.1. Windows 8.1Windows 8.1Accordingly, the Windows 8.1Windows 8.1 SDK is installed at HKLM\Software\Microsoft\Microsoft SDKs\Windows\v8.1.

RozloženíLayout

Sady SDK platforem mají následující rozložení:Platform SDKs have the following layout:

\[InstallationFolder root]
            SDKManifest.xml
            \References
                  \[config]
                        \[arch]
            \DesignTime
                  \[config]
                        \[arch]
UzelNode PopisDescription
Odkazuje na složkuReferences folder Obsahuje binární soubory, které obsahují rozhraní API, se kterými se dá zakódovat.Contains binaries that contain APIs that can be coded against. Ty můžou zahrnovat soubory Windows metadata (WinMD) nebo sestavení.These could include Windows Metadata (WinMD) files or assemblies.
DesignTime složkaDesignTime folder Obsahuje soubory, které jsou potřeba pouze v době před spuštěním nebo ladění.Contains files that are needed only at pre-run/debugging time. Mezi ně můžou patřit dokumentace XML, knihovny, hlavičky, sady nástrojů pro vytváření binárních souborů v době návrhu, artefakty MSBuild a tak dále.These could include XML docs, libraries, headers, Toolbox design-time binaries, MSBuild artifacts, and so forth

Dokumentace XML by v ideálním případě měla být umístěna do složky \DesignTime , ale dokumenty XML pro reference budou nadále umístěny společně s referenčním souborem v aplikaci 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. Například DOC XML pro referenci\References\[config]\[arch] \sample.dll bude \\References [config]\[arch] \sample.XMLa lokalizovaná verze tohoto dokumentu bude \\References\[config]\[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.
Konfigurační složkaConfiguration folder K dispozici můžou být jenom tři složky: Ladění, maloobchod a CommonConfiguration.There can be only three folders: Debug, Retail and CommonConfiguration. Autoři sady SDK mohou umístit své soubory do CommonConfiguration , pokud by měla být spotřebována stejná sada souborů sady SDK bez ohledu na konfiguraci, kterou bude příjemce sady SDK cílit.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.
Složka architekturyArchitecture folder Může existovat libovolná podporovaná složka architektury .Any supported architecture folder can exist. Visual Studio podporuje následující architektury: x86, x64, ARM a neutrální.Visual Studio supports the following architectures: x86, x64, ARM, and neutral. Poznámka: Systém Win32 mapuje na x86 a AnyCPU se mapuje na neutrální.Note: Win32 maps to x86, and AnyCPU maps to neutral.

Nástroj MSBuild hledá v sadách SDK platformy pouze \CommonConfiguration\neutral .MSBuild looks only under \CommonConfiguration\neutral for Platform SDKs.
SDKManifest.xmlSDKManifest.xml Tento soubor popisuje, jak by měla sada Visual Studio využívat sadu SDK.This file describes how Visual Studio should consume the SDK. Podívejte se na manifest sady SDK Windows 8.1Windows 8.1pro: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 Hodnota, kterou Prohlížeč objektů zobrazuje v seznamu procházení.DisplayName: The value that the Object Browser displays in the Browse list.

PlatformIdentity: Existence tohoto atributu oznamuje sadě Visual Studio a MSBuild, že sada SDK je Platform SDK a že odkazy z nich přidané by neměly být kopírovány lokálně.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 Tento atribut je používán sadou Visual Studio k zajištění toho, aby sada SDK mohla využívat pouze projekty, které cílí na stejné architektury, jak je uvedeno v hodnotě tohoto atributu.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: Tento atribut používá aplikace Visual Studio ke zpracování pouze sad SDK, které na něj vztahují.MinVSVersion: This attribute is used by Visual Studio to consume only the SDKs that apply to it.

Odkaz Tento atribut musí být zadán pouze pro odkazy obsahující ovládací prvky.Reference: This attribute must to be specified for only those references that contain controls. Informace o tom, jak určit, zda odkaz obsahuje ovládací prvky, naleznete níže.For information about how to specify whether a reference contains controls, see below.

Sady SDK rozšířeníExtension SDKs

Následující části popisují, co je třeba udělat k nasazení sady SDK rozšíření.The following sections describe what you need to do to deploy an extension SDK.

InstalaceInstallation

Sady SDK rozšíření je možné nainstalovat pro konkrétního uživatele nebo pro všechny uživatele bez zadání klíče registru.Extension SDKs can be installed for a specific user or for all users without specifying a registry key. Chcete-li nainstalovat sadu SDK pro všechny uživatele, použijte následující cestu:To install an SDK for all users, use the following path:

% Program Files%\Microsoft SDK<cílové platformy>\v < číslo>verze platformy \ExtensionSDKs%Program Files%\Microsoft SDKs<target platform>\v<platform version number>\ExtensionSDKs

V případě instalace specifické pro uživatele použijte následující cestu:For a user-specific installation, use the following path:

%USERPROFILE%\AppData\Local\Microsoft SDK<cílové platformy>\v < číslo>verze platformy \ExtensionSDKs%USERPROFILE%\AppData\Local\Microsoft SDKs<target platform>\v<platform version number>\ExtensionSDKs

Pokud chcete použít jiné umístění, musíte udělat jednu z následujících dvou věcí:If you want to use a different location, you must do one of two things:

  1. Zadejte ho do klíče registru:Specify it in a registry key:

    HKLM\Software\Microsoft\Microsoft SDK<cílová platforma > \v < číslo>verze platformy \ExtensionSDKs<SDKName ><SDKVersion > HKLM\Software\Microsoft\Microsoft SDKs<target platform>\v<platform version number>\ExtensionSDKs<SDKName><SDKVersion>\

    a přidejte podklíč (výchozí), který má hodnotu <path to SDK><SDKName><SDKVersion>.and add a (Default) subkey that has a value of <path to SDK><SDKName><SDKVersion>.

  2. Přidejte do souboru projektu SDKReferenceDirectoryRoot vlastnost MSBuild.Add the MSBuild property SDKReferenceDirectoryRoot to your project file. Hodnota této vlastnosti je seznam adresářů oddělených středníky, ve kterých se nacházejí rozšiřující sady SDK, na které chcete odkazovat.The value of this property is a semicolon delimited list of directories in which the Extension SDKs you want to reference reside.

Rozložení instalaceInstallation layout

Sady SDK rozšíření mají následující rozložení instalace: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>: název a verze sady SDK rozšíření jsou odvozeny z odpovídajících názvů složek v cestě k kořenu sady SDK.\<SDKName>\<SDKVersion>: the name and version of the extension SDK is derived from the corresponding folder names in the path to the SDK root. Nástroj MSBuild používá tuto identitu k nalezení sady SDK na disku a aplikace Visual Studio zobrazí tuto identitu v okně vlastnosti a v dialogovém okně Správce odkazů .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. Složka odkazů : binární soubory, které obsahují rozhraní API.References folder: the binaries that contain the APIs. Můžou to být soubory nebo sestavení Windows metadata (WinMD).These could be Windows Metadata (WinMD) files or assemblies.

  3. Složka Redist: soubory, které jsou potřebné pro modul runtime/ladění a měly by být zabaleny jako součást aplikace uživatele.Redist folder: the files that are needed for runtime/debugging and should get packaged as part of the user's application. Všechny binární soubory by se měly umístit pod\\redist <>\>config < a binární názvy by měly mít následující formát, aby se zajistila jedinečnost: ] <společnost >. <> produktu. <> účelu. <>rozšíření. Například * Microsoft. cpp. Build. dll.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>. For example, *Microsoft.Cpp.Build.dll. Všechny soubory s názvy, které se můžou kolidovat s názvy souborů z jiných sad SDK (například JavaScript, CSS, pri, XAML, PNG a jpg), by se měly umístit pod \redist\< config>\< arch>.< sdknamesvýjimkou> souborů, které jsou přidruženy k ovládacím prvkům jazyka XAML.* \ Tyto soubory by měly být umístěny pod *\\redist <>config\<>\< součásti>\.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. These files should be placed underneath *\redist\<config>\<arch>\<componentname>\.

  4. DesignTime složka: soubory, které jsou potřeba pouze v době před spuštěním a ladění, by neměly být zabaleny jako součást aplikace uživatele.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. Může se jednat o dokumentaci XML, knihovny, hlavičky, sady nástrojů pro vytváření binárních souborů v době návrhu, artefakty MSBuild a tak dále.These could be XML docs, libraries, headers, toolbox design-time binaries, MSBuild artifacts, and so forth. Všechny sady SDK, které jsou určené pro spotřebu v nativním projektu, musí mít soubor SDKName. props .Any SDK that is intended for consumption by a native project must have an SDKName.props file. Následující příklad ukazuje ukázku tohoto typu souboru.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>
    
    

    Referenční dokumenty XML jsou umístěny společně s referenčním souborem.XML reference documents are placed alongside the reference file. Například referenční dokument XML pro sestavení \References\<>>config\< \sample.dll je \References\< config> \<\sample.XMLalokalizovanáverzetohotodokumentuje\References<config<<locale> \>\>\>\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. Složka Konfigurace : tři podsložky: Ladění, maloobchoda CommonConfiguration.Configuration folder: three subfolders: Debug, Retail, and CommonConfiguration. Autoři sady SDK mohou umístit své soubory do CommonConfiguration , pokud by se měla používat stejná sada souborů sady SDK, a to bez ohledu na konfiguraci, kterou uživatel SDK zacílí.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. Složka architektury : podporovány jsou následující architektury: x86, x64, ARM, neutrální.Architecture folder: the following architectures are supported: x86, x64, ARM, neutral. Systém Win32 mapuje na x86 a AnyCPU se mapuje na neutrální.Win32 maps to x86, and AnyCPU maps to neutral.

SDKManifest.xmlSDKManifest.xml

Soubor SDKManifest. XML popisuje, jak by měla sada Visual Studio využívat sadu SDK.The SDKManifest.xml file describes how Visual Studio should consume the SDK. Následuje příklad: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 = "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ásledující seznam obsahuje prvky souboru:The following list gives the elements of the file:

  1. DisplayName: hodnota, která se zobrazí ve Správci odkazů, Průzkumník řešení, Prohlížeč objektů a dalších místech v uživatelském rozhraní sady 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: Celkový název produktu SDK.ProductFamilyName: The overall SDK product name. Například knihovna Windows pro jazyk JavaScript (WinJS)Windows Library for JavaScript (WinJS) sada SDK má název "Microsoft. WinJS. 1.0" a "Microsoft. WinJS. 2.0", které patří do stejné rodiny produktů sady SDK "Microsoft. WinJS".For example, the knihovna Windows pro jazyk 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". Tento atribut umožňuje aplikaci Visual Studio a MSBuild vytvořit toto připojení.This attribute allows Visual Studio and MSBuild to make that connection. Pokud tento atribut neexistuje, použije se název sady SDK jako název řady produktů.If this attribute doesn't exist, the SDK Name is used as the product family name.

  3. FrameworkIdentity: Určuje závislost pro jednu nebo více knihoven součástí Windows.FrameworkIdentity: Specifies a dependency on one or more Windows component libraries. Hodnota tohoto atributu je vložena do manifestu využívajícího aplikaci.The value of this attribute is put into the consuming app's manifest. Tento atribut se vztahuje pouze na knihovny součástí systému Windows.This attribute is applicable only to Windows component libraries.

  4. TargetFramework Určuje sady SDK, které jsou k dispozici ve Správci odkazů a sadě nástrojů.TargetFramework: Specifies the SDKs that are available in the Reference Manager and the toolbox. Jedná se o středníkem oddělený seznam monikerů cílového rozhraní, například ".NET Framework, verze = v 2.0; .NET Framework, verze = v 4.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". Pokud jsou zadány různé verze stejného cílového rozhraní, Správce odkazů používá nejnižší určenou verzi pro účely filtrování.If several versions of the same target framework are specified, the Reference Manager uses the lowest specified version for filtering purposes. Například pokud je zadána možnost ".NET Framework, verze = v 2.0; .NET Framework, verze = v 4.5.1", Správce odkazů použije ".NET Framework, Version = v 2.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". Pokud je zadán konkrétní profil cílového rozhraní, bude správce odkazů pro účely filtrování používat pouze tento profil.If a specific target framework profile is specified, only that profile will be used by the Reference Manager for filtering purposes. Pokud je například zadáno "Silverlight, Version = v 4.0, profil = WindowsPhone", Správce odkazů bude filtrovat pouze v profilu Windows Phone; projekt, který cílí na úplné rozhraní Silverlight 4,0, nevidí sadu SDK ve Správci odkazů.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: Minimální verze sady Visual Studio.MinVSVersion: The minimum Visual Studio version.

  6. MaxPlatformVerson: Maximální verze cílové platformy by se měla použít k určení verzí platformy, na kterých vaše sada SDK rozšíření nebude fungovat.MaxPlatformVerson: The maximum target platform version should be used to specify the platform versions on which your Extension SDK will not work. Například balíček Microsoft Visual C++ runtime Package v 11.0 by měl odkazovat pouze na projekty systému Windows 8.For example, the Microsoft Visual C++ Runtime Package v11.0 should be referenced only by Windows 8 projects. Proto je MaxPlatformVersion projektu Windows 8 8,0.Thus, the Windows 8 project's MaxPlatformVersion is 8.0. To znamená, že správce odkazů vyfiltruje balíček C++ modulu Microsoft Visual runtime pro Windows 8.1 projekt a nástroj MSBuild vyvolá chybu, když Windows 8.1Windows 8.1 na něj projekt odkazuje.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. Poznámka: Tento element je podporován od začátku Visual Studio 2013Visual Studio 2013.Note: this element is supported starting in Visual Studio 2013Visual Studio 2013.

  7. AppliesTo Určuje sady SDK, které jsou k dispozici ve Správci odkazů zadáním příslušných typů projektů aplikace Visual Studio.AppliesTo: Specifies the SDKs that are available in the Reference Manager by specifying applicable Visual Studio project types. Rozpoznávají se devět hodnot: WindowsAppContainer, VisualC, VB, CSharp, WindowsXAML, JavaScript, Managed a Native.Nine values are recognized: WindowsAppContainer, VisualC, VB, CSharp, WindowsXAML, JavaScript, Managed, and Native. Autor sady SDK může použít a ("+"), nebo ("|"), NOT ("!"). operátory pro určení přesně rozsahu typů projektu, které platí pro sadu SDK.The SDK author can use and ("+'), or ("|"), not ("!") operators to specify exactly the scope of project types that apply to the SDK.

    WindowsAppContainer identifikuje projekty pro Windows 8.x StoreWindows 8.x Store aplikace.WindowsAppContainer identifies projects for Windows 8.x StoreWindows 8.x Store apps.

  8. SupportPrefer32Bit: Podporované hodnoty jsou "true" a "false".SupportPrefer32Bit: Supported values are "True" and "False". Výchozí hodnota je "true".The default is "True". Pokud je hodnota nastavena na false, nástroj MSBuild vrátí chybu pro Windows 8.x StoreWindows 8.x Store projekty (nebo upozornění pro desktopové projekty), pokud je projekt, který odkazuje na sadu SDK, Prefer32Bit povolen.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. Další informace o Prefer32Bit naleznete v tématu Stránka sestavení, Návrhář projektu (C#) nebo Stránka Kompilovat, Návrhář projektu (Visual Basic).For more information about Prefer32Bit, see Build page, Project Designer (C#) or Compile page, Project Designer (Visual Basic).

  9. SupportedArchitectures: Seznam architektur, které podporuje sada SDK, oddělený středníky.SupportedArchitectures: A semicolon delimited list of architectures that the SDK supports. Nástroj MSBuild zobrazí upozornění, pokud cílová architektura sady SDK v rámci náročného projektu není podporována.MSBuild displays a warning if the targeted SDK architecture in the consuming project isn't supported. Pokud tento atribut není zadán, MSBuild nikdy nezobrazí tento typ upozornění.If this attribute isn't specified, MSBuild never displays this type of warning.

  10. SupportsMultipleVersions: Pokud je tento atribut nastaven na hodnotu Error nebo Warning, MSBuild indikuje, že stejný projekt nemůže odkazovat na více verzí stejné řady SDK.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. Pokud tento atribut neexistuje nebo je nastaven na hodnotu Allow, nástroj MSBuild nezobrazí tento typ chyby nebo upozornění.If this attribute doesn't exist or is set to Allow, MSBuild doesn't display this type of error or warning.

  11. AppX Určuje cestu k balíčkům aplikací pro knihovnu součástí Windows na disku.AppX: Specifies the path to the app packages for the Windows component library on the disk. Tato hodnota je předána registrační komponentě knihovny součástí systému Windows během místního ladění.This value is passed to the registration component of the Windows component library during local debugging. Konvence pojmenování pro název souboru je <> společnosti< . > Produktu. <> Architektury. <> Konfigurace. Verze<>. appx.The naming convention for the file name is <Company>.<Product>.<Architecture>.<Configuration>.<Version>.appx. Konfigurace a architektura jsou nepovinné v názvu atributu a v případě hodnoty atributu, pokud se nevztahují na knihovnu součástí Windows.Configuration and Architecture are optional in the attribute name and the attribute value if they don't apply to the Windows component library. Tato hodnota se vztahuje pouze na knihovny součástí systému Windows.This value is applicable only to Windows component libraries.

  12. CopyRedistToSubDirectory: Určuje, kam se mají soubory ve složce \redist kopírovat relativně k kořenovému adresáři balíčku aplikace (to znamená umístění balíčku zvolenému v průvodci vytvořením balíčku aplikace ) a kořenovému adresáři rozložení modulu 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. Výchozím umístěním je kořen balíčku aplikace a rozložení F5 .The default location is the root of the app package and F5 layout.

  13. DependsOn Seznam identit sady SDK, které definují sady SDK, na kterých je tato sada SDK závislá.DependsOn: A list of SDK identities that define the SDKs on which this SDK depends. Tento atribut se zobrazí v podokně podrobností Správce odkazů.This attribute appears in the details pane of the Reference Manager.

  14. MoreInfo: Adresa URL webové stránky, která poskytuje informace o nápovědě a dalších informacích.MoreInfo: The URL to the web page that provides help and more information. Tato hodnota se používá na odkazu Další informace v pravém podokně Správce odkazů.This value is used in the More Information link in the right pane of the Reference Manager.

  15. Typ registrace: Určuje registraci WinMD v manifestu aplikace a je vyžadován pro nativního WinMD, který má knihovnu DLL implementace protějšku.Registration Type: Specifies the WinMD registration in the app manifest and is required for native WinMD, which has a counterpart implementation DLL.

  16. Odkaz na soubor: Určené pouze pro odkazy, které obsahují ovládací prvky nebo jsou nativní soubory WinMD.File Reference: Specified for only those references that contain controls or are native WinMDs. Informace o tom, jak určit, zda odkaz obsahuje ovládací prvky, naleznete v tématu určení umístění položek sady nástrojů níže.For information about how to specify whether a reference contains controls, see Specify the location of toolbox items below.

Zadejte umístění položek sady nástrojů.Specify the location of toolbox items

Element ToolBoxItems schématu SDKManifest. XML určuje kategorii a umístění položek sady nástrojů v sadách SDK platforem a rozšíření.The ToolBoxItems element of the SDKManifest.xml schema specifies the category and location of toolbox items in both platform and extension SDKs. Následující příklady ukazují, jak zadat různá umístění.The following examples show how to specify different locations. Tato možnost platí pro odkazy WinMD nebo DLL.This is applicable to either WinMD or DLL references.

  1. Umístěte ovládací prvky do výchozí kategorie sady nástrojů.Place controls in the toolbox default category.

    <File Reference = "sample.winmd">
        <ToolboxItems VSCategory = "Toolbox.Default"/>
    </File>
    
  2. Umístěte ovládací prvky pod název konkrétní kategorie.Place controls under a particular category name.

    <File Reference = "sample.winmd">
        <ToolboxItems VSCategory= "MyCategoryName"/>
    </File>
    
  3. Umístěte ovládací prvky pod konkrétní názvy kategorií.Place controls under particular category names.

    <File Reference = "sample.winmd">
        <ToolboxItems VSCategory = "Graph">
        <ToolboxItems/>
        <ToolboxItems VSCategory = "Data">
        <ToolboxItems />
    </File>
    
  4. Umístěte ovládací prvky pod názvy různých kategorií v Blendu a v aplikaci 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. Zobrazení výčtu konkrétních ovládacích prvků v Blendu a v aplikaci Visual Studio jinak.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. Vypsat konkrétní ovládací prvky a umístit je do společné cesty sady Visual Studio nebo pouze do skupiny všechny ovládací prvky.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. Umožňuje vytvořit výčet konkrétních ovládacích prvků a v ChooseItems zobrazovat pouze konkrétní sadu, aniž by byla v sadě nástrojů.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>
    

Viz také:See also