Примечание.
Visual Studio для Mac планируется на пенсию к 31 августа 2024 г. в соответствии с Современная политика жизненного цикла Майкрософт. Visual Studio для Mac 17.6 будет поддерживаться до 31 августа 2024 г. с обновлениями обслуживания для проблем с безопасностью и обновленными платформами от Apple. Дополнительные сведения, включая альтернативные варианты разработки на компьютере Mac, см. в статье "Что происходит с Visual Studio для Mac?".
Чтобы начать разработку собственных кроссплатформенных приложений .NET MAUI в macOS, установите Visual Studio 2022 для Mac 17.6, выполнив действия по установке .
Необходимые компоненты
- Visual Studio 2022 для Mac 17.6. Сведения о поддерживаемых операционных системах, оборудовании, поддерживаемых языках и дополнительных требованиях и рекомендациях см. в разделе "Требования к системе Для Mac" в Visual Studio 2022.
Чтобы создавать, подписывать и развертывать приложения MAUI .NET для iOS или macOS, вам также потребуется:
- Компьютер Mac, совместимый с Xcode. Дополнительные сведения см. в документации по минимальным требованиям Apple.
- Определенная версия Xcode, которая зависит от используемой версии .NET MAUI. Дополнительные сведения см. в разделе "Версии выпуска".
- Идентификатор Apple и платная регистрация программы разработчика Apple. Идентификатор Apple ID необходим для развертывания приложений на устройствах и отправки приложений в Apple Store.
Установка
Чтобы создать приложения .NET MAUI, вам потребуется последняя Visual Studio для Mac:
Установите Visual Studio 2022 для Mac или измените существующую установку и убедитесь, что установлены следующие рабочие нагрузки:
- .NET
- .NET MAUI
- Android
- iOS
Внимание
Для новых установок Visual Studio 2022 для Mac выбор рабочей нагрузки .NET MAUI автоматически выбирает рабочие нагрузки Android и iOS, которые в настоящее время необходимы для разработки .NET MAUI.
Установите .NET 8 через автономный установщик.
После завершения установки .NET 8 запустите dotnet workload install maui терминал.
Внимание
Чтобы использовать Visual Studio для Mac с .NET 8, включите другие функции предварительной версии Visual Studio >>, используйте пакет SDK для .NET 8, если установлен (требуется перезапуск) проверка box.>>
Если при установке в корпоративной среде возникают проблемы с сетью, см. инструкции по установке за брандмауэром или прокси-сервером.
Установка за брандмауэром или прокси-сервером
Чтобы установить Visual Studio 2022 для Mac за брандмауэром, определенные конечные точки должны быть доступны, чтобы разрешить скачивание необходимых средств и обновлений программного обеспечения. Дополнительные сведения о настройке сети для разрешения доступа к необходимым конечным точкам см. в разделе "Установка и использование Visual Studio для Mac за брандмауэром или прокси-сервером".
Примечание.
Поддержка .NET MAUI в Visual Studio Code по-прежнему доступна в предварительной версии. Попробуйте и поделитесь своими отзывами!
Установка Visual Studio Code и расширения MAUI .NET
Установка 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 8.
В Windows рекомендуется использовать установщик Visual Studio для управления установками рабочих нагрузок .NET и .NET MAUI. Инструкции по использованию установщика Visual Studio см . здесь.
Установите рабочую нагрузку .NET MAUI.
В Windows и macOS выполните следующую команду в терминале:
dotnet workload install maui
В Linux выполните следующую команду в терминале:
dotnet workload install maui-android
Чтобы выполнить отладку приложения .NET MAUI в Visual Studio Code, необходимо иметь действительную целевую платформу для операционной системы компьютера разработки:
| Операционная система |
Поддерживаемые целевые платформы |
| Windows |
Windows, Android |
| macOS |
Android, iOS, macOS |
| Linux |
Android |
iOS и macOS
Чтобы выполнить отладку до целевого объекта iOS или macOS в Visual Studio Code:
- Установите версию Xcode, необходимую для используемой версии .NET MAUI. Дополнительные сведения см. в разделе "Версии выпуска". Последний стабильный выпуск Xcode можно скачать из Mac App Store.
- Запустите
xcode-select --install в терминале, чтобы получить средства командной строки 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 могут возникнуть проблемы. Если вы по-прежнему сталкиваетесь с проблемами после выполнения приведенных ниже действий по устранению неполадок, сообщите о проблеме.
Создание проекта
Если вы пытаетесь создать проект и проводник продолжает всплывать в бесконечном цикле, возможно, вы не выберете пустую папку. Убедитесь, что нет скрытых файлов или папок, создайте новую папку или создайте приложение .NET MAUI из командной строки dotnet new maui.
Использование целевого объекта InstallAndroidDependencies
.NET 8 имеет целевой объект сборки, который помогает настроить среду Android для вас. Выполните следующую команду в терминале, чтобы настроить компьютер и настроить среду Android:
dotnet build -t:InstallAndroidDependencies -f:net8.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 7: platform-tools = 33.0.2
- .NET 8: 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 дважды, чтобы развернуть его. Эта ошибка будет устранена в следующем выпуске.
Проблемы при отладке
- Отладка может завершиться сбоем по нескольким причинам. Если в окне вывода нет ясной ошибки, сначала дважды проверка, что вы используете конфигурацию запуска .NET MAUI в Visual Studio Code.
- Вы можете попробовать сборку командной строки из терминала, чтобы узнать, связана ли ошибка с кодом или расширением MAUI .NET. Например, можно запустить
dotnet build -f:net8.0-android , чтобы узнать, успешно ли выполнена сборка Android за пределами Visual Studio Code. Если эта сборка выполнена успешно, сообщите о проблеме
Известные ограничения
Это расширение по-прежнему находится в ранней предварительной версии, поэтому существует ряд известных ограничений. Дайте нам отзыв о других функциях, которые вы хотите увидеть, как мы продолжаем создавать этот новый интерфейс.
- Возможности редактирования XAML очень упрощены. Вы получаете базовое выделение синтаксиса и автозавершение. Мы изучаем, как улучшить интерфейс XAML в будущем выпуске.
- В настоящее время вы не можете переключить целевую платформу для IntelliSense (она будет отображать выделение синтаксиса только для первой целевой платформы, указанной в файле CSPROJ). Эта возможность выполняется.
- В настоящее время Горячая перезагрузка XAML и .NET не поддерживаются.
- Это расширение еще не было полностью протестировано с помощью последних бета-версий iOS и Xcode.
Дайте нам отзыв о других функциях, которые вы хотите увидеть, как мы продолжаем создавать этот новый интерфейс!
Отправить отзыв
Перед отправкой нового вопроса или предложения ознакомьтесь с часто задаваемыми вопросами по пакету разработки C# и проверка существующие известные проблемы. С помощью диалогового окна "Проблема отчета справки>" можно отправить предложения и проблемы из Visual Studio Code. Убедитесь, что в раскрывающемся списке выбрано расширение .NET MAUI.
