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

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

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 Code

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

• Visual Studio Code с установленным расширением .NET MAUI. Дополнительные сведения см. в разделе Установка.

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

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

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

Примечание.

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

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

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

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

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

Вы можете развернуть на локальном компьютере разработки (настольный компьютер Windows или macOS с Xcode) без дополнительных действий.

Использование платформы Android

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

1. Перейдите в терминал <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/.

2. Используется sdkmanager для установки эмулятора.

   В Windows выполните следующие команды в терминале:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   В macOS выполните следующие команды в терминале:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Примечание.

   Важны кавычки вокруг аргументов командной sdkmanager строки.

3. Затем вы можете создать новый эмулятор в командной строке с помощью avdmanager Android.

   В Windows выполните следующие команды в терминале:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   В macOS выполните следующие команды в терминале:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Примечание.

   Важны кавычки вокруг аргументов командной avdmanager строки.

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

Целевой iOS

Симуляторы iOS встроены в Xcode. Чтобы скачать симуляторы, убедитесь, что выбран параметр для их установки при первом запуске Xcode или перейдите к платформам параметров > Xcode > и выберите среду выполнения симулятора для установки.

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

1. Укажите идентификатор Apple ID в учетной > записи параметров Xcode>.
2. Зарегистрируйте устройство в команде, если вы принадлежите программе разработчика Apple.
3. Включите режим разработчика на устройстве, как описано в разделе "Включение режима разработчика" на устройстве. При первом запуске приложения на устройстве может появиться всплывающее окно. Убедитесь, что вы выберете "Разрешить".

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

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

Примечание.

В предварительных версиях расширения отладчик был указан как MAUI .NET. В стабильном выпуске эта конфигурация была заменена на C#.

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

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

Подробнее

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

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

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

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