Обновление существующих приложений до единого API

  • Статья

Внимание

Классический API Xamarin, предшествующий унифицированному API, устарел.

  • Последняя версия Xamarin.iOS для поддержки классического API (monotouch.dll) была Xamarin.iOS 9.10.
  • Xamarin.Mac по-прежнему поддерживает классический API, но он больше не обновляется. Так как он не рекомендуется, разработчики должны переместить свои приложения в единый API.

Обновление приложений

Для обновления приложений необходимо выполнить три шага.

  1. Исправьте все предупреждения компилятора в существующем коде, особенно те, которые относятся к устаревшим API.

  2. Используйте средство миграции, встроенное в Visual Studio для Mac для обновления файлов проекта и пространств имен.

  3. Исправьте оставшиеся ошибки компилятора, связанные с новыми 64-типами и другими API , которые изменились. Ознакомьтесь с этими советами по дополнительным сведениям об обновлениях вручную, которые могут потребоваться.

Существуют конкретные руководства для каждого продукта, которые помогут вам обновить приложения до единого API и 64-разрядной поддержки:

Приложения Xamarin.iOS

Существующие приложения Xamarin.iOS можно обновить до единого API с помощью средства автоматической миграции, встроенного в Visual Studio для Mac. Затем могут потребоваться некоторые дополнительные исправления, как описано в этих инструкциях и советах.

Приложения Xamarin.Mac

Существующие приложения Xamarin.Mac можно обновить до единого API с помощью средства автоматической миграции, встроенного в Visual Studio для Mac. Затем могут потребоваться некоторые дополнительные исправления, как описано в этих инструкциях и советах.

приложения Xamarin.Forms.

Следуйте этим инструкциям, чтобы обновить существующее решение Xamarin.Forms с проектом iOS для использования единого API. Поддержка унифицированных API доступна только в Xamarin.Forms 1.3 и более поздних версиях, поэтому инструкции также объясняют, как обновить приложение Xamarin.Forms до версии 1.3. Эти советы помогут обновить любой собственный код iOS в пользовательских отрисовщиках или службах зависимостей.

Работа с собственными типами в кроссплатформенных приложениях

В этой статье рассматриваются новые типы собственных API iOS (nint, nuint, nfloat) в кроссплатформенных приложениях, где код используется для устройств, отличных от iOS, таких как Android или Windows Телефон OSes. Он предоставляет аналитические сведения о том, когда следует использовать собственные типы и предоставляет несколько возможных решений в тех случаях, когда новый тип должен использоваться с кроссплатформенным кодом.

Обновление привязок к единому API

Клиентам, которые создали привязки к Objective-C библиотекам, потребуется обновить проект привязки, чтобы отразить изменения в базовом API (где некоторые типы теперь будут 64-разрядными). Следуйте этим инструкциям, чтобы обновить существующий проект привязки для поддержки единого API.