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

В этом руководстве вы создадите первое приложение .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 Emulator.

   

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

   

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

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

   

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

   

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

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

    

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

    

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

    

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

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

    

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

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

    

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

    

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

    

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

    

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

18. На панели инструментов Visual Studio нажмите кнопку Pixel 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 подключите IDE к узлу сборки 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. В работающем приложении нажмите кнопку "Щелкните меня" несколько раз и обратите внимание, что количество нажатий кнопки увеличивается: