Installation sur Windows – Documentation de Kivy 1.11.0

Contenus ToggleUtiliser CondaConditions préalablesMise à jour de Kivy à partir d'une version précédenteInstaller la version stable de KivyQuels sont les roues, pip et la roueInstallation de roue de nuitDépendances de KivyLigne de commandeUtiliser le développement KivyCompiler KivyInstaller Kivy et le modifier sur placeRendre Python disponible n'importe oùMéthode du double-clicMéthode d'envoiDésinstallation de Kivy 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.

Remarque Pour Python <3.5, nous utilisons le compilateur MinGW. Cependant, pour Python 3.5+ sur Windows, nous ne supportons actuellement que le compilateur MSVC à cause du Python suivant numéro 4709 sur MinGW. En règle générale, cela ne devrait faire aucune différence lorsque vous utilisez des roues précompilées.

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.

Attention Lors de la mise à jour de Kivy 1.10.1 ou inférieure à 1.11.0 ou supérieure, une doit manuellement désinstaller toutes les dépendances de kivy avant la mise à niveau car elles ne seront pas mises à jour correctement. Ceci est fait avec:

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

en supposant que toutes les dépendances ont été précédemment installées. Voir Dépendances de Kivy pour plus de détails. Après la désinstallation, poursuivez l'installation ci-dessous.

Installer la version stable de Kivy

Attention Kivy 1.11.0 est la dernière version qui prend en charge Python 2.

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.

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é:

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

python -m virtualenv kivy_venv

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.

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.

Installez kivy:

python -m pépin installer Kivy==1.11.0

(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

Remarque Si vous en rencontrez permission refusée erreurs, essayez d'ouvrir le Invite de commande en tant qu'administrateur et essayer à nouveau. La meilleure solution consiste à utiliser un environnement virtuel. au lieu.

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

Attention Utiliser la dernière version de développement peut être risqué et vous pourriez rencontrer problèmes au cours du développement. Si vous rencontrez des bugs, merci de les signaler.

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.

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

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

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.

Remarque Dans Kivy 1.11.0, nous avons effectué la transition des dépendances Windows de kivy du kivy.deps.xxx espace de noms stocké sous kivy / deps / xxx au kivy_deps.xxx espace de noms stocké sous kivy_deps / xxx. Pip est parfois pas en mesure de distinguer entre ces deux formats, alors suivez les instructions à Mise à jour de Kivy à partir d'une version précédente lors de la mise à niveau d'un ancien Kivy. Vois ici pour plus de détails.

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

Attention Utiliser la dernière version de développement peut être risqué et vous pourriez rencontrer problèmes au cours du développement. Si vous rencontrez des bugs, merci de les signaler.

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:

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.

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

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

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

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

[[[[construire] compilateur = mingw32

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.

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.

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.

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.

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.

Compiler Kivy

Démarrez l'installation de Kivy cloné ou téléchargé et extrait de GitHub. Vous devriez être dans le répertoire racine où kivy est extrait contenant le setup.py fichier:

Si la compilation réussit sans aucune erreur, Kivy devrait être bon à partir. Vous peut le tester en exécutant un exemple de base:

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.

Méthode du double-clic Si vous n'avez qu'un seul Python installé, vous pouvez associer tous * .py des dossiers avec votre python, si ce n’est pas déjà le cas, puis exécutez-le en double-cliquant. Ou vous ne pouvez le faire qu'une fois si vous voulez pouvoir choisir à chaque fois:

Faites un clic droit sur le fichier Python (extension de fichier .py) de l’application que vous vouloir lancer

Dans le menu contextuel qui apparaît, sélectionnez Ouvrir avec

Parcourez votre disque dur et trouvez le fichier python.exe que tu veux utiliser. Sélectionnez le.

Sélectionnez «Toujours ouvrir le fichier avec…» si vous ne voulez pas répéter cette opération. procédure chaque fois que vous double-cliquez sur un fichier .py.

Vous avez terminé. Ouvrez le fichier.

Méthode d'envoi Vous pouvez lancer un fichier .py avec notre Python en utilisant le menu Envoyer à:

Naviguez vers le python.exe fichier que vous souhaitez utiliser. Faites un clic droit dessus et copiez-le.

Ouvrez l'explorateur Windows (Explorateur de fichiers sous Windows 8), et pour aller à l'adresse "Shell: sendto". Vous devriez obtenir le répertoire spécial Windows Envoyer à

Coller le déjà copié python.exe fichier comme raccourci.

Renommez-le en python . Par exemple. python27-x64

Vous pouvez maintenant exécuter votre application en cliquant avec le bouton droit de la souris sur le bouton .py fichier -> “Envoyer vers” -> “python ”.

Désinstallation de Kivy Pour désinstaller Kivy, supprimez les packages installés avec pip. Par exemple. si vous êtes surpris en suivant les instructions ci-dessus, faites:

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