Учебное пособие по .NET MAUI. Создайте свое первое многоплатформенное приложение на C#

Запуск на мобильном устройстве

Вы можете принять решение о развертывании на одной или нескольких платформах в зависимости от среды разработки. Вы только что запустили и развернули свое приложение в Windows. Теперь давайте настроим устройство Android или Android Emulator.

Активировать Hyper-V

В строке поиска Windows введите Функции Windows и выберите Включить или отключить функции Windows.

Включение и отключение компонентов Windows

Установите флажок Microsoft Hyper-V и нажмите ОК.

Функции Windows с установленным флажком Hyper-v

Необходимо перезагрузить компьютер, чтобы изменения вступили в силу.

Установка Android SDK

Откройте Visual Studio и ваше решение MyFirstMauiApp. В раскрывающемся меню целевого объекта отладки выберите net8.0-android в разделе Framework.

Выберите Android в качестве целевого развертывания

Для создания проектов требуются определенные версии Android SDK. Если вы не приняли лицензию Android SDK, вы увидите следующее сообщение об ошибке в окне Список ошибок.

Сообщение об ошибке в окне списка ошибок, показывающее, что лицензия Android SDK не принята.

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

Android SDK Предлагает пользователю установить конкретную версию Android SDK для сборки проекта.

Настроить эмулятор Android

Если у вас нет устройства Android, чтобы развернуть приложение на нем, выполните описанные далее действия, чтобы настроить эмулятор Android. Если вы уже сделали это или хотите использовать собственное устройство Android, можете пропустить этот шаг.

Если вы впервые создаете приложение .NET MAUI, то в раскрывающемся меню целевого объекта отладки увидите выбранный пункт Android Emulator. Щелкните его, чтобы начать процесс создания. Если появится диалоговое окно принятия лицензии, выберите Принять.

Меню панели инструментов Visual Studio 2022, показывающее «Эмулятор Android» в качестве цели отладки.

В результате откроется окно Новое устройство. Нажмите кнопку Создать, чтобы создать эмулятор с параметрами по умолчанию. Будут скачаны образы эмулятора и завершено его создание для использования в Visual Studio. Это может занять некоторое время.

Не беспокойтесь, если уровень API, который вы видите, отличается от изображений. Возможно, значение равно 33 или выше.

Диалоговое окно для создания нового Android Emulator с параметрами по умолчанию.

После создания эмулятора вы увидите кнопку с надписью Начать. Нажмите на нее.

Диспетчер эмуляторов Android, показывающий, что эмулятор создан и готов к запуску.

Возможно, вы увидите запрос на включение платформы низкоуровневой оболочки Windows. Следуйтедокументации, чтобы включить ускорение для повышения производительности (это необходимо для запуска эмулятора). Выберите Все равно запустить.

Запрос на включение платформы низкоуровневой оболочки Windows

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

Меню панели инструментов Visual Studio 2022, показывающее только что созданный эмулятор Android в качестве цели отладки.

Когда все будет готово, оно отобразится в меню отладки Visual Studio.

Меню панели инструментов Visual Studio 2022, показывающее только что созданный эмулятор Android в качестве цели отладки.

Ваш эмулятор Android создан и готов к использованию. В следующий раз, когда вы запустите Visual Studio, эмулятор появится непосредственно в целевом окне отладки и запустится, когда вы его выберете. Если вы столкнулись с какими-либо проблемами или проблемами с производительностью эмулятора, прочтите полную документацию по установке.

Настройка устройства с Android

Для разработки на устройстве с Android необходимо включить отладку USB. Выполните следующие действия на устройстве, чтобы подключить его к Visual Studio. Если у вас нет устройства с Android, вы можете пропустить этот раздел.

Включить режим разработчика

  1. Перейдите на экран Настройки.
  2. Найдите номер сборки с помощью поиска в верхней части экрана настроек или найдите его в разделе «О телефоне».
  3. Нажмите Номер сборки 7–10 раз, пока не появится сообщение «Теперь вы разработчик!\».

Экран настроек устройства Android на экране о телефоне с номером сборки.

Проверьте состояние отладки USB

  1. Перейдите на экран Настройки.
  2. Найдите Отладка по USB с помощью поиска в верхней части экрана настроек или найдите его в параметрах разработчика.
  3. Включите отладку по USB, если она еще не включена.

Экран настроек устройства Android на экране настроек разработчика с включенным параметром отладки по USB.

Доверять устройству

  1. Подключите устройство к компьютеру.
  2. Вам будет предложено Разрешить отладку USB.
  3. Установите флажок Всегда разрешать с этого компьютера.
  4. Щелкните "Разрешить".

Устройство Android предлагает разрешить отладку по USB на устройстве с компьютера.

Теперь ваше устройство настроено и будет отображаться в Visual Studio в качестве цели развертывания.

Возникли проблемы? Проверьте документацию.

Теперь ваш эмулятор или устройство должны быть настроены для развертывания!

Запустить на Android

Убедитесь, что ваше устройство или эмулятор выбраны в качестве цели отладки.

Эмулятор Android Pixel 5 установлен в качестве цели отладки.

В меню выберите Отладка > Начать отладку (или нажмите F5). Если этот параметр отключен, убедитесь, что выбран эмулятор или устройство.

Ваше приложение будет собрано, развернуто на выбранном Android-устройстве/эмуляторе и запущено.

Android Emulator, работающий под управлением приложения .NET MAUI. Отображается сообщение

Вы можете выполнить развертывание на одной или нескольких платформах в зависимости от среды разработки. Вы только что запустили и развернули свое приложение в macOS. Теперь давайте выполним развертывание в iOS.

Закройте приложение .NET MAUI, которое вы запустили, и вернитесь в VS Code.

Щелкните фигурные скобки в правом нижнем углу окна VS Code в строке состояния и выберите Целевой объект отладки.

Компьютер My Mac выбран в качестве цели развертывания по умолчанию

Прокрутите вниз и выберите iPhone 15.

Список целевых объектов отладки с выделенным iPhone 15

Теперь вы должны увидеть iOS: iPhone 15 в качестве нового целевого объекта отладки.

Целевой объект отладки обновлен для отображения iPhone 15

Чтобы запустить приложение, щелкните значок Запуск и отладка на панели действий VS Code. Затем нажмите Запуск и отладка.

Панель запуска и отладки VS Code

Ваше приложение выполнит сборку и развертывание в симуляторе iPhone. Обратите внимание, что это может занять некоторое время, так как выполняется виртуальное включение iPhone!

Приложение .NET MAUI, запущенное в симуляторе iOS

Продолжить