Saltar a contenido

Tutorial 0 - ¡Vamos a instalarlo!

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 están en los macOS, puedes obtener un instalador oficial de Python desde el sitio web de Python. Puedes usar cualquier versión de Python desde la 3.10 o más nueva (aunque evitaría los candidatos alfa, beta y candidatos de lanzamiento). Recomendamos fuertemente utilizar Python 3.13 o más nuevo.

Hay muchas formas diferentes de instalar Python por medio de Homebrew, utiliza pyenv para gestionar múltiples instalaciones de Python, o utiliza Anaconda o Miniconda. No importa como has instalado Python; solo importa que puedas ejecutar python3 desde tu terminal y obtener un intérprete de Python mantenido en funcionamiento.

Xcode y las Herramientas de Desarrollo en 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á mantenido por Python o BeeWare. No serás 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 la versión de Python del sistema sea Python 3.10 o posterior; si no lo es (p.ej., Ubuntu 20.04 viene con Python 3.8), necesitarás actualizar tu distribución de Linux a una versión 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.10 a la 3.13 (sin embargo evitaría las alfa, beta y candidatos a lanzamiento). Te recomendamos que utilices Python 3.13.

La asistencia para Windows en ARM64 está limitada en este momento.

También puedes instalar Python desde al Windows App Store, o utilizar Anaconda o Miniconda. No importa cómo has instalado Python: sólo importa que puedas ejecutar python3 desde el intérprete de comando 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 este listado y que no deriva de ninguna de las que aparecen en ella (p.ej., Linux Mint y Pop! OS son distribuciones derivadas de Debian; AlmaLinux derivada de Fedora), probablemente tendrás dificultades para completar este tutorial. Si Portafolio te avisa de que «No puede verificar los paquetes del sistema», no podrás completar este tutorial.

Construir aplicaciones BeeWare en Windows requiere:

  • Git, un sistema de control de versiones. Puedes 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 los script de PowerShell

Si está utilizando PowerShell y recibe el error:

No se puede cargar el archivo C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 porque la ejecución de scripts está desactivada en este sistema.

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

  1. Ejecute Windows PowerShell como administrador.
  2. Ejecute 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 preparados para crear nuestra primera aplicación BeeWare.