如何打包针对通用Windows平台的.NET库？ [英] How to package a .NET library targeting the Universal Windows Platform?

问题描述

如何以现代通用方式打包通用Windows平台库以通过NuGet发布？假设我有一个用C＃编写的AnyCPU程序集，该程序集导出一些代码和XAML用户控件。

How do I package a Universal Windows Platform library in a modern general-purpose way for publishing via NuGet? Let's assume I have a single AnyCPU assembly written in C# that exports some code and XAML user controls.

这是一系列问题和解答该文档记录了我对现代NuGet软件包创作这一主题的发现，尤其着重于NuGet 3引入的更改。您可能也对一些相关问题感兴趣：

This is a series of questions and answers that document my findings on the topic of modern NuGet package authoring, focusing especially on the changes introduced with NuGet 3. You may also be interested in some related questions:

• 如何打包.NET Framework库？


• 如何打包面向.NET Core的便携式.NET库？


• 如何打包面向.NET Framework和Universal Windows Platform的.NET库，并包括platform-spe


• 如何打包面向通用Windows平台的多架构.NET库？


• 如何打包针对.NET库的通用Windows平台并依赖Visual Studio扩展SDK？

• How to package a .NET Framework library?
• How to package a portable .NET library targeting .NET Core?
• How to package a .NET library targeting .NET Framework and Universal Windows Platform and include platform-specific functionality?
• How to package a multi-architecture .NET library that targets the Universal Windows Platform?
• How to package a .NET library that targets the Universal Windows Platform and depends on Visual Studio extension SDKs?

推荐答案

此答案建立在用于打包针对.NET Framework 。首先阅读链接的答案，以更好地理解以下内容。

This answer builds upon the principles used to package libraries targeting the .NET Framework. Read the linked answer first to better understand the following.

首先，您必须在项目构建设置中选中 Generate library layout复选框。否则，将无法使用库导出的XAML用户控件。确保将此设置应用于所有构建配置和体系结构。

First you must check the "Generate library layout" checkbox in the project build settings. Without this, it will not be possible to use the XAML user controls exported by your library. Make sure to apply this setting for all build configurations and architectures.

除了基本的3项资产（请参见上面的答案），您还需要打包以下内容构建输出目录中的其他资产：

In addition to the basic 3 assets (see answer linked above), you will also need to package the following additional assets from your build output directory:

• MyUwpLibrary.pri


• MyUwpLibrary子目录

这些额外的资源需要利用程序集导出的XAML用户控件。即使您尚未从库中导出任何XAML，也要始终包括这些资产-您可能有一天会这样做，以后记住这一点将非常棘手！

These extra resources are required to make use of XAML user controls exported by your assembly. Always include these assets, even if you do not yet export any XAML from your library - you might do it one day and this will be tricky to remember later on!

发布UWP库，您需要创建具有以下结构的NuGet包：

To publish the UWP library, you need to create a NuGet package with the following structure:

\---lib
    \---uap10.0
        |   MyUwpLibrary.dll
        |   MyUwpLibrary.pdb
        |   MyUwpLibrary.pri
        |   MyUwpLibrary.xml
        |
        \---MyUwpLibrary
                HelloWorld.xaml
                MyUwpLibrary.xr.xml

如果您熟悉.NET Framework库发布，则应该看起来非常熟悉和直接。您可以为您的nuspec文件使用以下模板：

If you are familiar with .NET Framework library publishing, this should look quite familiar and straightforward. You can use the following template for your nuspec file:

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
    <metadata minClientVersion="3.2">
        <id>Example.MyUwpLibrary</id>
        <version>1.0.0</version>
        <authors>Firstname Lastname</authors>
        <description>Example of a UWP library that exports a user control.</description>
        <dependencies>
            <dependency id="Newtonsoft.Json" version="8.0.1" />
        </dependencies>
    </metadata>
    <files>
        <!-- The double wildcard will also grab all the resource files and the resource subdirectory. -->
        <file src="..\bin\Release\MyUwpLibrary**" target="lib\uap10.0" />
    </files>
</package>

就是这样！在创建NuGet软件包之前，请记住使用Release配置来构建您的解决方案。有关更多详细信息，请参见上面链接的有关打包.NET Framework库的答案。

That's it, really! Remember to build your solution using the Release configuration before creating the NuGet package. For more details, refer to the answer about packaging a .NET Framework library, linked above.

示例库和相关打包文件为在GitHub上可用。与此答案对应的解决方案是SimpleUwpLibrary。

A sample library and the relevant packaging files are available on GitHub. The solution corresponding to this answer is SimpleUwpLibrary.

这篇关于如何打包针对通用Windows平台的.NET库？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！