Новая сборка может запускаться на тестовом телефоне и при этом потерять сессию или локальные документы после обновления старого приложения. Поэтому миграцию Xamarin.Forms на .NET MAUI строим вокруг работающих пользовательских сценариев: что нужно сохранить, что придётся заменить и как выпустить переходную версию.
Проверяем, какой проект предстоит переносить
Xamarin.Forms, Xamarin.Android и Xamarin.iOS имеют разные пути перехода. Для Forms исследуем общий UI и платформенные проекты; нативному Xamarin-клиенту не назначаем переписывание на MAUI без отдельного основания. Поддержка Xamarin завершена: сохранение старой сборки не решает задачу дальнейших обновлений платформенных зависимостей.
Восстанавливаем воспроизводимую сборку, состав NuGet-пакетов, используемые версии инструментов и доступ к исходникам. Выделяем закрытые SDK, собственные renderers и effects, push, авторизацию, платежи и работу с оборудованием. Для каждой зависимости выясняем, доступна ли подходящая версия, нужен ли адаптер или функциональная замена.
Выбираем границу изменений до переноса экранов
Можно сохранять прикладную логику и привычную навигацию, одновременно переработав несовместимые компоненты. Можно включить изменение архитектуры и интерфейса, но это другой объём. Сначала переносим характерный сложный сценарий — например, форму с камерой, офлайн-документом и отправкой на сервер. Такой образец показывает реальную сложность лучше пустого стартового экрана.
| Область | Что переносим или меняем | Как подтверждаем результат |
| Интерфейс | XAML, стили, навигацию и пользовательские компоненты | Проходим те же действия на целевых платформах |
| Платформенные зависимости | Разрешения, обработчики и внешние SDK | Проверяем каждый согласованный системный сценарий |
| Данные на устройстве | Локальную базу, настройки и защищённые значения | Устанавливаем обновление поверх прежней версии с данными |
Для пользовательских компонентов выбираем допустимое повторное использование либо переход к обработчикам MAUI. Не считаем автоматически преобразованный проект готовым приложением: после изменения структуры могут отличаться размеры элементов, события, навигация и взаимодействие с библиотеками. Выбранную конфигурацию проектов фиксируем вместе с настройками сборки.
Сохраняем данные и совместимость установленного приложения
Составляем карту хранения: что находится на сервере, в SQLite, настройках и SecureStorage. У защищённого хранилища Xamarin.Essentials и MAUI есть различия реализации; одинакового имени ключа недостаточно, чтобы считать перенос проверенным. Проектируем чтение прежних значений, преобразование и запись в согласованный формат без вывода секретов в журналы.
Для локальной базы определяем переход схемы и поведение при незавершённой отправке. Если старый клиент хранит черновик или очередь операций, новая версия должна обработать их по согласованным правилам. До изменения данных предусматриваем восстановление при прерывании; возможность возврата к старому клиенту зависит от совместимости схем и не обещается автоматически.
Проверяем идентификаторы приложения, подпись, доступы к магазинам и платформенные настройки интеграций. При сохранении нужной идентичности тестируем обновление без удаления приложения. Новая чистая установка проверяется отдельно и не заменяет этот сценарий.
Контрольный выпуск и результат миграции
Сравниваем поведение старой и новой версии на согласованных данных: вход и выход, работа без связи, восстановление после остановки, уведомления, ссылки, камера, файлы и оплаченные возможности, если они есть. Проверяем клиент вместе с действующим API: пользователи старой версии не обновятся одновременно.
Заказчик получает перенесённый согласованный состав приложения, исходники изменений, воспроизводимую сборку и результаты контрольного обновления. Подготовку карточек магазинов, серверные изменения и новый дизайн выделяем в оценке. Для расчёта нужны репозиторий, последняя рабочая сборка, список платформ и SDK, данные о хранении и доступный способ выпуска.
Миграция автоматически ускорит приложение?
Нет. Переход платформы и устранение конкретных причин медленной работы — разные задачи. Если скорость важна, согласуем измеряемые сценарии до переноса и отдельно исследуем узкие места.
Что делать, если библиотека больше не поддерживается?
Проверить её роль и варианты: совместимая замена, платформенный адаптер либо переработка функции. Решение зависит от API, лицензии и поведения компонента; название похожего пакета не подтверждает совместимость.
Можно совместить миграцию с редизайном?
Да, но изменения нужно разделить в составе работ и контрольных сценариях. Иначе трудно отличить ошибку переноса от нового поведения продукта. Порядок выпуска выбираем по риску для действующих пользователей.
Оценить переход с Xamarin.Forms
Пришлите сведения о проекте, платформах и критичных SDK. Начнём с карты зависимостей и сложного пользовательского сценария, затем определим состав миграции.
Обсудить миграцию