Installation sur Windows – Documentation de Kivy 1.11.0

Utiliser Conda

Si vous utilisez Anaconda, vous pouvez simplement installer kivy en utilisant:

$ conda install kivy -c conda-forge

Sinon, continuez ci-dessous pour installer Kivy dans une installation native de Python.

Conditions préalables

Kivy est écrit en
Python
et en tant que tel, pour utiliser Kivy, vous avez besoin d’un
installation de Python.
Plusieurs versions de Python peuvent être installées côte à côte, mais Kivy doit
être installé dans chaque version de Python que vous souhaitez utiliser Kivy.

À partir de 1.9.1, nous fournissons du binaire
roues
pour Kivy et toutes ses dépendances à utiliser avec un Python existant
installation. Voir Installer la version stable de Kivy.

Nous fournissons également des roues de nuit générées à l'aide de Kivy
maîtriser. Voir Installation de roue de nuit.
Si vous installez kivy sur un alterner
emplacement et pas à site-packages, s'il vous plaît voir Installer Kivy et le modifier sur place.

Mise à jour de Kivy à partir d'une version précédente

Lors de la mise à jour depuis une version précédente de Kivy, toutes les dépendances de Kivy doivent être
mis à jour en premier. En règle générale, il suffit d'ajouter -améliorer au pip installer… commandes ci-dessous
est suffisant pour que pip les mette à jour.

python -m pépin désinstaller -y Kivy.deps.glew Kivy.deps.Gstreamer Kivy.deps.sdl2 Kivy.deps.angle

Installer la version stable de Kivy

Maintenant que python est installé, ouvrez le Ligne de commande et assurez-vous
Python est disponible en tapant python --version. Ensuite, procédez comme suit pour
créer un nouvel environnement virtuel
(facultatif) et installez la dernière version stable
kivy release (1.11.0) et ses dépendances.

1. Assurez-vous de disposer du dernier pip, wheel et virtualenv:

   python -m pépin installer -améliorer pépin roue setuptools virtualenv
   

   Éventuellement créer un nouvel environnement virtuel
   pour votre projet Kivy. Hautement recommandé:

   1. Créez d'abord l'environnement nommé kivy_venv dans votre répertoire actuel:

      python -m virtualenv kivy_venv
      

   2. Activer l'environnement virtuel. Vous devrez effectuer cette étape à partir du répertoire en cours.
      à chaque fois vous démarrez un nouveau terminal. Sur Windows CMD, faites:

      kivy_venvLes scriptsActiver
      

      Si vous êtes dans un terminal bash, faites plutôt:

      la source kivy_venv/Les scripts/Activer
      

   Votre terminal doit maintenant faire précéder le chemin avec quelque chose comme (kivy_venv), indiquant que
   la kivy_venv l'environnement est actif. Si cela n’est pas dit, l’environnement virtuel n’est pas actif.

2. Installez les dépendances (ignorez gstreamer (~ 120 Mo) si non nécessaire, voir
   Dépendances de Kivy). Si vous mettez à niveau Kivy, voir Mise à jour de Kivy à partir d'une version précédente:

   python -m pépin installer docutils pygments pypiwin32 kivy_deps.sdl2==0,1.22 kivy_deps.glew==0,1.12
   python -m pépin installer kivy_deps.Gstreamer==0,1.17
   

   Remarque

   Si vous rencontrez un MemoryError lors de l'installation, ajoutez après
   pip installer la –No-cache-dir option.

   Pour Python 3.5+, vous pouvez également utiliser le backend d'angle au lieu de glew. Ce
   peut être installé avec:

   python -m pépin installer kivy_deps.angle==0,1.9
   

   Attention

   Lors de l’installation, épinglez les dépendances de kivy à la version spécifique publiée sur pypi.
   quand votre version kivy est sortie, comme ci-dessus. Sinon, vous pouvez obtenir une dépendance incompatible
   quand il est mis à jour dans le futur.

3. Installez kivy:

   python -m pépin installer Kivy==1.11.0
   

4. (Facultatif) Installez les exemples Kivy:

   python -m pépin installer kivy_examples==1.11.0
   

   Les exemples sont installés dans le répertoire de partage sous le répertoire racine où est installé python.

C'est tout. Vous devriez maintenant pouvoir importation Kivy en python ou exécuter une base
exemple si vous avez installé les exemples kivy:

python partagerKivy-exemplesdémovitrineprincipale.py

Quels sont les roues, pip et la roue

En Python, des paquets tels que Kivy peuvent être installés avec le paquet Python
gestionnaire, pip. Certains forfaits tels que Kivy
nécessite des étapes supplémentaires, telles que la compilation, lors de l'installation à l'aide de Kivy
code source avec pip. Roues (avec un .whl extension) sont pré-construits
les distributions d'un paquet déjà compilé et ne nécessitant pas
étapes supplémentaires à installer.

Lorsque hébergé sur Pypi on installe une roue
en utilisant pépin, par exemple. python -m pépin installer Kivy. Lors du téléchargement et
installer une roue directement, python -m pépin installer wheel_file_name est utilisé,
tel que:

python -m pépin installer C:Kivy-1,9.1.dev-cp27-aucun-win_amd64.chut

Installation de roue de nuit

Des images de roues du maître Kivy actuel sont créées quotidiennement sur le
maîtriser branche du dépôt kivy. Ils peuvent être trouvés
ici. Pour les utiliser, au lieu de
Faire python -m pépin installer Kivy nous allons installer une de ces roues comme
suit.

1. Effectuez les étapes 1 et 2 de la section Installation ci-dessus.

2. Téléchargez la roue appropriée pour votre système.

3. Installez-le avec python -m pépin installer nom de roue où nom de roue

   est le nom du fichier.

Les exemples de Kivy sont séparés du noyau en raison de leur taille. Les exemples
peut être installé séparément sur Python 2 et 3 avec cette roue unique:

Dépendances de Kivy

Nous proposons des roues pour Kivy et ses dépendances séparément, donc uniquement désirées
les dépendances doivent être installées. Les dépendances sont offertes en tant que
sous-packages facultatifs de kivy_deps, par exemple kivy_deps.sdl2.

Actuellement sur Windows, nous fournissons les roues de dépendance suivantes:

On peut choisir lequel d’entre eux utiliser pour OpenGL en utilisant le
KIVY_GL_BACKEND variable d'environnement en le mettant à glew
(le défaut), angle, ou sdl2. angle est actuellement
dans une phase expérimentale en remplacement de glew sur Python
3.5+ seulement.

Gstreamer est une dépendance optionnelle qui doit seulement être
installé si un affichage vidéo ou audio est souhaité. ffpyplayer
est une dépendance alternative pour l'audio ou la vidéo.

Ligne de commande

Connaissez votre ligne de commande. Pour exécuter l'un des pépin

ou roue commandes, il faut un outil de ligne de commande avec python sur le chemin.
La ligne de commande par défaut sous Windows est
Invite de commande, et le
moyen le plus rapide de l’ouvrir est d’appuyer sur Win + R sur votre clavier, tapez cmd

dans la fenêtre qui s'ouvre, puis appuyez sur Entrée.

Alterner les shells de commande de style linux que nous recommandons est
Git pour Windows qui offre une bash
ligne de commande ainsi que
git. Notez que CMD peut toujours être utilisé même si bash est
installée.

Marcher le chemin! Pour ajouter votre python au chemin, ouvrez simplement votre ligne de commande
et ensuite utiliser le CD commande pour changer le répertoire en cours vers où python
est installé, par exemple CD C: Python37. Alternativement si vous n'en avez qu'un
version python installée, ajoutez définitivement le répertoire python au chemin de
cmd ou
frapper.

Utiliser le développement Kivy

Compiler et installer kivy en utilisant le kivy
code source ou à utiliser
kivy avec git plutôt qu'une roue il y a quelques étapes supplémentaires:

1. Les deux python et le Python Scripts des annuaires doit être sur
   le chemin. Ils doivent être sur le chemin chaque fois que vous recompilez kivy.

2. Assurez-vous d'avoir le dernier pip et la roue avec:

   python -m pépin installer -améliorer pépin roue setuptools
   

3. Obtenez le compilateur.
   Pour Python <3.5, nous utilisons mingwpy comme suit.

   1. Créer le
      python Lib distutils distutils.cfg déposer et ajouter les deux lignes:

      [[[[construire]
      compilateur = mingw32
      

   2. Installez MinGW avec:

      python -m pépin installer -je https://Pypi.anaconda.org/Carlkl/simple Mingwpy
      

   Pour Python 3.5, nous utilisons le compilateur MSVC. Pour 3.5,
   Visual Studio 2015 est
   requis, qui est disponible gratuitement. Il suffit de télécharger et d'installer et
   vous serez prêt à partir.

   Visual Studio est très gros, vous pouvez donc aussi utiliser le plus petit,
   Visual C Build Tools à la place.

4. Définissez les variables d'environnement. Sur les fenêtres faire:

   ensemble USE_SDL2=1
   ensemble USE_GSTREAMER=1
   

   En bash faire:

   exportation USE_SDL2=1
   exportation USE_GSTREAMER=1
   

   Ces variables doivent être définies chaque fois que vous recompilez kivy.

5. Installez les autres dépendances ainsi que leurs versions dev (vous pouvez ignorer
   gstreamer et gstreamer_dev si vous n’utilisez pas la vidéo / l’audio). nous n'épinglons pas
   les versions des dépendances comme pour le kivy stable parce que nous voulons la
   dernier:

   python -m pip install Cython == 0.29.9 pygments docutils pypiwin32 kivy_deps.sdl2 kivy_deps.glew kivy_deps.gstreamer kivy_deps.glew_dev kivy_deps.sdl2_dev ksy_dep2.

6. Si vous avez téléchargé ou cloné Kivy à un autre endroit et que vous ne voulez pas
   installez-le sur site-packages lisez la section suivante.

7. Enfin compiler et installer kivy avec pépin installer nom de fichier, où
   nom de fichier peut être une URL telle que
   https://github.com/kivy/kivy/archive/master.zip pour le maître kivy, ou le
   chemin complet vers une copie locale d'un kivy.

python partagerKivy-exemplesdémovitrineprincipale.py

Installer Kivy et le modifier sur place

En développement, Kivy est souvent cloné ou téléchargé sur un site, puis
installé avec:

python -m pépin installer -e chemin_kivy

Maintenant, vous pouvez compiler kivy en toute sécurité à son emplacement actuel avec l’un de ces
commandes:

faire
python installer.py build_ext -en place

Mais Kivy serait entièrement installé et disponible à partir de Python. N'oubliez pas de réexécuter la commande ci-dessus
chaque fois que l'un des fichiers cython est modifié (par exemple, si vous l'avez extrait de GitHub) pour être recompilé.

Rendre Python disponible n'importe où

Il existe deux méthodes pour lancer Python sur votre ordinateur. * .py des dossiers.

python -m pépin désinstaller kivy_deps.sdl2 kivy_deps.glew kivy_deps.Gstreamer
python -m pépin désinstaller Kivy