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

В этом руководстве вы узнаете, как создать и запустить первое приложение .NET Multi-platform App UI (.NET MAUI) в Visual Studio 2022 в Windows или Visual Studio 2022 для Mac. Это поможет убедиться, что среда разработки настроена правильно.

Visual Studio

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

• Visual Studio 2022 17.8 или более поздней версии с установленной рабочей нагрузкой пользовательского интерфейса многоплатформенного приложения .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 — лицензионное соглашение нажмите кнопку "Принять ":

   

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

    

11. В окне принятия лицензии нажмите кнопку "Принять":

    

    Подождите, пока Visual Studio загрузит пакет SDK для Android и Android Emulator.

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

    

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

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

    

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

    

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

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

    

16. На панели инструментов Visual Studio нажмите кнопку Api 5 — API 34 (Android 14.0 — API 33), чтобы создать и запустить приложение:

    

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

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

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

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

    

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

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

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

   

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

   

   Если вы не включили режим разработчика, Visual Studio предложит включить его. В диалоговом окне "Включить режим разработчика для Windows" щелкните параметры для разработчиков, чтобы открыть приложение Параметры:

   

   В приложении Параметры включите режим разработчика и примите отказ от ответственности:

   

   Закройте приложение Параметры и закройте диалоговое окно "Включить режим разработчика для Windows".

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

   

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

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

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 2022 для Mac.

Visual Studio для Mac

Примечание.

Visual Studio для Mac планируется на пенсию к 31 августа 2024 г. в соответствии с Современная политика жизненного цикла Майкрософт. Visual Studio для Mac 17.6 будет поддерживаться до 31 августа 2024 г. с обновлениями обслуживания для проблем с безопасностью и обновленными платформами от Apple. Дополнительные сведения, включая альтернативные варианты разработки на компьютере Mac, см. в статье "Что происходит с Visual Studio для Mac?".

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

• Visual Studio 2022 для Mac 17.6 с установленными рабочими нагрузками .NET, .NET MAUI, Android и iOS. Дополнительные сведения см. в разделе Установка.

Внимание

Чтобы использовать Visual Studio для Mac с .NET 8, включите другие функции предварительной версии Visual Studio >>, используйте пакет SDK для .NET 8, если установлен (требуется перезапуск) проверка box.>>

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

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

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

   

2. В окне "Выбор шаблона" для нового окна проекта выберите приложение Multiplatform>, выберите шаблон приложения .NET MAUI и нажмите кнопку "Продолжить".

   

3. В окне "Настройка нового приложения .NET MAUI" выберите версию .NET, которую вы хотите нацелить, и нажмите кнопку "Продолжить":

   

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

   

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

   

6. Visual Studio 2022 для Mac отобразит информационную панель, если у Mac отсутствуют компоненты пакета SDK для Android. Нажмите кнопку "Установить", чтобы установить пакет SDK для Android:

   

7. В окне пакета SDK для Android выберите зависимости Android автоматически проверка и нажмите кнопку "Скачать и установить".

   

8. В окне принятия лицензий нажмите кнопку "Принять":

   

   Подождите, пока Visual Studio 2022 для Mac скачать пакет SDK для Android:

9. На панели инструментов Visual Studio 2022 для Mac измените целевой объект отладки на Эмулятор Android:

   

10. На панели инструментов Visual Studio 2022 для Mac нажмите кнопку Воспроизведения , чтобы создать приложение и попытаться запустить его:

    

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

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

    

12. В окне принятия лицензий нажмите кнопку "Принять":

    

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

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

    

14. На панели инструментов Visual Studio 2022 для Mac измените целевой объект отладки на Pixel 5 — API 34 (API 34):

    

15. На панели инструментов Visual Studio 2022 для Mac нажмите кнопку Воспроизведения , чтобы запустить приложение в эмуляторе Android:

    

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

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

    

6. На панели инструментов Visual Studio 2022 для Mac убедитесь, что целевой объект отладки установлен в симулятор iOS:

   

7. На панели инструментов Visual Studio 2022 для Mac нажмите кнопку Воспроизведения , чтобы запустить приложение в выбранном симуляторе iOS:

   

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

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

   

6. На панели инструментов Visual Studio 2022 для Mac убедитесь, что целевой объект отладки имеет значение My Mac (MacCatalyst):

   

7. В Visual Studio 2022 для Mac щелкните правой кнопкой мыши проект MyMauiApp и выберите "Изменить файл проекта". Затем в редакторе файлов проекта вставьте следующий XML-код перед первым <ItemGroup>:

   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|net8.0-maccatalyst|AnyCPU'">
       <RuntimeIdentifiers>maccatalyst-x64;maccatalyst-arm64</RuntimeIdentifiers>
   </PropertyGroup>
   

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

   

   Visual Studio 2022 для Mac создаст и развернет приложение.

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

   

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

Visual Studio Code (предварительная версия)

Примечание.

Поддержка .NET MAUI в Visual Studio Code по-прежнему доступна в предварительной версии. Попробуйте и поделитесь своими отзывами!

Установка расширения

Следуйте инструкциям, чтобы настроить расширение MAUI .NET для Visual Studio Code.

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

Чтобы создать новое приложение .NET MAUI:

1. Нажмите кнопку "Создать проект .NET" в Обозреватель или CTRL/CMD+SHIFT+P>.NET: создать проект....
2. Выберите приложение .NET MAUI или приложение .NET MAUI Blazor.
3. Выберите пустую папку. Если проводник снова откроется, папка не пуста.
4. Задайте имя проекта.
5. Убедитесь, что проект успешно загружается в Обозреватель решений, а затем откройте файл C# или XAML.

Вы также можете открыть существующий проект MAUI .NET в Visual Studio Code с помощью файла > Open....

Теперь приложение должно отображаться в Обозреватель решений пакета разработки C# в Visual Studio Code. Так как расширение MAUI для .NET зависит от набора средств разработки C#, вы можете использовать все его функции вместе с расширением .NET MAUI.

Выбор целевого устройства

Щелкните фигурные { } скобки в правом нижнем углу Visual Studio Code. Здесь вы можете изменить проект запуска, изменить целевой объект отладки на любой допустимый на компьютере разработки и закрепить любой параметр в строке состояния Visual Studio Code:

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

По умолчанию можно развернуть на локальном компьютере разработки macOS или Windows. В macOS можно также развернуть в симуляторах iOS.

Если вы хотите использовать эмуляторы Android, выполните следующие действия.

1. Перейдите в терминал <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/latest/bin/.
2. Запустите и sdkmanager --install system-images;android-33;google_apis;x86_64 в sdkmanager --install emulator Windows или ./sdkmanager --install emulator./sdkmanager --install system-images;android-33;google_apis;x86_64 в macOS.
3. Затем вы можете создать новый эмулятор в командной строке с помощью avdmanager Android. Например, вы можете запускаться avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" в Windows или ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64" в macOS.

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

Отладка приложения

Чтобы выполнить отладку приложения, перейдите в меню запуска и отладки Visual Studio Code и нажмите кнопку "Запуск и отладка". Кроме того, можно использовать для F5 запуска сеанса отладки. Если Visual Studio Code предложит выбрать отладчик, убедитесь, что выбрано .NET MAUI.

Отладчик автоматически выбирает целевой объект отладки и проект запуска, заданный в меню фигурных скобок { } . Если вы ничего не выбрали, вам будет предложено выбрать целевой объект отладки.

После запуска отладки приложения можно использовать встроенные средства отладки Visual Studio Code для задания точек останова, шага по всему коду и многое другое.

Подробнее

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

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

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

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