Esercitazione 0 - Configuriamoci!¶
Prima di creare la nostra prima applicazione BeeWare, dobbiamo assicurarci di avere tutti i prerequisiti per l’esecuzione di BeeWare.
Installare Python¶
La prima cosa di cui abbiamo bisogno è un interprete Python funzionante.
Se si utilizza macOS, una versione recente di Python è inclusa in Xcode o negli strumenti di sviluppo a riga di comando. Per verificare se ne disponete già, eseguite il seguente comando:
$ python3 --version
Se Python è installato, verrà visualizzato il suo numero di versione. In caso contrario, verrà richiesto di installare gli strumenti di sviluppo a riga di comando.
Se si utilizza Windows, è possibile ottenere il programma di installazione ufficiale dal sito web di Python <https://www.python.org/downloads>`_. È possibile utilizzare qualsiasi versione stabile di Python dalla 3.8 in poi. Si consiglia di evitare le alpha, le beta e le release candidate a meno che non si sappia veramente cosa si sta facendo.
Se siete su Linux, installerete Python usando il gestore di pacchetti del sistema (apt
su Debian/Ubuntu/Mint, dnf
su Fedora, o pacman
su Arch).
Dovete assicurarvi che il sistema Python sia Python 3.8 o più recente; se non lo è (ad esempio, Ubuntu 18.04 viene fornito con Python 3.6), dovrete aggiornare la vostra distribuzione Linux con qualcosa di più recente.
Il supporto per Raspberry Pi è al momento limitato.
Se si utilizza Windows, è possibile ottenere il programma di installazione ufficiale dal sito web di Python <https://www.python.org/downloads>`_. È possibile utilizzare qualsiasi versione stabile di Python dalla 3.8 in poi. Si consiglia di evitare le alpha, le beta e le release candidate a meno che non si sappia veramente cosa si sta facendo.
Distribuzioni Python alternative
Esistono molti modi diversi per installare Python. Si può installare Python tramite homebrew. Si può usare pyenv per gestire più installazioni di Python sulla stessa macchina. Gli utenti di Windows possono installare Python dal Windows App Store. Gli utenti con un background di scienza dei dati potrebbero voler usare Anaconda o Miniconda.
Se siete su macOS o Windows, non importa come avete installato Python: importa solo che possiate eseguire python3
dal prompt dei comandi/terminale del vostro sistema operativo e ottenere un interprete Python funzionante.
Se utilizzate Linux, dovreste usare il Python di sistema fornito dal vostro sistema operativo. Sarete in grado di completare la maggior parte di questo tutorial utilizzando un Python non di sistema, ma non sarete in grado di pacchettizzare la vostra applicazione per distribuirla ad altri.
Installare le dipendenze¶
Successivamente, installate le dipendenze aggiuntive necessarie per il vostro sistema operativo:
La creazione di applicazioni BeeWare su macOS richiede:
Git, a version control system. This is included with Xcode or the command line developer tools, which you installed above. You may need to open Xcode for the first time in order for Git to work in your terminal session. If it still doesn’t register that Git is installed, you may need to restart your terminal session.
Per supportare lo sviluppo locale, è necessario installare alcuni pacchetti di sistema. L’elenco dei pacchetti necessari varia a seconda della distribuzione:
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
La creazione di applicazioni BeeWare su Windows richiede:
Git, un sistema di controllo delle versioni. È possibile scaricare Git da git-scm.com.
Dopo l’installazione di questi strumenti, è necessario assicurarsi di riavviare tutte le sessioni di terminale. Windows esporrà i terminali degli strumenti appena installati solo dopo il completamento dell’installazione.
Impostare un ambiente virtuale¶
Ora creeremo un ambiente virtuale, una «sandbox» che potremo usare per isolare il nostro lavoro su questo tutorial dalla nostra installazione principale di Python. Se installiamo dei pacchetti nell’ambiente virtuale, la nostra installazione principale di Python (e qualsiasi altro progetto Python sul nostro computer) non ne risentirà. Se facciamo un pasticcio completo nel nostro ambiente virtuale, potremo semplicemente cancellarlo e ricominciare da capo, senza influenzare nessun altro progetto Python sul nostro computer e senza la necessità di reinstallare 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
If you’re not using Python 3.12, replace the -3.12
in these instructions with
the version number that you are using.
Errori nell’esecuzione degli script PowerShell
Se si utilizza PowerShell e si riceve l’errore:
File C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system.
L’account di Windows non ha i permessi per eseguire gli script. Per risolvere il problema:
Eseguire
set-executionpolicy RemoteSigned
Selezionare
Y
per modificare il criterio di esecuzione.
Una volta fatto questo, si può rieseguire beeware-venv\Scripts\activate.ps1
nella sessione PowerShell originale (o in una nuova sessione nella stessa directory).
Se questo ha funzionato, il prompt dovrebbe essere cambiato: dovrebbe avere il prefisso (beeware-venv)
. Questo permette di sapere che ci si trova nell’ambiente virtuale BeeWare. Ogni volta che si lavora a questo tutorial, bisogna assicurarsi che l’ambiente virtuale sia attivato. In caso contrario, eseguire nuovamente l’ultimo comando (il comando activate
) per riattivare l’ambiente.
Ambienti virtuali alternativi
Se si usa Anaconda o miniconda, forse si ha più familiarità con l’uso degli ambienti conda. Potreste anche aver sentito parlare di virtualenv
, un predecessore del modulo venv
integrato in Python. Come per le installazioni di Python, se siete su macOS o Windows, non importa come create il vostro ambiente virtuale, purché ne abbiate uno. Se siete su Linux, dovreste usare venv
e il Python di sistema.
Prossimi passi¶
Ora abbiamo configurato il nostro ambiente. Siamo pronti a creare la nostra prima applicazione BeeWare.