Saltar a contenido

Tutorial 0 - ¡Preparémonos!

Antes de crear nuestra primera aplicación BeeWare, tenemos que asegurarnos de que tenemos todos los requisitos previos para ejecutar BeeWare.

Instalar Python

Lo primero que necesitaremos es un intérprete de Python que funcione.

Si usas Windows, puedes obtener el instalador oficial desde La página web de Python. Puedes usar cualquier versión estable de Python desde la 3.9 a la 3.12 - Python 3.13 no es compatible por el momento. Te aconsejamos que evites las versiones alphas, betas y release candidates a menos que realmente sepas lo que estás haciendo.

Hay muchas formas diferentes de instalar Python. Puedes instalar Python a través de homebrew. Puedes usar pyenv para gestionar múltiples instalaciones de Python en la misma máquina. Los usuarios de Windows pueden instalar Python desde la Windows App Store. Los usuarios con experiencia en ciencia de datos pueden utilizar Anaconda o Miniconda.

Xcode y las herramientas de desarrollo de línea de comandos proporcionan una versión de Python; sin embargo, esa Python es la versión 3.9. Python 3.9 ha llegado al final de su vida útil, y ya no está soportado por Python o BeeWare. Usted no será capaz de utilizar la versión de Python proporcionada por Xcode para ejecutar este tutorial.

Para comprobar la versión de Python que tiene instalada, ejecute el siguiente comando:

$ python3 --version

Si Python está instalado, verás su número de versión.

Si estás en Linux, instalarás Python utilizando el gestor de paquetes del sistema (apt en Debian/Ubuntu/Mint, dnf en Fedora, o pacman en Arch).

Debe asegurarse de que el sistema Python es Python 3.9 o más reciente; si no lo es (por ejemplo, Ubuntu 20.04 viene con Python 3.8), tendrá que actualizar su distribución de Linux a algo más reciente.

La compatibilidad con Raspberry Pi es limitada por el momento.

Importante: Debe utilizar el sistema Python proporcionado por su sistema operativo. Las instalaciones de Python procedentes de otras fuentes (como uv, pyenv, Anaconda, Python compilado manualmente, etc.) le impedirán empaquetar correctamente su aplicación para su distribución en los pasos posteriores de este tutorial.

Si usas Windows, puedes obtener el instalador oficial desde La página web de Python. Puedes usar cualquier versión estable de Python desde la 3.9 a la 3.12 - Python 3.13 no es compatible por el momento. Te aconsejamos que evites las versiones alphas, betas y release candidates a menos que realmente sepas lo que estás haciendo.

La compatibilidad con Raspberry Pi es limitada por el momento.

Si usas macOS o Windows, no importa cómo has instalado Python - sólo importa que puedas ejecutar python3 desde el símbolo del sistema/terminal de tu sistema operativo, y obtener un intérprete de Python que funcione.

Instalar dependencias

A continuación, instale las dependencias adicionales necesarias para su sistema operativo:

Construir aplicaciones BeeWare en macOS requiere:

  • Git, un sistema de control de versiones. Se incluye con Xcode o con las herramientas de línea de comandos para desarrolladores, que instalaste más arriba. Puede que tengas que abrir Xcode por primera vez para que Git funcione en tu sesión de terminal. Si aún no se registra que Git está instalado, puede que tenga que reiniciar su sesión de terminal.

Para soportar el desarrollo local, necesitarás instalar algunos paquetes del sistema. La lista de paquetes necesarios varía en función de tu distribución:

Ubuntu / Debian

$ sudo apt update
$ sudo apt install git build-essential pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev gir1.2-gtk-3.0 libcanberra-gtk3-module

Red Hat / Fedora

$ sudo dnf install git gcc make pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel gtk3 libcanberra-gtk3

Arch / Manjaro

$ sudo pacman -Syu git base-devel pkgconf python3 gobject-introspection cairo gtk3 libcanberra

OpenSUSE Tumbleweed

$ sudo zypper install git patterns-devel-base-devel_basis pkgconf-pkg-config python3-devel gobject-introspection-devel cairo-devel gtk3 'typelib(Gtk)=3.0' libcanberra-gtk3-module

Otras distribuciones de Linux

Si utilizas una distribución de Linux que no aparece en esta lista y que no deriva de ninguna de las que aparecen en ella (por ejemplo, Linux Mint y Pop! OS son distribuciones derivadas de Debian; AlmaLinux deriva de Fedora), probablemente tendrás dificultades para completar este tutorial. Si Briefcase te avisa de que «No se pueden verificar los paquetes del sistema», no podrás completar este tutorial.

Construir aplicaciones BeeWare en Windows requiere:

  • Git, un sistema de control de versiones. Puede descargar Git desde [git-scm.com].

Después de instalar estas herramientas, debe asegurarse de reiniciar cualquier sesión de terminal. Windows sólo expondrá las herramientas recién instaladas a los terminales iniciados después de que se haya completado la instalación.

Crear un entorno virtual

Ahora vamos a crear un entorno virtual - una "caja de arena" que podemos utilizar para aislar nuestro trabajo en este tutorial de nuestra instalación principal de Python. Si instalamos paquetes en el entorno virtual, nuestra instalación principal de Python (y cualquier otro proyecto Python en nuestro ordenador) no se verá afectado. Si hacemos un completo desastre de nuestro entorno virtual, podremos simplemente borrarlo y empezar de nuevo, sin afectar a ningún otro proyecto Python en nuestro ordenador, y sin necesidad de reinstalar Python.

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

C:\...>md beeware-tutorial
C:\...>cd beeware-tutorial
C:\...>py -3.12 -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate

Si no estás usando Python 3.12, sustituye el -3.12 de estas instrucciones por el número de versión que estés usando.

Errores al ejecutar scripts PowerShell

Si está utilizando PowerShell y recibe el error:

File C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system.

Su cuenta de Windows no tiene permiso para ejecutar scripts. Para solucionarlo:

  1. Ejecute Windows PowerShell como administrador.
  2. Ejecuta set-executionpolicy RemoteSigned
  3. Seleccione Y para cambiar la política de ejecución.

Una vez hecho esto, puede volver a ejecutar beeware-venv\Scripts\activate.ps1 en su sesión PowerShell original (o en una nueva sesión en el mismo directorio).

Si esto ha funcionado, tu prompt debería haber cambiado - debería tener un prefijo (beeware-venv). Esto te permite saber que estás actualmente en tu entorno virtual BeeWare. Siempre que estés trabajando en este tutorial, debes asegurarte de que tu entorno virtual está activado. Si no lo está, vuelve a ejecutar el último comando (el comando activate) para reactivar tu entorno.

Entornos virtuales alternativos

Si usas Anaconda o miniconda, puede que estés más familiarizado con el uso de entornos conda. También puede que hayas oído hablar de virtualenv, un predecesor del módulo venv de Python. Al igual que con las instalaciones de Python -si estás en macOS o Windows, no importa cómo creas tu entorno virtual, siempre y cuando tengas uno. Si estás en Linux, deberías usar venv y el sistema Python.

Siguientes pasos

Ya hemos configurado nuestro entorno. Estamos listos para crear nuestra primera aplicación BeeWare.