Xamarin.Forms Обновление приложения до приложения .NET MAUI с помощью помощника по обновлению .NET

  • Статья

Помощник по обновлению .NET помогает обновить Xamarin.Forms проекты до мультиплатформенного пользовательского интерфейса приложений .NET (.NET MAUI), преобразовав файл проекта решения и выполнив общие обновления кода. В частности, средство будет:

  • Преобразуйте Xamarin.Forms проект библиотеки классов, проект Xamarin.iOS и проект Xamarin.Android в проекты в стиле SDK.
  • Обновите целевую платформу в файлах net8.0-android проекта и net8.0-iosпри необходимости.
  • Задайте <UseMaui>true</UseMaui> в файлах проекта.
  • Добавьте дополнительные свойства проекта и удалите свойства проекта, которые не требуются.
  • Добавьте и удалите определенные пакеты NuGet:
    • Xamarin.Forms Удалите пакеты NuGet и Xamarin.Essentials удалите их.
    • Замените пакет NuGet пакетом Xamarin.CommunityToolkit.NET MAUI Community Toolkit NuGet на пакет NuGet.
    • Замените Xamarin.Forms совместимые SkiaSharp версии пакетов NuGet совместимыми версиями .NET MAUI, если они используются.
  • Удалите ссылки на Xamarin.Essentials пространство имен и замените Xamarin.Forms пространство Microsoft.Maui имен пространством имен и Microsoft.Maui.Controls пространствами имен.

После запуска средства потребуется дополнительное усилие для завершения миграции.

Примечание.

Помощник по обновлению .NET для .NET MAUI не поддерживает обновление проектов UWP, проектов расширений iOS или проектов привязки.

Дополнительные сведения о помощнике по обновлению .NET, включая другие типы приложений, которые он может преобразовать, см. в разделе "Обзор помощника по обновлению .NET".

Начать

Помощник по обновлению .NET доступен в виде расширения Visual Studio в Windows и в качестве средства cli для Windows и Mac. Чтобы использовать его, проект Xamarin.Forms должен использовать Xamarin.Forms версию 4.8 или более поздней версии. Однако для наилучшего успеха мы рекомендуем использовать Xamarin.Forms проект Xamarin.Forms 5.0 и .NET Standard 2.0 или более поздней версии.

Важно!

Помощник по обновлению .NET для .NET MAUI по-прежнему находится в процессе разработки. Отправьте отзыв сметкой "area:Maui", чтобы мы могли продолжать улучшать это средство.

Помощник по обновлению .NET предложит выполнить следующее:

  • На месте: этот параметр обновляет проект без копирования.
  • Параллельно. Этот параметр копирует проект и обновляет копию, оставляя исходный проект в одиночку. В настоящее время обновление .NET MAUI параллельно требует создания новых проектов для обновления каждой головы проекта. Попытка обновить голову проекта в существующий проект, скорее всего, приведет к ошибкам и не поддерживается в настоящее время.

Перед обновлением Xamarin.Forms приложения до .NET MAUI необходимо сначала обновить Xamarin.Forms приложение, чтобы использовать Xamarin.Forms 5, и убедиться, что он по-прежнему работает правильно. Кроме того, следует обновить зависимости, которые приложение использует до последних версий.

Это поможет упростить остальную часть процесса миграции, так как это позволит свести к минимуму различия API между Xamarin.Forms .NET MAUI и гарантировать, что вы используете совместимые с .NET версии зависимостей, если они существуют.

Быстрые действия в Visual Studio

Помощник по обновлению .NET имеет быстрое действие для преобразования Xamarin.Forms пространств имен в соответствующие пространства имен .NET MAUI, которое отображается в виде лампочки:

Screenshot of previewing the application of a light bulb suggestion.

Быстрое действие сделает необходимые замены по файлу.

Примечание.

Лампочки быстрого действия будут отображаться при переносе файлов из Xamarin.Forms проекта в проект .NET MAUI.

Установка

Visual Studio 2022 версии 17.6.0 или более поздней настоятельно рекомендуется запустить помощник обновления. Чтобы установить расширение помощник обновления, выполните следующие действия.

  1. Откройте Visual Studio и выберите пункт меню "Управление расширениями>".
  2. В диалоговом окне "Управление расширениями" найдите и скачайте помощник по обновлению .NET.
  3. После скачивания расширения закройте Visual Studio. Затем будет установлено расширение.

Расширения обновляются автоматически при появлении новой версии в Visual Studio Marketplace. Дополнительные сведения см. в разделе "Автоматическое обновление расширений".

Запуск помощник обновления

Щелкните проект правой кнопкой мыши в Обозреватель решений и выберите "Обновить".

Следующие шаги

Миграция вручную