在 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,规范化链接,移除外部媒体和导航标记。
