Compilación de una aplicación de iOS con la CLI de .NET

En este tutorial, aprenderá a crear y ejecutar una aplicación de interfaz de usuario de aplicaciones multiplataforma de .NET (.NET MAUI) en iOS mediante la interfaz de línea de comandos (CLI) de .NET en macOS:

1. Para crear aplicaciones .NET MAUI, deberá descargar y ejecutar el instalador para el entorno de ejecución de .NET más reciente. También deberá descargar e instalar la versión de Xcode que requiere la versión de .NET MAUI que está usando. Para obtener información, consulte Versiones de lanzamiento.

2. En el equipo Mac, abra Terminal y compruebe que tiene instalado el entorno de ejecución de .NET más reciente:

   dotnet --version
   

3. En Terminal, instale la compilación pública más reciente de .NET MAUI:

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

   Este comando instalará la versión más reciente publicada de .NET MAUI, incluidos los SDK de plataforma necesarios.

4. En Terminal, cree una nueva aplicación .NET MAUI mediante la CLI de .NET:

   dotnet new maui -n "MyMauiApp"
   

5. En Terminal, cambie el directorio a MyMauiApp y compile y ejecute la aplicación:

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

   El dotnet build comando restaurará el proyecto las dependencias, compilará la aplicación e iniciarála en el simulador predeterminado.

6. En el simulador predeterminado, haga clic en el botón Hacer clic varias veces y observe que se incrementa el recuento de clics.

   

Compilación con una versión específica de Xcode

Si tiene varias versiones de Xcode instaladas en el equipo Mac, es posible especificar qué versión de Xcode se debe usar al compilar la aplicación. Hay una serie de enfoques que se pueden usar para lograr esto, pero hay dos enfoques recomendados:

1. Use sudo xcode-select --switch ... para elegir la versión seleccionada actualmente del sistema de Xcode (esto requiere credenciales de administrador). También es posible hacerlo desde dentro de Xcode (Configuración - Ubicaciones ->> Herramientas de línea de comandos).

2. Use la DEVELOPER_DIR variable de entorno durante la sesión de terminal actual:

   1. Abra la aplicación Terminal .

   2. Escriba el siguiente comando, sustituyendo su versión de Xcode, y presione Enter:

      export DEVELOPER_DIR=/Applications/Xcode_14.1.0.app
      

   Si desea establecer esta variable de entorno de forma permanente, puede agregar el export comando al perfil de shell, como .zprofile.

Inicio de la aplicación en un simulador específico

Una aplicación .NET MAUI iOS se puede iniciar en un simulador de iOS específico desde un equipo Mac proporcionando su identificador de dispositivo único (UDID):

1. En el equipo Mac, abra Xcode, seleccione el elemento de menú Dispositivos y simuladores de Windows > y, a continuación, la pestaña Simuladores.

   

2. Haga clic con el botón derecho en el simulador elegido y seleccione Copiar identificador para copiar el UDID en el Portapapeles.

   

   Como alternativa, puede recuperar una lista de valores UDID ejecutando el simctl list comando :

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

3. En Terminal, compile la aplicación y ejecútela en el simulador elegido especificando la _DeviceName propiedad MSBuild mediante la -popción MSBuild:

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

   Por ejemplo, use el siguiente comando para compilar la aplicación y ejecutarla en el simulador de iPhone 13 Pro:

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

4. En el simulador elegido, presione el botón Haz clic en mí varias veces y observe que se incrementa el recuento de clics.

   

Inicio de la aplicación en un dispositivo

Se debe aprovisionar un dispositivo para poder implementar una aplicación de iOS en él. Para más información, consulta Aprovisionamiento de dispositivos para iOS. Una vez que se ha aprovisionado un dispositivo, se puede iniciar una aplicación de .NET MAUI iOS en el dispositivo desde un equipo Mac proporcionando su identificador de dispositivo único (UDID):

1. Conecte el dispositivo al equipo Mac local con un cable USB.

2. Abra Xcode y vaya a Dispositivos y simuladores de ventana>.

3. En Xcode, seleccione la pestaña Dispositivos y seleccione el dispositivo en la lista de dispositivos conectados.

4. En Xcode, copie el valor identificador en el Portapapeles:

   

   Como alternativa, haga clic con el botón derecho en el dispositivo y seleccione Copiar identificador para copiar el UDID en el Portapapeles.

5. En Terminal, compile la aplicación y ejecútela en el dispositivo elegido especificando la _DeviceName propiedad MSBuild mediante la -popción MSBuild:

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

   Reemplace "MY_SPECIFIC_UDID" por el identificador de dispositivo que copió en el Portapapeles.