Чтобы начать разработку собственных кроссплатформенных приложений .NET MAUI в Windows, macOS или Linux, установите последнюю версию Visual Studio Code, выполнив действия по установке.
Необходимые компоненты
Чтобы создавать, подписывать и развертывать приложения MAUI .NET для iOS, вам потребуется:
- Компьютер Mac, совместимый с Xcode. Дополнительные сведения см. в документации по минимальным требованиям Apple.
- Определенная версия Xcode, которая зависит от используемой версии .NET MAUI. Дополнительные сведения см. в разделе "Версии выпуска".
- Идентификатор Apple и платная регистрация программы разработчика Apple. Идентификатор Apple ID необходим для развертывания приложений на устройствах и отправки приложений в Apple Store.
Установка
Чтобы создать приложения .NET MAUI, необходимо установить последнюю версию Visual Studio Code.
На вкладке "Расширения" на вкладке "Расширения" найдите расширение .NET MAUI и установите расширение .NET MAUI. Расширение MAUI для .NET автоматически устанавливает расширения пакета разработки C# и C# , необходимые для запуска расширения .NET MAUI.
Примечание.
Для расширения .NET MAUI требуются расширения пакета разработки C# и C#. Чтобы использовать функциональные возможности расширения MAUI для .NET, необходимо войти в комплект средств разработки C#. Дополнительные сведения см . в этой записи блога, чтобы узнать больше о комплекте средств разработки на C# и его семействе расширений.
Установка рабочих нагрузок .NET и .NET MAUI
Установите .NET 9.
В Windows рекомендуется использовать установщик Visual Studio для управления установками рабочих нагрузок .NET и .NET MAUI. Инструкции по использованию установщика Visual Studio см . здесь.
В Linux установите с помощью инструкций по установке скриптов.
Установите рабочую нагрузку .NET MAUI.
В Windows, если только не установлен с помощью установщика Visual Studio, выполните следующую команду в терминале:
dotnet workload install maui
В macOS выполните следующую команду в терминале:
sudo dotnet workload install maui
В Linux выполните следующую команду в терминале:
dotnet workload install maui-android
Чтобы выполнить отладку приложения .NET MAUI в Visual Studio Code, необходимо иметь допустимую целевую платформу относительно операционной системы компьютера разработки. Включение недопустимых целевых платформ будет препятствовать созданию проекта. Вы можете управлять целевыми платформами в файле проекта приложения (CSPROJ):
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>net9.0-android;net9.0-ios;net9.0-maccatalyst</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net9.0-windows10.0.19041.0</TargetFrameworks>
| Операционная система |
Поддерживаемые целевые платформы |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
iOS и macOS
Чтобы выполнить отладку до целевого объекта iOS или macOS в Visual Studio Code:
- Установите версию Xcode, необходимую для используемой версии .NET MAUI. Дополнительные сведения см. в разделе "Версии выпуска". Последний стабильный выпуск Xcode можно скачать из Apple App Store.
- Запустите
xcode-select --install в терминале, чтобы получить средства командной строки Xcode.
- Откройте Xcode и убедитесь, что вы принимаете все лицензионные соглашения.
Android
Чтобы выполнить отладку до целевого объекта Android в Visual Studio Code, выполните приведенные ниже действия.
- Установите Microsoft OpenJDK 17.
- Установите пакет SDK для Android с помощью одного из следующих подходов:
- (Рекомендуется) Создайте новый проект MAUI .NET (
dotnet new maui) и используйте целевой объект InstallAndroidDependencies.
- Установка с помощью Visual Studio (только для Windows).
- Установите через Android Studio.
- Установите с помощью предпочтительного диспетчера пакетов в Linux.
Устранение неполадок
При настройке расширения MAUI для .NET для Visual Studio Code могут возникнуть проблемы. Чтобы просмотреть сведения об ошибках, связанных с расширением, перейдите в окно вывода (CTRL/CMD + SHIFT+u ) и выберите .NET MAUI в раскрывающемся списке. Ознакомьтесь с приведенными ниже разделами, которые помогут устранить проблему. Если вы по-прежнему сталкиваетесь с проблемами после выполнения действий по устранению неполадок, сообщите о проблеме.
Создание проекта
Если вы пытаетесь создать проект и проводник продолжает всплывать в бесконечном цикле, возможно, вы не выберете пустую папку. Убедитесь, что нет скрытых файлов или папок, создайте новую папку или создайте приложение .NET MAUI из командной строки dotnet new maui.
Использование целевого объекта InstallAndroidDependencies
.NET 9 имеет целевой объект сборки, который помогает настроить среду Android для вас. Выполните следующую команду в терминале, чтобы настроить компьютер и настроить среду Android:
dotnet build -t:InstallAndroidDependencies -f:net9.0-android -p:AndroidSdkDirectory="<AndroidSdkPath>" -p:JavaSdkDirectory="<JavaSdkPath>" -p:AcceptAndroidSDKLicenses=True
В приведенной выше команде:
AndroidSdkDirectory="<AndroidSdkPath>": устанавливает или обновляет зависимости Android на указанный абсолютный путь.
- Windows: предлагаемый AndroidSdkPath .
%LOCALAPPDATA%/Android/Sdk
- macOS: предлагаемый AndroidSdkPath
$HOME/Library/Android/sdk.
JavaSdkDirectory="<JavaSdkPath>": устанавливает Java на указанный абсолютный путь.AcceptAndroidSDKLicenses=True: принимает необходимые лицензии Android для разработки.
Возникла ошибка, когда пакет SDK для Android или пакет SDK для Java не найден
- Откройте палитру команд (CTRL/CMD+ SHIFT+P) и выполните поиск команды
.NET MAUI: Configure Android . Выберите "Задать путь к пакету SDK для Android" и "Задать путь JDK для Android" и убедитесь, что они указывают на установки каждого из них.
- В папке пакета SDK для Android должны быть вложенные папки, такие как
build-tools, cmdline-toolsи platform-tools.
- В папке Java OpenJDK должны быть вложенные папки, такие как
bin, libи многое другое.
- В Windows, если установить с помощью Visual Studio, пакет SDK Java будет находиться в
C:\Program Files\Microsoft\ C:\Program Files (x86)\Android\android-sdkпакете SDK для Android.
- Задайте для переменной
JAVA_HOME среды допустимый путь Java OpenJDK.
- Задайте для переменной
ANDROID_HOME среды путь пакета SDK для Android.
- Проверьте минимальные версии установленных зависимостей Android:
- build-tools >= 34.0.0
- cmdline-tools == 11.0
- Платформ; android-34*
- .NET 9: platform-tools = 34.0.5
Существует ошибка, в которую не принимаются лицензии Android
В командной строке с повышенными привилегиями или терминале перейдите в папку пакета SDK cmdline-tools/latest/bin/ для Android, а затем следуйте sdkmanager --licenses инструкциям интерфейса командной строки.
Мои зависимости Android не загружаются в Обозреватель решений, но мое приложение выполняет сборку хорошо.
Эта известная проблема, если вы устанавливаете в %APPDATA% Windows и будете исправлены в будущем выпуске.
Настройка iOS/Xcode
- Если вы получите ошибку, которую Xcode не найден, запустите
xcode-select --install в терминале, проверьте, xcode-select -p что указывает на установку Xcode.
- Если проблемы по-прежнему возникают, откройте Xcode, чтобы убедиться, что она загружается правильно. После открытия Xcode перейдите к расположению параметров > Xcode > и убедитесь, что поле "Инструменты командной строки" указывает на правильный Xcode.
- Существует известная проблема, которая иногда требуется создать приложение iOS/macOS дважды для его развертывания. Эта ошибка будет устранена в следующем выпуске.
Проблемы при отладке
- Отладка может завершиться сбоем по нескольким причинам. Если в окне вывода нет ясной ошибки, сначала дважды проверьте, используется ли конфигурация запуска C# в Visual Studio Code.
- Если вы используете старую версию .NET, отладчик C# не поддерживается для приложений .NET MAUI. Вы можете использовать устаревшую конфигурацию отладки .NET MAUI, снимите флажок параметра расширения MAUI > Configuration > Experimental > Use VSDbg.
- Вы можете попробовать сборку командной строки из терминала, чтобы узнать, связана ли ошибка с кодом или расширением MAUI .NET. Например, можно запустить
dotnet build -f:net9.0-android , чтобы узнать, успешно ли выполнена сборка Android за пределами Visual Studio Code. Если эта сборка выполнена успешно, сообщите о проблеме
Известные ограничения
- В настоящее время вы не можете переключить целевую платформу для IntelliSense (она будет отображать выделение синтаксиса только для первой целевой платформы, указанной в файле CSPROJ). Эта возможность выполняется. Чтобы получить выделение синтаксиса для других целевых объектов (например, Android вместо iOS), можно изменить порядок целевых платформ в файле проекта.
- В настоящее время Горячая перезагрузка .NET находится в предварительной версии в пакете разработки C#.
Дайте нам отзыв о других функциях, которые вы хотите увидеть, как мы продолжаем создавать этот новый интерфейс!
Предоставление отзыва
Ознакомьтесь с часто задаваемыми вопросами о комплекте разработки C# и проверьте существующие известные проблемы перед отправкой новой проблемы или предложения. С помощью диалогового окна "Проблема отчета справки>" можно отправить предложения и проблемы из Visual Studio Code. Убедитесь, что в раскрывающемся списке выбрано расширение .NET MAUI.
