Создание первого приложения

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio 2022 и запустите его в эмуляторе Android:

Для разработки приложений .NET MAUI для iOS в Windows требуется узел сборки Mac. Если вам не нужно специально использовать iOS и у вас нет Mac, попробуйте приступить к работе с Android или Windows.

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio и запустите его в симуляторе iOS:

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio 2022 и запустите его в Windows:

1. Запустите Visual Studio 2022. В окне запуска нажмите кнопку "Создать проект", чтобы создать новый проект :

   

2. В окне "Создание проекта" выберите MAUI в раскрывающемся списке "Все типы проектов", выберите шаблон приложения .NET MAUI и нажмите кнопку "Далее":

   

3. В окне "Настройка нового проекта" назовите проект, выберите подходящее расположение и нажмите кнопку "Далее":

   

4. В окне "Дополнительные сведения" выберите версию .NET, которую вы хотите нацелить, и нажмите кнопку "Создать":

   

5. Дождитесь создания проекта и его зависимостей:

   

6. На панели инструментов Visual Studio используйте раскрывающийся список "Целевой объект отладки", чтобы выбрать эмуляторы Android, а затем запись эмулятора Android:

   

7. На панели инструментов Visual Studio нажмите кнопку эмулятора Android:

   

   Visual Studio запустит процесс установки пакета SDK для Android по умолчанию и эмулятора Android.

8. В окне пакета SDK для Android — лицензионное соглашение нажмите кнопку "Принять ":

   

9. В диалоговом окне "Контроль учетных записей пользователей" нажмите кнопку "Да":

   

   Дождитесь скачивания пакета SDK для Android по умолчанию и эмулятора Android Visual Studio.

10. В диалоговом окне "Контроль учетных записей пользователей" нажмите кнопку "Да":

    

11. В диалоговом окне "Платформа ПАКЕТА SDK для Android" отсутствует, нажмите кнопку "Установить":

    

12. В окне пакета SDK для Android — лицензионное соглашение нажмите кнопку "Принять ":

    

    Подождите, пока Visual Studio установит компоненты пакета SDK для Android.

13. В окне "Новое устройство" нажмите кнопку "Создать":

    

    Подождите, пока Visual Studio будет скачивать, распакучивать и создавать эмулятор Android.

14. Закройте окно диспетчер устройств Android:

    

15. На панели инструментов Visual Studio нажмите кнопку Api 7 — API 35 (Android 15.0 — API 35):

    

16. В окне пакета SDK для Android — лицензионное соглашение нажмите кнопку "Принять ":

    

17. В диалоговом окне "Контроль учетных записей пользователей" нажмите кнопку "Да":

    

    Дождитесь установки Visual Studio, чтобы скачать пакет SDK для Android.

18. На панели инструментов Visual Studio нажмите кнопку Api 7 — API 35 (Android 15.0 — API 35), чтобы создать и запустить приложение:

    

    Visual Studio запустит эмулятор Android, создадит приложение и развернет приложение в эмуляторе.

    Предупреждение

    Аппаратное ускорение должно быть включено для максимальной производительности эмулятора Android. Сбой этого приведет к тому, что эмулятор работает очень медленно. Дополнительные сведения см. в статье "Как включить аппаратное ускорение с помощью эмуляторов Android (Hyper-V и AEHD)".

19. В работающем приложении в эмуляторе Android нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается.

    

Устранение неполадок

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

6. На панели инструментов Visual Studio нажмите кнопку "Компьютер Windows", чтобы создать и запустить приложение:

   

7. В работающем приложении нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается:

   

Устранение неполадок

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

6. В Visual Studio свядите интегрированную среду разработки с узлом сборки Mac. Дополнительные сведения см. в разделе "Пара с Mac для разработки iOS".

7. На панели инструментов Visual Studio используйте раскрывающийся список "Целевой объект отладки", чтобы выбрать симуляторы iOS, а затем определенный симулятор iOS:

   

8. На панели инструментов Visual Studio нажмите кнопку "Пуск" для выбранного симулятора iOS, чтобы создать и запустить приложение:

   

   Visual Studio создаст приложение, запустите удаленный симулятор iOS для Windows и развернет приложение в удаленном симуляторе. Дополнительные сведения о удаленном симуляторе iOS для Windows см. в удаленном симуляторе iOS для Windows.

9. В работающем приложении нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается.

   

Устранение неполадок

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

Приложения .NET MAUI, предназначенные для Mac Catalyst, можно запускать и отлаживать только с помощью Visual Studio Code.

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio Code и запустите его в эмуляторе Android:

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio Code на Компьютере Mac и запустите его в симуляторе iOS:

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio Code на компьютере Mac и запустите его в macOS:

В этом руководстве вы создадите первое приложение .NET MAUI в Visual Studio Code в Windows и запустите его в Windows:

7. В Visual Studio Code убедитесь, что среда Android настроена правильно, нажав клавиши CTRL+SHIFT+P в Windows или CMD+SHIFT+P в macOS, а затем выберите .NET MAUI: настройка Android, а затем обновление среды Android. Все обнаруженные ошибки должны быть устранены.

8. В строке состояния в нижней части Visual Studio Code нажмите на фигурные скобки { } и убедитесь, что целевой объект отладки настроен для конкретного эмулятора Android:

   

   Вы также можете задать целевой объект отладки, нажав клавиши CTRL+SHIFT+P в Windows или Cmd+SHIFT+P в macOS, и выбрав .NET MAUI: Выбрать устройство Android из палитры команд.

9. Создайте и запустите приложение в Android, нажав клавиши F5 или нажав кнопку Запустить в правом верхнем углу Visual Studio Code:

   

   Если вам будет предложено выбрать отладчик в палитре команд, выберите C#, а затем конфигурацию запуска проекта.

10. В работающем приложении в выбранном эмуляторе Android нажмите несколько раз кнопку Click me и обратите внимание, что количество нажатий кнопки увеличивается.

    

Отладка приложения на устройстве Android

Чтобы выполнить отладку приложения на устройстве Android, выполните следующие действия.

1. Убедитесь, что устройство настроено для развертывания. Дополнительные сведения см. в статье Настройка устройства для развертывания.
2. Подключите устройство к компьютеру и выберите его в качестве целевого объекта отладки в Visual Studio Code.
3. Запустите приложение.

7. В Visual Studio Code убедитесь, что среда Apple настроена правильно, нажав клавиши CMD+SHIFT+P , а затем выберите .NET MAUI: Настройка Apple, а затем обновите среду Apple. Все обнаруженные ошибки должны быть устранены.

8. В строке состояния в нижней части Visual Studio Code нажмите на символ фигурных скобок { } и убедитесь, что цель отладки задана на конкретный симулятор iOS.

   

   Вы также можете задать целевой объект отладки, нажав клавиши Cmd+SHIFT+P и выбрав .NET MAUI: выбрать устройство iOS из палитры команд.

9. Создайте и запустите приложение в iOS, нажав клавиши F5 или нажав кнопку запуска в правом верхнем углу Visual Studio Code:

   

   Если вам будет предложено выбрать отладчик в палитре команд, выберите C#, а затем конфигурацию запуска проекта.

10. В работающем приложении в выбранном симуляторе iOS нажмите несколько раз кнопку Click me и обратите внимание, что количество нажатий кнопки увеличивается.

    

Отладка приложения на устройстве iOS

Чтобы выполнить отладку приложения на устройстве iOS, выполните следующие действия.

1. Убедитесь, что вы добавили идентификатор Apple ID в Xcode в Xcode > Настройки > Аккаунты.
2. Убедитесь, что ваше устройство зарегистрировано в вашей команде, если вы принадлежите программе разработчика Apple.
3. Включите режим разработчика на устройстве. При первом запуске приложения на устройстве может появиться всплывающее окно. Убедитесь, что вы выберете "Разрешить". Дополнительные сведения о режиме разработчика см. в разделе Включение режима разработчика на устройстве на developer.apple.com.
4. Подключите устройство к компьютеру и выберите его в качестве целевого объекта отладки в Visual Studio Code.
5. Запустите приложение.

7. В Visual Studio Code убедитесь, что среда Apple настроена правильно, нажав клавиши CMD+SHIFT+P , а затем выберите .NET MAUI: Настройка Apple, а затем обновите среду Apple. Все обнаруженные ошибки должны быть устранены.

8. В строке состояния в нижней части Visual Studio Code нажмите на значок фигурных скобок { } и убедитесь, что Цель отладки настроена на ваш Mac:

   

   Вы также можете задать целевой объект отладки, нажав клавиши Cmd+SHIFT+P и выбрав .NET MAUI: выбрать устройство macOS из палитры команд.

9. Создайте и запустите приложение в macOS, нажав F5 или нажав кнопку Запустить в правом верхнем углу Visual Studio Code:

   

   Если вам будет предложено выбрать отладчик в палитре команд, выберите C#, а затем конфигурацию запуска проекта.

10. В работающем приложении нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается:

    

7. В строке состояния в нижней части Visual Studio Code нажмите значок фигурных скобок { } и убедитесь, что для целевого объекта отладки задано значение Windows:

   

   Вы также можете задать целевой объект отладки, нажав клавиши CTRL+SHIFT+P и выбрав .NET MAUI: выбрать устройство Windows из палитры команд.

8. Создайте и запустите приложение в Windows, нажав F5 или нажав кнопку Запустить в правом верхнем углу Visual Studio Code:

   

   Если вам будет предложено выбрать отладчик в палитре команд, выберите C#, а затем конфигурацию запуска проекта.

9. В работающем приложении нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается: