Tutoriel 1 - Votre première application

Nous sommes prêts à créer notre première application.

Installer les outils BeeWare

Tout d’abord, nous devons installer Briefcase. Briefcase est un outil BeeWare qui peut être utilisé pour empaqueter votre application afin de la distribuer aux utilisateurs finaux – mais il peut également être utilisé pour démarrer un nouveau projet. Assurez-vous d’être dans le répertoire beeware-tutorial que vous avez créé lors du Tutorial 0, avec l’environnement virtuel beeware-venv activé, et exécutez :

(beeware-venv) $ python -m pip install briefcase

L’un des outils de BeeWare est Briefcase. Briefcase peut être utilisé pour empaqueter votre application afin de la distribuer aux utilisateurs finaux, mais il peut également être utilisé pour démarrer un nouveau projet.

Créer un nouveau projet

Commençons notre premier projet BeeWare ! Nous allons utiliser la commande new de Briefcase pour créer une application appelée Hello World. Exécutez la commande suivante à partir de votre invite de commande :

(beeware-venv) $ briefcase new

Briefcase nous demandera quelques détails sur notre nouvelle application. Pour les besoins de ce tutoriel, nous utiliserons les éléments suivants :

  • Formal Name (Nom formel) – Acceptez la valeur par défaut : Hello World.

  • App Name (Nom de l’application) - Acceptez la valeur par défaut : helloworld.

  • Bundle - Si vous possédez votre propre domaine, entrez ce domaine en ordre inverse. (Par exemple, si vous possédez le domaine « cupcakes.com », entrez com.cupcakes comme bundle). Si vous ne possédez pas votre propre domaine, acceptez le bundle par défaut (com.example).

  • Project Name (Nom du projet) - Acceptez la valeur par défaut : Hello World.

  • Description - Acceptez la valeur par défaut (ou, si vous voulez être vraiment créatif, trouvez votre propre description !)

  • ** Author** (Auteur) - Entrez votre propre nom ici.

  • Author’s email (adresse email) - Entrez votre propre adresse email. Elle sera utilisée dans le fichier de configuration, dans le texte d’aide, et partout où un email est requis lors de la soumission de l’application à un app store (magasin d’applications).

  • URL - L’URL de la page d’accueil de votre application. Encore une fois, si vous possédez votre propre domaine, entrez une URL sur ce domaine (y compris le https://). Sinon, acceptez l’URL par défaut (https://example.com/helloworld`). Cette URL n’a pas besoin d’exister (pour l’instant) ; elle ne sera utilisée que si vous publiez votre application dans un magasin d’applications.

  • License (Licence) - Acceptez la licence par défaut (BSD). Cela n’affecte en rien le fonctionnement du tutoriel, donc si vous avez des opinions fortes à ce sujet, n’hésitez pas à en choisir une autre.

  • GUI framework (framework d’interface utilisateur graphique) - Acceptez l’option par défaut, Toga (la boîte à outils GUI de BeeWare).

Briefcase va alors générer un squelette de projet que vous pourrez utiliser. Si vous avez suivi ce tutoriel jusqu’ici, et accepté les paramètres par défaut tels que décrits, votre système de fichiers devrait ressembler à quelque chose comme ceci :

beeware-tutorial/
├── beeware-venv/
│   └── ...
└── helloworld/
    ├── CHANGELOG
    ├── LICENSE
    ├── pyproject.toml
    ├── README.rst
    ├── src/
    │   └── helloworld/
    │       ├── app.py
    │       ├── __init__.py
    │       ├── __main__.py
    │       └── resources/
    │           └── README
    └── tests/
        ├── helloworld.py
        ├── __init__.py
        └── test_app.py

Ce squelette est en fait une application pleinement fonctionnelle, sans avoir rien à ajouter d’autre. Le dossier src contient tout le code de l’application, le dossier tests contient une suite de tests initiale, et le fichier pyproject.toml décrit comment empaqueter l’application pour la distribuer. Si vous ouvrez pyproject.toml dans un éditeur, vous verrez les détails de la configuration que vous venez de fournir à Briefcase.

Maintenant que nous avons une ébauche d’application, nous pouvons utiliser Briefcase pour l’exécuter.

Exécuter l’application en mode développeur

Entrez dans le répertoire du projet helloworld et faites démarrer le projet en mode développeur (ou dev) par briefcase :

(beeware-venv) $ cd helloworld
(beeware-venv) $ briefcase dev

[hello-world] Installing requirements...
...

[helloworld] Starting in dev mode...
===========================================================================

Cela devrait ouvrir une fenêtre GUI :

Fenêtre Tutoriel 1 Hello World, sur macOS

Appuyez sur le bouton de fermeture (ou sélectionnez Quitter dans le menu d’application), et c’est terminé ! Félicitations, vous venez d’écrire une application native et autonome en Python !

Étapes suivantes

Nous avons maintenant une application fonctionnelle, s’exécutant en mode développeur. Nous pouvons maintenant ajouter notre propre logique pour que notre application fasse quelque chose d’un peu plus intéressant. Dans Tutoriel 2, nous allons ajouter à notre application une interface utilisateur plus utile.