android ios vs2017,使用 Visual Studio 2017 或 2019 为 Xamarin 创建 NuGet 包（适用于 iOS、Android 和 Windows） | Mi...

最新推荐文章于 2022-03-15 20:54:11 发布

weixin_39902608

最新推荐文章于 2022-03-15 20:54:11 发布

阅读量316

点赞数

文章标签： android ios vs2017

使用 Visual Studio 2017 或 2019 为 Xamarin 创建包

11/05/2019

本文内容

Xamarin 包包含在 iOS、Android 和 Windows 上使用本机 API 的代码，具体取决于运行时操作系统。虽然这很简单，但最好让开发人员通过通用的 API 外围应用从 PCL 或 .NET Standard 库中使用包。

在本演练中，将使用 Visual Studio 2017 或 2019 创建可在 iOS、Android 和 Windows 的移动项目中使用的跨平台 NuGet 包。

必备条件

在通用 Windows 平台 (UWP) 和 Xamarin 中使用 Visual Studio 2017 或 2019。可以从 visualstudio.com 免费安装 Community 版；当然，也可以使用 Professional 和 Enterprise 版。若要包含 UWP 和 Xamarin 工具，请选择自定义安装并选中相应的选项。

NuGet CLI。从 nuget.org/downloads 下载 nuget.exe 的最新版本，将其保存到选择的位置。然后将该位置添加到 PATH 环境变量(如果尚未添加)。

备注

nuget.exe 是 CLI 工具本身，不是安装程序，因此一定要保存从浏览器下载的文件，而非运行。

创建项目结构和抽象代码

下载并运行适用于 Visual Studio 的跨平台 .NET Standard 插件模板扩展。使用这些模板可轻松创建本演练所需的项目结构。

在 Visual Studio 2017 中，选择“文件”>“新建”>“项目”，搜索 Plugin，选择“跨平台 .NET Standard 库插件”模板，将名称更改为“LoggingLibrary”，然后单击“确定”。

在 Visual Studio 2019 中，选择“文件”>“新建”>“项目”，搜索 Plugin，选择“跨平台 .NET Standard 库插件”模板，然后单击“下一步”。

将名称更改为 LoggingLibrary，然后单击“创建”。

生成的解决方案包含两个共享项目，以及各种平台特定的项目：

ILoggingLibrary 项目，该项目包含在 ILoggingLibrary.shared.cs 文件中，用于定义组件的公共接口(API 外围应用)。你将在此文件中定义库的接口。

另一个共享项目包含 CrossLoggingLibrary.shared.cs 中的代码，这些代码将在运行时定位抽象接口的平台特定实现。通常不需要修改此文件。

每个平台特定的项目(如 LoggingLibrary.android.cs)在其各自的 LoggingLibraryImplementation.cs (VS 2017) 或 LoggingLibrary..cs (VS 2019) 文件中都包含该接口的本机实现。你将在此文件中生成库的代码。

默认情况下，ILoggingLibrary 项目的 ILoggingLibrary.shared.cs 文件包含接口定义，但不包含方法。为进行本演练，请按如下所示添加 Log 方法：

using System;

using System.Collections.Generic;

using System.Text;

namespace Plugin.LoggingLibrary

{

///

/// Interface for LoggingLibrary

///

public interface ILoggingLibrary

{

///

/// Log a message

///

void Log(string text);

}

编写平台特定的代码

若要实现 ILoggingLibrary 接口及其方法的平台特定实现，请执行以下操作：

打开每个平台项目的 LoggingLibraryImplementation.cs (VS 2017) 或 LoggingLibrary..cs (VS 2019) 文件并添加必要的代码。例如(使用 Android 平台项目)：

using System;

using System.Collections.Generic;

using System.Text;

namespace Plugin.LoggingLibrary

{

///

/// Implementation for Feature

///

public class LoggingLibraryImplementation : ILoggingLibrary

{

///

/// Log a message

///

public void Log(string text)

{

throw new NotImplementedException("Called Log on Android");

}

在想要支持的每个平台的项目中重复此实现。

右键单击解决方案，选择“生成解决方案”，检查工作并生成接下来将要打包的项目。如果遇到关于缺少引用的错误，请右键单击解决方案，选择“还原 NuGet 包”，安装依赖项并重新生成。

备注

如果使用的是 Visual Studio 2019，则在选择“还原 NuGet 包”并尝试重新生成之前，需要将 MSBuild.Sdk.Extras 的版本更改为 LoggingLibrary.csproj 中的 2.0.54。只能通过以下方式访问此文件：首先右键单击该项目(在解决方案下方)并选择 Unload Project，然后右键单击卸载的项目并选择 Edit LoggingLibrary.csproj。

备注

若要为 iOS 生成，需要一台连接到 Visual Studio 的联网 Mac，如 Introduction to Xamarin.iOS for Visual Studio(Xamarin.iOS for Visual Studio 简介)中所述。如果没有可用的 Mac，请清除配置管理器中的 iOS 项目(上面的步骤 3)。

创建并更新 .nuspec 文件

打开命令提示符，导航到 .sln 文件下一级的 LoggingLibrary 文件夹，然后运行 NuGet spec 命令，创建初始 Package.nuspec 文件：

nuget spec

将该文件重命名为 LoggingLibrary.nuspec 并在编辑器中打开。

将文件更新为与以下内容匹配，并将 YOUR_NAME 替换为适当的值。具体而言，值在 nuget.org 中必须是唯一的(请参阅创建包中所述的命名约定)。另请注意，还必须更新创建者和说明标记，否则在打包步骤中会出现错误。

LoggingLibrary.YOUR_NAME

1.0.0

LoggingLibrary

YOUR_NAME

false

Awesome application logging utility

First release