Создание приложения iOS с помощью .NET CLI

  • Статья

В этом руководстве вы узнаете, как создать и запустить приложение многоплатформенного пользовательского интерфейса приложений .NET (.NET MAUI) в iOS с помощью интерфейса командной строки .NET (CLI) в macOS:

  1. Чтобы создать приложения .NET MAUI, необходимо скачать и запустить установщик для последней среды выполнения .NET. Вам также потребуется скачать и установить версию Xcode, необходимую для используемой версии .NET MAUI. Дополнительные сведения см. в разделе "Версии выпуска".

  2. На компьютере Mac откройте терминал и проверка, установленные в последней версии среды выполнения .NET:

    dotnet --version

  3. В терминале установите последнюю общедоступную сборку .NET MAUI:

    sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json

    Эта команда установит последнюю выпущенную версию .NET MAUI, включая необходимые пакеты SDK платформы.

  4. В терминале создайте новое приложение MAUI .NET с помощью .NET CLI:

    dotnet new maui -n "MyMauiApp"

  1. В терминале измените каталог на MyMauiApp и создайте и запустите приложение:

    cd MyMauiApp
dotnet build -t:Run -f net8.0-ios

    Команда dotnet build восстановит проект зависимостей, создаст приложение и запустит его в симуляторе по умолчанию.

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

    Приложение .NET MAUI, работающее в симуляторе iOS по умолчанию.

Сборка с определенной версией Xcode

Если на Компьютере Mac установлено несколько версий Xcode, можно указать, какую версию Xcode следует использовать при создании приложения. Существует ряд подходов, которые можно использовать для этого, но рекомендуемый подход заключается в том, чтобы задать MD_APPLE_SDK_ROOT переменную среды в путь версии Xcode.

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

Использование xcode-select -s для задания используемой версии Xcode не рекомендуется.

Чтобы задать MD_APPLE_SDK_ROOT переменную среды в течение текущего сеанса терминала:

  1. Откройте приложение терминала.

  2. Введите следующую команду, подстановку в версию Xcode и нажмите клавишу ВВОД:

    export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app

Если вы хотите постоянно задать эту переменную среды, можно добавить export команду в профиль оболочки, например Zprofile.

Запуск приложения на определенном симуляторе

Приложение .NET MAUI iOS можно запустить на определенном симуляторе iOS из Mac, предоставив свой уникальный идентификатор устройства (UDID):

  1. На компьютере Mac откройте Xcode, выберите пункт меню "Устройства и симуляторы Windows>", а затем вкладку "Симуляторы".

    Снимок экрана: вкладка

  2. Щелкните правой кнопкой мыши выбранный симулятор и выберите "Копировать идентификатор ", чтобы скопировать идентификатор UDID в буфер обмена.

    Снимок экрана: параметр меню идентификатора копирования в Xcode.

    Кроме того, можно получить список значений UDID, выполнив simctl list команду:

    /Applications/Xcode.app/Contents/Developer/usr/bin/simctl list

  1. В терминале создайте приложение и запустите его на выбранном-p симуляторе, указав _DeviceName свойство MSBuild с помощью параметра MSBuild:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=MY_SPECIFIC_UDID

    Например, используйте следующую команду, чтобы создать приложение и запустить его на симуляторе i Телефон 13 Pro:

    dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=E25BBE37-69BA-4720-B6FD-D54C97791E79

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

    Приложение .NET MAUI, работающее в симуляторе i Телефон 13 Pro.

Запуск приложения на устройстве

Прежде чем развернуть приложение iOS, необходимо подготовить устройство. Дополнительные сведения см. в разделе "Подготовка устройств для iOS". После подготовки устройства приложение .NET MAUI iOS можно запустить на устройстве с Mac, предоставив его уникальный идентификатор устройства (UDID):

  1. Подключение устройство на локальном Компьютере Mac с USB-кабелем.

  2. Откройте Xcode и перейдите к устройствам и симуляторам окон>.

  3. В Xcode перейдите на вкладку "Устройства" и выберите устройство из списка подключенных устройств.

  4. В Xcode скопируйте значение идентификатора в буфер обмена:

    Окно устройств и симуляторов Xcode с выделенным расположением строки идентификатора iOS.

    Кроме того, щелкните правой кнопкой мыши устройство и выберите "Копировать идентификатор ", чтобы скопировать идентификатор UDID в буфер обмена.

  1. В терминале создайте приложение и запустите его на выбранном-p симуляторе, указав _DeviceName свойство MSBuild с помощью параметра MSBuild:

    dotnet build -t:Run -f net8.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UDID

    Замените "MY_SPECIFIC_UDID" идентификатором устройства, скопированным в буфер обмена.