Tutorial 5 - Para móviles: iOS¶

Para compilar aplicaciones para iOS, necesitamos Xcode, que se encuentra disponible de forma gratuita desde la App Store de macOS. Una vez que Xcode esté instalado, ábrelo desde la carpeta Aplicaciones y acepta el Acuerdo de Licencia de Xcode. A continuación, Xcode mostrará los entornos de simulador que ya vienen integrados y aquellos que puedes descargar. Marca la casilla junto al entorno del simulador de iOS y luego pulsa en "Continuar" para descargarlo e instalarlo.

Una vez que tengamos Xcode y el simulador de iOS instalados, podemos tomar nuestra aplicación e implementarla como una aplicación de iOS.

El proceso de despliegue de una aplicación en iOS es muy similar al proceso de despliegue como aplicación de escritorio. En primer lugar, se ejecuta el comando create; pero esta vez, especificamos que queremos crear una aplicación iOS:

(beeware-venv) $ briefcase create iOS

[helloworld] Generando plantilla de aplicación...
Usando la plantilla de aplicación: https://github.com/beeware/briefcase-iOS-Xcode-template.git, rama v0.3.18
...

[helloworld] Instalando el paquete de soporte...
...

[helloworld] Instalando el código de la aplicación...
Instalando src/helloworld... hecho

[helloworld] Instalando requisitos...
...

[helloworld] Instalando recursos de la aplicación...
...

[helloworld] Eliminando contenido innecesario de la aplicación...
...

[helloworld] Creado build/helloworld/ios/xcode

Una vez que esto se complete, tendremos un directorio build/helloworld/ios/xcode que contiene un proyecto Xcode, así como las bibliotecas de soporte y el código de aplicación necesario para la aplicación.

Luego puedes usar Briefcase para compilar tu aplicación usando briefcase build iOS (compilar para iOS con Briefcase):

(beeware-venv) $ briefcase build iOS

[helloworld] Actualizando los metadatos de la aplicación...
Configurando el módulo principal... hecho

[helloworld] Compilando el proyecto de Xcode...
...
Compilando... hecho

[helloworld] Compilado en build/helloworld/ios/xcode/build/Debug-iphonesimulator/Hello World.app

Ya estamos listos para ejecutar nuestra aplicación, utilizando briefcase run iOS (ejecutar iOS con Briefcase). Se te pedirá que selecciones un dispositivo para el cual puedes compilar; si tienes instalados simuladores para varias versiones del SDK de iOS, puede que también se te pregunte a qué versión de iOS quieres apuntar. Las opciones que se le muestren pueden diferir de las que se muestran en esta salida; como mínimo, es probable que la lista de dispositivos sea diferente. Para fines prácticos, no importa qué simulador se elija.

(beeware-venv) $ briefcase run iOS

Selecciona el dispositivo del simulador:

   1) iPad (10.ª generación)
   2) iPad Air (5.ª generación)
   3) iPad Pro (11 pulgadas) (4.ª generación)
   4) iPad Pro (12,9 pulgadas) (6.ª generación)
   5) iPad mini (6.ª generación)
   6) iPhone 14
   7) iPhone 14 Plus
   8) iPhone 14 Pro
   9) iPhone 14 Pro Max
   10) iPhone SE (3.ª generación)

>  10

En el futuro, podrías especificar este dispositivo ejecutando:

 $ briefcase run iOS -d "iPhone SE (3.ª generación)::iOS 16.2"

o:

 $ briefcase run iOS -d 2614A2DD-574F-4C1F-9F1E-478F32DE282E

[helloworld] Iniciando la aplicación en un iPhone SE (3.ª generación) con iOS 16.2 (UDID del dispositivo 2614A2DD-574F-4C1F-9F1E-478F32DE282E)
Arranque del simulador... hecho
Apertura del simulador... hecho

[helloworld] Instalando la aplicación...
Desinstalando cualquier versión existente de la aplicación... hecho
Instalando nueva versión de la aplicación... hecho

[helloworld] Iniciando la aplicación...
Iniciando la aplicación... hecho

[helloworld] A continuación, el registro del simulador (pulsa CTRL-C para detener el registro)...
===========================================================================
...

Esto iniciará el simulador de iOS, instalará tu aplicación y la iniciará. Vas a observar cómo se inicia el simulador y cómo se abre tu aplicación iOS:

Ventana Tutorial Hola Mundo 5, en iOS

/// subtítulo

///

Mientras se ejecuta la aplicación, verás una serie de mensajes de salida del bitácora del simulador en la consola. Si escribes Ctrl+C en el terminal, se detendrán los mensajes en la consola, pero no se cerrará el simulador. Esto es para que puedas probar nuevos cambios sin reiniciar el simulador.

Si sabes de antemano a qué simulador iOS quieres dirigirte, puedes decirle a Briefcase que utilice ese simulador proporcionando una opción -d (o --device). Utilizando el nombre del dispositivo que seleccionaste cuando creaste tu aplicación, ejecuta:

$ briefcase run iOS -d "iPhone SE (3ª generación)"

Si tienes varias versiones de iOS disponibles, Briefcase elegirá la versión de iOS más alta; si quieres elegir una versión de iOS en particular, dile que utilice esa versión específica:

$ briefcase run iOS -d "iPhone SE (3ª generación)::iOS 15.5"

O bien, puede nombrar un UDID de dispositivo específico:

$ briefcase run iOS -d 2614A2DD-574F-4C1F-9F1E-478F32DE282E

Siguientes pasos¶

¡Ya tenemos una aplicación en nuestro teléfono! ¿Hay algún otro lugar donde podamos desplegar una aplicación BeeWare? Consulta el Tutorial 6 para averiguarlo…