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

В этом руководстве вы узнаете, как создать и запустить первое приложение пользовательского интерфейса многоплатформенного приложения .NET (.NET MAUI) в Visual Studio 2022 в Windows или Visual Studio Code в Windows, macOS или Linux. Это поможет убедиться, что среда разработки настроена правильно.

Visual Studio

Необходимые компоненты

• Visual Studio 2022 17.12 или более поздней версии с установленной рабочей нагрузкой пользовательского интерфейса многоплатформенного приложения .NET. Дополнительные сведения см. в разделе Установка.

Создать приложение

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

Visual Studio Code

Необходимые компоненты

• Visual Studio Code с установленным и настроенным расширением .NET MAUI:
  • Учетная запись Майкрософт, подключенная к комплекту разработки на C#.
  • Установленный пакет SDK для .NET.
  • SDK для .NET MAUI установлен.
  • Xcode, установленный на вашем Mac, включая среды выполнения симулятора и средства командной строки Xcode, если вы нацелены на платформы Apple.
  • Microsoft OpenJDK, пакет SDK для Android и эмулятор Android, установленный на компьютере, если предназначен для Android.

Дополнительные сведения см. в разделе Установка.

Создать приложение

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

1. Запустите Visual Studio Code. В обозревателе нажмите клавишу Create .NET Project:

   

   Кроме того, нажмите CTRL+SHIFT+P в Windows или CMD+SHIFT+P в macOS, а затем выполните команду .NET: Новый проект....

2. В палитре команд выберите шаблон приложения .NET MAUI:

   

3. В диалоговом окне , "Расположение проекта" выберите место, где вы хотите создать новый проект.

   Важный

   Проекты должны быть созданы в пустой папке.

4. В палитре команд введите имя нового проекта и нажмите клавишу ВВОД:

   

5. В палитре команд нажмите клавишу Создать проект:

   

   Дождитесь создания проекта и, при необходимости, подтвердите, что папка является надежным расположением.

6. В Обозревателеразверните корневой узел вашего проекта, а затем откройте файл C#, например, MainPage.xaml.cs:

   

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: Configure Apple, затем Refresh Apple environment. Все обнаруженные ошибки должны быть устранены.

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: Configure Apple, затем Refresh Apple environment. Все обнаруженные ошибки должны быть устранены.

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

   

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

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

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

В этом руководстве вы узнали, как создать и запустить первое приложение многоплатформенного приложения .NET (.NET MAUI).

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