1.3 Installation de Kivy

Kivy (prononcé kivi et non kaïvy) est un paquet qui permet de programmer une application graphique avec Python.

Il existe de nombreux paquets d'interface graphique pour Python. Kivy offre l'avantage d'être gratuit, multi-plateformes (Windows, Linux et MacOS, Androïd et iOS) et performant.

Dépendances de Kivy

C'est un fait reconnu : la gestion des dépendances de Kivy est une partie complexe de son l'installation. Si vous écrivez une application avec Kivy et que vous n'obtenez qu'une page noire ou encore un message du genre « Unable to get a Window, abort », il y a fort à parier que vous faites face à un problème de dépendances.

Pour fonctionner correctement, Kivy nécessite minimalement l'installation de :

• sdl2 (Simple DirectMedia)
• gstreamer (gestion des pipelines pour le multimédia)
• glew ou angle (pour OpenGL - Open Graphics Library)

Les procédures qui suivent installeront Kivy de même que ses dépendances.

Installation de Kivy avec PyCharm

Si vous travaillez avec PyCharm, que ce soit sous Mac, Linux ou Windows, l'installation de Kivy est un vrai charme.

• Rendez-vous dans le menu File / Settings (sous MacOS : PyCharm / Preferences).
• Allez dans Project / Project Interpreter.
• Cliquez sur le + puis retrouvez le paquet Kivy.
• Kivy sera installé pour votre projet, de même que certaines de ses dépendances.
• Pour compléter la liste des dépendances installées, cliquez à nouveau sur le + puis installez :
  • kivy.deps.gstreamer
  • kivy.deps.sdl2
  • kivy.deps.glew

Installation sous Windows

Si vous souhaitez programmer sous Windows, sans PyCharm, vous devrez suivre ces instructions pour installer Kivy :

• Assurez-vous d'abord que Python soit installé sur votre ordinateur.
• Ouvrez une fenêtre de commande DOS (cmd).
• Déplacez-vous dans le dossier qui contient le fichier exécutable de Python.
  Fenêtre de commande DOS

  cd \Users\monnom\AppData\Local\Programs\Python\Python37-32

• Assurez-vous que Pip soit installé (voir Installation de Pip) puis installez Kivy et ses dépendances.
  Fenêtre de commande DOS

  python -m pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew
  python -m pip install kivy.deps.gstreamer

  python -m pip install kivy

Installation sous MacOS

Sous MacOS aussi, il est possible de travailler sans PyCharm. L'installation de Kivy se fera comme suit.

Assurez-vous que Homebrew soit installé sur votre Mac (voir Installation de Homebrew).

Installez ensuite les dépendances de Kivy :

Note : le --user permet d'effectuer l'installation sous votre dossier personnel (/Users/monnom/Library/Python/3.x/bin), ce qui est nécessaire pour contourner l'erreur « Could not install packages due to an EnvironmentError: [Errno 13] Permission denied ».

Installez finalement Kivy :

Ex :

Vérifier si Kivy est correctement installé

Pour vérifier le tout, il est possible d'écrire un petit programme Python qui affichera la version de Kivy.

Ex :

Pour plus d'information

« User’s Guide » Installation on Windows ». Kivy. https://kivy.org/doc/stable/installation/installation-windows.html

« User’s Guide » Installation on OS X ». Kivy. https://kivy.org/doc/stable/installation/installation-osx.html