Apple

Installation sur Windows – Documentation de Kivy 1.11.0

Par Maximus , le 9 juin 2019 - 12 minutes de lecture

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.

  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

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.

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

  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.

Compiler Kivy

  1. 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:

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

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

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

  4. 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.

  5. Vous avez terminé. Ouvrez le fichier.

Méthode d'envoi

Vous pouvez lancer un fichier .py avec notre Python en utilisant le menu Envoyer à:

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

  2. 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 à

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

  4. 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

Maximus

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.