Tutoriel 0 - Installons-nous !¶

Avant de créer notre première application BeeWare, nous devons nous assurer que nous disposons de tous les prérequis pour le fonctionnement de BeeWare.

Installer Python¶

La première chose dont nous avons besoin est un interpréteur Python fonctionnel.

macOSLinuxWindows

Si vous êtes sous macOS, vous pouvez obtenir l'installateur officiel à partir du site web de Python. Vous pouvez utiliser n'importe quelle version stable de Python à partir de la 3.10 (nous vous conseillons d'éviter les versions alpha, beta et release candidates). Nous recommandons fortement d'utiliser Python 3.13 ou plus récent.

Vous pouvez aussi installer Python via homebrew, utiliser pyenv pour gérer plusieurs installations de Python, ou utiliser Anaconda ou Miniconda. Peu importe comment vous avez installé Python - ce qui compte c'est que vous pouvez lancer python3 dans votre terminal pour obtenir un interpréteur Python supporté opérationnel.

Xcode et les outils de développement en ligne de commande fournissent une version de Python, mais cette version est la version 3.9. Python 3.9 est en fin de vie et n'est plus supporté par Python ou BeeWare. Vous ne pourrez pas utiliser la version de Python fournie par Xcode pour exécuter ce tutoriel.

Pour vérifier la version de Python que vous avez installée, exécutez la commande suivante :

$ python3 --version

Si Python est installé, vous verrez son numéro de version.

Si vous êtes sous Linux, vous installerez Python en utilisant le gestionnaire de paquets du système (apt sur Debian/Ubuntu/Mint, dnf sur Fedora, ou pacman sur Arch).

Vous devez vous assurer que le Python du système est Python 3.8 ou plus récent ; si ce n'est pas le cas (par exemple, Ubuntu 18.04 est livré avec Python 3.6), vous devrez mettre à jour votre distribution Linux vers quelque chose de plus récent.

La prise en charge du Raspberry Pi est limitée pour le moment.

Important : Vous devez utiliser le système Python fourni par votre système d'exploitation. Les installations Python provenant d'autres sources (telles que uv, pyenv, Anaconda, Python compilé manuellement, etc.) vous empêcheront de réussir à empaqueter votre application pour la distribution dans les étapes ultérieures de ce tutoriel.

Si vous êtes sous Windows, vous pouvez obtenir l'installateur officiel à partir du site web de Python. Vous pouvez utiliser n'importe quelle version stable de Python de la 3.10 à la 3.13 (mais vous devriez éviter les versions alpha, beta et release candidates). Nous recommandons vivement d'utiliser Python 3.13.

La prise en charge du Raspberry Pi est limitée pour le moment.

Si vous êtes sous macOS ou Windows, peu importe comment vous avez installé Python – ce qui compte c'est que vous puissiez lancer python3 à partir de l'invite de commande/terminal de votre système d'exploitation, et obtenir un interpréteur Python fonctionnel.

Installer les dépendances¶

Ensuite, installez les dépendances supplémentaires nécessaires à votre système d'exploitation :

macOSLinuxWindows

La construction d'applications BeeWare sur macOS nécessite :

Git, un système de contrôle de version. Il est inclus dans Xcode ou dans les outils de développement en ligne de commande, que vous avez installés ci-dessus. Il se peut que vous deviez ouvrir Xcode pour la première fois afin que Git fonctionne dans votre session de terminal. Si l'installation de Git n'est toujours pas enregistrée, il se peut que vous deviez redémarrer votre session de terminal.

Pour permettre le développement local, vous allez devoir installer certains paquets système. La liste des paquets requis varie en fonction de votre distribution :

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

Autres distributions Linux

Si vous utilisez une distribution Linux qui ne figure pas dans cette liste et qui n'est pas dérivée d'une distribution figurant dans cette liste (par exemple, Linux Mint et Pop! OS sont toutes deux des distributions dérivées de Debian ; AlmaLinux est dérivée de Fedora), vous aurez probablement des difficultés à suivre ce tutoriel. Si Briefcase vous avertit qu'il « ne peut pas vérifier les paquets système », vous ne pourrez pas suivre ce tutoriel.

La création d'applications BeeWare sur Windows nécessite :

Git, un système de contrôle de version. Vous pouvez télécharger Git à partir de [git-scm.com].

Après avoir installé ces outils, assurez-vous de redémarrer toutes les sessions de terminal. Sous Windows, les nouveaux outils installés ne seront accessibles qu'aux terminaux démarrés après la fin de l'installation.

Mise en place d'un environnement virtuel¶

Nous allons maintenant créer un environnement virtuel – un "bac à sable" (sandbox) que nous pouvons utiliser pour isoler notre travail sur ce tutoriel de notre installation Python principale. Si nous installons des paquets dans l'environnement virtuel, notre installation principale de Python (et tout autre projet Python sur notre ordinateur) ne sera pas affectée. Si nous provoquons un désordre complet dans notre environnement virtuel, nous pourrons simplement l'effacer et recommencer, sans affecter aucun autre projet Python sur notre ordinateur, et sans avoir besoin de réinstaller Python.

macOSLinuxWindows

$ 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 vous n'utilisez pas Python 3.12, remplacez le -3.12 dans ces instructions par le numéro de version que vous utilisez.

Erreurs lors de l'exécution de scripts PowerShell

Si vous utilisez PowerShell et que vous recevez l'erreur :

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

Votre compte Windows n'a pas l'autorisation d'exécuter des scripts. Pour résoudre ce problème :

Exécutez Windows PowerShell en tant qu'administrateur.
Exécutez set-executionpolicy RemoteSigned
Sélectionnez O pour modifier la politique d'exécution.

Une fois que vous avez fait cela, vous pouvez exécuter à nouveau beeware-venv\Scripts\activate.ps1 dans votre session PowerShell d'origine (ou dans une nouvelle session dans le même répertoire).

Si cela a fonctionné, votre prompt devrait maintenant être modifié – il devrait avoir un préfixe (beeware-venv). Cela vous permet de savoir que vous êtes actuellement dans votre environnement virtuel BeeWare. Chaque fois que vous travaillerez sur ce tutoriel, vous devrez vous assurer que votre environnement virtuel est activé. Si ce n'est pas le cas, relancez la dernière commande (la commande activate) pour réactiver votre environnement.

Environnements virtuels alternatifs

Si vous utilisez Anaconda ou miniconda, vous êtes peut-être plus familier avec l'utilisation des environnements conda. Vous avez peut-être aussi entendu parler de virtualenv, un prédécesseur du module intégré venv de Python. Comme pour les installations de Python, si vous êtes sous macOS ou Windows, la manière dont vous créez votre environnement virtuel n'a pas d'importance, tant que vous en avez un. Si vous êtes sous Linux, vous devriez vous en tenir à venv et au système Python.

Étapes suivantes¶

Nous avons maintenant mis en place notre environnement. Nous sommes prêts à créer notre première application BeeWare.