将现有应用更新到 Unified API

重要

Xamarin Classic API(Unified API 的前身)已被弃用。

  • 支持 Classic API (monotouch.dll) 的最后一个 Xamarin.iOS 版本是 Xamarin.iOS 9.10。
  • Xamarin.Mac 仍然支持 Classic API,但不再更新。 由于 Classic API 已被弃用,开发人员应将其应用程序迁移到 Unified API。

如何更新应用

通过三个步骤更新应用:

  1. 修复现有代码中的所有编译器警告,特别是与已弃用 API 相关的警告。

  2. 使用 Visual Studio for Mac 的内置迁移工具来更新项目文件和命名空间。

  3. 修复与新的 64 类型和已更改的其他 API 相关的剩余编译器错误。 查看这些提示,了解有关可能需要的手动更新的更多信息。

每个产品都提供了具体的指南来帮助你将应用更新到 Unified API 和 64 位支持:

Xamarin.iOS 应用

可以使用 Visual Studio for Mac 的内置自动迁移工具将现有 Xamarin.iOS 应用更新到 Unified API。 然后可能需要进行一些额外的修复,如这些说明提示中所述。

Xamarin.Mac 应用

可以使用 Visual Studio for Mac 的内置自动迁移工具将现有 Xamarin.Mac 应用更新到 Unified API。 然后可能需要进行一些额外的修复,如这些说明提示中所述。

Xamarin.Forms 应用

按照以下说明使用 iOS 项目更新现有 Xamarin.Forms 解决方案以使用 Unified API。 Unified API 支持仅在 Xamarin.Forms 1.3 及更高版本中可用,因此说明还解释了如何将 Xamarin.Forms 应用更新到版本 1.3。 这些提示可以帮助你更新自定义呈现器或依赖项服务中的任何本机 iOS 代码。

使用跨平台应用中的本机类型

本文介绍了如何在跨平台应用程序中使用新的 iOS Unified API 本机类型(nint、nuint、nfloat),其中代码与非 iOS 设备(例如 Android 或 Windows Phone 操作系统)共享。 其中提供了有关何时使用本机类型的见解,并为新类型必须与跨平台代码一起使用的情况提供了几种可能的解决方案。

更新 Unified API 的绑定

已创建 Objective-C 库的绑定的客户需要更新绑定项目,以反映基础 API 中的更改(其中某些类型现在是 64 位)。 请按照这些说明更新现有绑定项目以支持 Unified API