Tutoriel 0 - Préparons-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.
Si vous utilisez macOS, une version récente de Python est incluse dans Xcode ou dans les outils de développement en ligne de commande. Pour vérifier si vous l’avez déjà, exécutez la commande suivante :
$ python3 --version
Si Python est installé, vous verrez son numéro de version. Sinon, vous serez invité à installer les outils de développement en ligne de commande.
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 à partir de la 3.8. Nous vous conseillons d’éviter les versions alpha, beta et release candidates à moins que vous ne sachiez vraiment ce que vous faites.
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.
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 à partir de la 3.8. Nous vous conseillons d’éviter les versions alpha, beta et release candidates à moins que vous ne sachiez vraiment ce que vous faites.
Distributions alternatives de Python
Il existe de nombreuses façons d’installer Python. Vous pouvez installer Python via homebrew. Vous pouvez utiliser pyenv pour gérer plusieurs installations de Python sur la même machine. Les utilisateurs de Windows peuvent installer Python à partir du Windows App Store. Les utilisateurs ayant une formation en science des données pourraient préfèrer utiliser Anaconda ou Miniconda.
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.
Si vous êtes sous Linux, vous devez utiliser le Python fourni par votre système d’exploitation. Vous pourrez réaliser la majeure partie de ce tutoriel en utilisant un Python non système, mais vous ne pourrez pas empaqueter votre application pour la distribuer à d’autres.
Installer les dépendances¶
Ensuite, installez les dépendances supplémentaires nécessaires à votre système d’exploitation :
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 précédemment.
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 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 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.org.
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.
$ 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
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 les autorisations nécessaires pour exécuter des scripts. Pour y remédier :
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. De même pour les installations de Python – si vous êtes sous macOS ou Windows, peu importe comment vous créez votre environnement virtuel, tant que vous en avez un. Si vous êtes sous Linux, vous devriez vous en tenir à venv
et au Python du système.
Étapes suivantes¶
Nous avons maintenant mis en place notre environnement. Nous sommes prêts à créer notre première application BeeWare.