Tutorial 1 - Tu primera aplicación¶
Estamos listos para crear nuestra primera aplicación.
Instalar las herramientas BeeWare¶
En primer lugar, tenemos que instalar Briefcase. Briefcase es una
herramienta de BeeWare que se puede utilizar para empaquetar su aplicación para
la distribución a los usuarios finales — pero también se puede utilizar para
arrancar un proyecto nuevo. Asegúrate de que estás en el directorio
beeware-tutorial que creaste en Tutorial 0, con el entorno
virtual beeware-venv activado, y ejecuta:
(beeware-venv) $ python -m pip install briefcase
(beeware-venv) $ python -m pip install briefcase
Posibles errores durante la instalación
Si aparecen errores durante la instalación, es casi seguro que se deba a que no se han instalado algunos de los requisitos del sistema. Asegúrate de tener instalado todos los prerrequisitos de la plataforma.
(beeware-venv) C:\...>python -m pip install briefcase
Posibles errores durante la instalación
Es importante que utilices python -m pip, en lugar de pip. Briefcase
necesita asegurarse de que tiene una versión actualizada de pip y
setuptools, y una invocación de pip no puede auto-actualizarse. Si quieres
saber más, Brett Cannon tiene una entrada de blog detallada sobre la
incidencia.
Arrancar un proyecto nuevo¶
¡Empecemos nuestro primer proyecto BeeWare! Vamos a utilizar el comando new
del Portafolio para crear una aplicación llamada Hello World. Ejecuta lo
siguiente desde su intérprete del comando:
(beeware-venv) $ briefcase new
(beeware-venv) $ briefcase new
(beeware-venv) C:\...>briefcase new
El portafolio nos pedirá algunos detalles de nuestra aplicación nueva. Para los propósitos de este tutorial, utilice lo siguiente:
- Nombre Formal — Acepta el valor por defecto:
Hola Mundo. - Nombre de aplicación — Acepta el valor por defecto:
helloworld. - Paquete — Si tiene su propio dominio, introdúzcalo en orden inverso. (Por
ejemplo, si posee el dominio "cupcakes.com", introduzca
com.cupcakescomo paquete). Si no posee su propio dominio, acepte el paquete predeterminado (com.ejemplo). - Nombre del proyecto — Acepte el valor por defecto:
Hola Mundo. - Descripción — Acepte el valor por defecto (o, si quiere ser realmente creativo, invente su propia descripción)
- Autor — Introduzca aquí su propio nombre.
- Correo electrónico del autor — Introduzca su propia dirección de correo electrónico. Se utilizará en el archivo de configuración, en el texto de ayuda y en cualquier lugar donde se requiera un correo electrónico al enviar la aplicación a una tienda de aplicaciones.
- URL de aplicación — La URL de la página de destino para su aplicación. De
nuevo, si es dueño de su propio dominio, introduzca una URL en ese dominio
(incluyendo el
https://). En otro caso, tan solo acepta la URL por defecto (https://example.com/helloworld). No es necesario que esta URL exista realmente (por ahora); sólo será utilizada si publicas tu aplicación en una tienda de aplicaciones. - Licencia de Proyecto — Acepta la licencia por defecto (BSD). Sin embargo, esto no afectará en nada al funcionamiento del tutorial, así que si tienes sentimientos particularmente fuertes sobre la elección de la licencia, siéntete libre de elegir otra licencia.
- IGU de marco de trabajo — Acepte la opción por defecto, Toga (el propio conjunto de herramientas IGU de BeeWare).
Briefcase entonces generará un esqueleto de proyecto para que lo utilices. Si has seguido este tutorial hasta ahora, y has aceptado los valores por defecto tal y como se describen, tu sistema de archivos debería parecerse a:
beeware-tutorial/
├── beeware-venv/
│ └── ...
└── helloworld/
├── CHANGELOG
├── LICENSE
├── pyproject.toml
├── README.rst
├── src/
│ └── helloworld/
│ ├── app.py
│ ├── __init__.py
│ ├── __main__.py
│ └── resources/
│ └── README
└── tests/
├── helloworld.py
├── __init__.py
└── test_app.py
Este esqueleto es en realidad una aplicación completamente funcional sin
necesidad de añadir nada más. La carpeta src contiene todo el código de la
aplicación, la carpeta tests contiene un conjunto de pruebas iniciales, y el
archivo pyproject.toml describe cómo empaquetar la aplicación para su
distribución. Si abres pyproject.toml en un editor, verás los detalles de
configuración que acabas de proporcionar al Portafolio.
Ahora que tenemos un esbozo de aplicación, podemos utilizar Briefcase para ejecutar la aplicación.
Ejecute la aplicación en modo desarrollador¶
Entra en el directorio del proyecto helloworld y dile al portafolio que inicie
el proyecto en modo Desarrollador (o dev):
(beeware-venv) $ cd helloworld
(beeware-venv) $ briefcase dev
[helloworld] Activando el entorno de desarrollo...
...
Creando entorno virtual (dev.cpython-313-darwin)... hecho
[hello-world] Instalando requisitos...
...
[helloworld] Iniciando en modo dev...
===========================================================================
(beeware-venv) $ cd helloworld
(beeware-venv) $ briefcase dev
[helloworld] Activando el entorno de desarrollo...
...
Creando entorno virtual (dev.cpython-313-x86_64-linux-gnu)... hecho
[hello-world] Instalando requisitos...
...
[helloworld] Iniciando en modo dev...
===========================================================================
(beeware-venv) C:\...>cd helloworld
(beeware-venv) C:\...>briefcase dev
[helloworld] Activando el entorno de desarrollo...
...
Creando entorno virtual (dev.cp313-win_amd64)... hecho
[hello-world] Instalando requisitos...
...
[helloworld] Iniciando en modo dev...
===========================================================================
Esto debería abrir una ventana IGU:
Tutorial Hola Mundo 1 ventana, en macOS
/// subtítulo
///
/// subtítulo
Posibles errores al ejecutar briefcase dev
Si obtienes un error al ejecutar briefcase dev, es casi seguro que se debe a
que no se han instalado algunos de los requisitos del sistema. Asegúrate de
haber instalado todos los requisitos previos de la
plataforma; el mensaje de error que recibas debería
indicarte cuáles paquetes faltan.
///
/// subtítulo
Requisitos no válidos o pip incapaz de conectarse
Si se encuentra el error:
No se han podido instalar los requisitos. Esto puede deberse a que alguno de tus
requisitos no es válido o a que pip no ha podido conectarse
al servidor PyPI.
Confirme que está ejecutando una versión de python compatible con este tutorial.
Si tu versión de python no es una versión mantenida, tendrás que reiniciar el tutorial.
///
Cierre la aplicación — o bien presionando el botón cerrar en la ventana de
aplicación, seleccionando Salir desde el menú de aplicación, o bien tecleando
Ctrl+C en el terminal donce ejecutó briefcase dev — y está hecho!
Felicidades — ¡acabas de escribir una aplicación nativa e independiente en
Python!
Siguientes pasos¶
Ahora tenemos una aplicación que funciona, ejecutándose en modo desarrollador. Ahora podemos añadir algo de lógica propia para hacer que nuestra aplicación haga algo un poco más interesante. En el Tutorial 2, pondremos una interfaz de usuario más útil en nuestra aplicación.