Vai al contenuto

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 Windows, è possibile ottenere il programma di installazione ufficiale dal sito web di Python. È 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.

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.

Xcode e gli strumenti per sviluppatori a riga di comando forniscono una versione di Python, ma si tratta della versione 3.9. Python 3.9 ha raggiunto la fine del ciclo di vita e non è più supportato da Python o da BeeWare. Non sarà possibile utilizzare la versione di Python fornita da Xcode per eseguire questa esercitazione.

Per verificare la versione di Python installata, eseguire il seguente comando:

$ python3 --version

Se Python è installato, si vedrà il suo numero di versione.

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.

Importante: è necessario utilizzare il sistema Python fornito dal proprio sistema operativo. L'installazione di Python da altre fonti (come uv, pyenv, Anaconda, Python compilato manualmente, ecc.) impedirà di creare correttamente il pacchetto dell'applicazione per la distribuzione nelle fasi successive di questo tutorial.

Se si utilizza Windows, è possibile ottenere il programma di installazione ufficiale dal sito web di Python. È 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.

Il supporto per Raspberry Pi è al momento limitato.

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]{3} o [Miniconda]{4}.

Installare le dipendenze

Successivamente, installate le dipendenze aggiuntive necessarie per il vostro sistema operativo:

La creazione di applicazioni BeeWare su macOS richiede:

  • Git, un sistema di controllo delle versioni. È incluso in Xcode o negli strumenti per sviluppatori a riga di comando, installati in precedenza. Potrebbe essere necessario aprire Xcode per la prima volta affinché Git funzioni nella sessione del terminale. Se ancora non viene registrato che Git è installato, potrebbe essere necessario riavviare la sessione del terminale.

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

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

Altre distribuzioni Linux

Se utilizzi una distribuzione Linux che non è presente in questo elenco e che non deriva da una delle distribuzioni presenti nell'elenco (ad esempio, Linux Mint e Pop! OS sono entrambe distribuzioni derivate da Debian; AlmaLinux è derivata da Fedora), potresti avere difficoltà a completare questo tutorial. Se Briefcase ti avvisa che "Impossibile verificare i pacchetti di sistema", non potrai completare questo tutorial.

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

Se non si utilizza Python 3.12, sostituire `-3.12' in queste istruzioni con il numero della versione in uso.

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 l'autorizzazione a eseguire gli script. Per risolvere il problema:

  1. Eseguire Windows PowerShell come amministratore.
  2. Eseguire set-executionpolicy RemoteSigned
  3. 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 di Python. Come per le installazioni di Python, se siete su macOS o Windows, non importa come create il vostro ambiente virtuale, basta che ne abbiate uno. Se siete su Linux, dovreste limitarvi a venv e al Python di sistema.

Prossimi passi

Ora abbiamo configurato il nostro ambiente. Siamo pronti a creare la nostra prima applicazione BeeWare.