大网数据广告活动
.NET 与 C# 开发

使用可移植类库的跨平台开发

· 52CE 我爱测

在 Visual Studio 中的可移植类库项目类型可帮助你快速轻松地构建跨平台应用和 Microsoft 平台的库。

在 Visual Studio 中的可移植类库项目类型可帮助你快速轻松地构建跨平台应用和 Microsoft 平台的库。

Important: 因为可移植类库项目面向的.NET 实现仅非常特定的专项,我们强烈建议不要在新的应用程序开发中使用它们。 推荐的替代是面向所有支持特定版本的.NET Standard 的.NET 实现的.NET Standard 库。 有关详细信息,请参阅 .NET Standard。

可移植类库可以帮助你减少开发和测试代码的时间和成本。 使用此项目类型来编写和生成可移植.NET Framework 程序集,然后从面向.NET Framework、 iOS 或 mac。 如多个平台的应用中引用这些程序集

即使是在 Visual Studio 中创建可移植类库项目并开始开发它之后,你仍然可以更改目标平台。 Visual Studio 将编译成库与新的程序集,可帮助您找到您需要在代码中进行的更改。

创建可移植类库项目

若要创建可移植类库,请使用 Visual Studio 中提供的模板。 创建新的项目 (文件 > 新建项目),然后在新建项目对话框框中,选择您的编程语言 (Visual C# 或 Visual Basic)。 然后,选择类库 (旧版可移植) 模板。 输入你的项目的名称,然后选择确定。

添加可移植类库对话框随即出现。 选择两个或多个目标,然后选择确定。

在 Visual Studio 中添加可移植库目标

更改目标

在创建时或之后开始开发,可以更改目标平台的可移植类库项目。 如果你想要在创建你的项目后更改目标解决方案资源管理器,打开 (不是解决方案),你可移植类库项目的快捷菜单,然后选择属性. 在项目属性页上,库选项卡将显示你的项目当前针对的平台。

在 Visual Studio 中的可移植类库的项目属性

若要添加或删除的目标,请选择更改按钮,然后选择和清除相应的复选框。

在你更改目标时,供你在开发项目时使用的 API 也将发生更改以匹配你的选择。 Visual Studio 报告因目标更改而可能导致的错误和警告。

如果您想要评估可移植性的程序集之前在 Visual Studio 中进行更改,可以使用.NET 可移植性分析器。

支持的类型和成员

可移植类库项目中可用的类型和成员受若干兼容性因素的约束:

  • 它们必须在所选各目标之间共享。

  • 它们必须在这些目标上具有类似的行为方式。

  • 它们不能是要弃用的候选项。

  • 它们必须在可移植环境中有意义,特别是在支持成员不可移植时。

如果一个成员在可移植类库和所选的目标中受支持,它将会你的 IntelliSense 项目中出现。 但是,请记住某一 API 可能在可移植类库中受支持,但你是否可以使用该 API ​​取决于你选择的目标。

可移植类库中的 API 差异

为了使可移植类库程序集在所有支持的平台中都兼容,可移植类库中对部分成员进行了轻微更改。

使用可移植类库

构建可移植类库项目后,只需从其他项目中引用它即可。 可以引用该项目或包含你要访问的类的特定程序集。

若要运行引用可移植类库程序集的应用,必须在计算机上安装所需版本(或更高版本)的目标平台。 Visual Studio 包含所有必需的框架,因此你无需进一步修改即可在用来开发应用的计算机上运行该应用。

部署通用 Windows 应用

创建通用 Windows 应用时引用可移植类库程序集、 部署应用程序所需的一切尽在应用包和再执行其他步骤所需。

部署.NET Framework 应用程序

部署引用可移植类库程序集的 .NET Framework 应用时,你必须指定一个对 .NET Framework 正确版本的依赖项。 通过指定此依赖项,可确保与你的应用程序一起安装所需的版本。

  • 若要创建 ClickOnce 部署的依赖项:在中解决方案资源管理器,选择想要发布的项目的项目节点。 (这是引用了可移植类库项目的项目)在菜单栏上依次选择项目 > 属性,然后选择发布选项卡。上发布页上,选择先决条件。 选择所需 .NET Framework 版本作为系统必备组件。

  • 若要创建安装项目的依赖项:在中解决方案资源管理器,选择安装项目。 在菜单栏上依次选择项目 > 属性 > 先决条件。 选择所需 .NET Framework 版本作为系统必备组件。

有关部署.NET Framework 应用程序的详细信息,请参阅开发人员部署指南。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 09/17/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。