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 utilizas macOS, con Xcode o las herramientas de desarrollo de línea de comandos se incluye una versión reciente de Python. Para comprobar si ya la tienes, ejecuta el siguiente comando:
$ python3 --version
Si Python está instalado, verás su número de versión. Si no, se te pedirá que instales las herramientas de desarrollo de la línea de comandos.
Si estás en Windows, puedes obtener el instalador oficial desde the Python website. Puedes usar cualquier versión estable de Python desde la 3.8 en adelante. Te aconsejamos que evites las versiones alphas, betas y release candidates a menos que realmente sepas lo que estás haciendo.
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.8 o más reciente; si no lo es (por ejemplo, Ubuntu 18.04 viene con Python 3.6), tendrá que actualizar su distribución de Linux a algo más reciente.
La compatibilidad con Raspberry Pi es limitada por el momento.
Si estás en Windows, puedes obtener el instalador oficial desde the Python website. Puedes usar cualquier versión estable de Python desde la 3.8 en adelante. Te aconsejamos que evites las versiones alphas, betas y release candidates a menos que realmente sepas lo que estás haciendo.
Distribuciones alternativas de Python
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.
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.
Si usas Linux, deberías usar el Python de sistema proporcionado por tu sistema operativo. Podrás completar la mayor parte de este tutorial usando un Python que no sea de sistema, pero no podrás empaquetar tu aplicación para distribuirla a otros.
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. Esto se incluye con Xcode o las herramientas de línea de comandos para desarrolladores, que instaló anteriormente.
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 20.04+ / Debian 10+
$ 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
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
Construir aplicaciones BeeWare en Windows requiere:
Git, un sistema de control de versiones. Puede descargar Git desde git-scm.org.
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 -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate
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.
Tu cuenta de Windows no tiene permisos para ejecutar scripts. Para solucionarlo:
Ejecute Windows PowerShell como Administrador.
Ejecuta
set-executionpolicy RemoteSigned
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 estás usando Anaconda o miniconda, puede que estés más familiarizado con el uso de entornos conda. También puedes haber 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.