Как установить kivy python в Windows

Обновлено: 03.07.2024

На этом снимке показано, как установить модуль Kivy 2.0.0 с помощью pip в Python 3.8+. Для начала я настоятельно рекомендую создавать виртуальную среду перед каждым использованием Kivy. Причина этого в том, что некоторые инструменты или модули могут быть затронуты или повлиять на модуль Kivy и вызвать проблемы при выполнении вашего кода.

Если вы используете Pycharm или другой текстовый редактор, который автоматически создает виртуальную среду, следующие несколько шагов не нужны. Если вы решите пропустить этапы виртуальной среды, перейдите к шагу 6.

Ниже приведены шаги по созданию виртуальной среды и установке Kivy с помощью pip (нажмите на подсказку для скриншотов):

Шаг 1) Перейдите в нужный каталог.

Шаг 2) Введите cmd в URL каталога и нажмите Enter, чтобы открыть командный терминал.

Шаг 3) Введите python -m pip install --upgrade pip setuptools virtualenv и нажмите Enter.

Пользователям Linux, возможно, придется использовать python3 вместо python в командном терминале и добавить флаг --user в команды за пределами виртуальной среды.

Шаг 4) Введите python -m virtualenv kvenv .

Шаг 5) Введите kvenv\Scripts\activate в командном терминале и нажмите Enter.

Ура! Теперь виртуальная среда настроена. Для каждого использования модуля Kivy за пределами этого каталога вам придется снова выполнить эти шаги. Однако если вы используете текстовый редактор, такой как Pycharm, который автоматически создает виртуальную среду, вам может не понадобиться.

Теперь пришло время использовать pip для установки Kivy. Прежде чем мы начнем использовать команды для установки Kivy, мы должны решить, какая версия нам нужна. Существует три типа: kivy [базовый], kivy [базовый, медиа] и kivy [полный]. Каждый тип имеет разные зависимости и, в конечном счете, является вашим предпочтением. Я обычно устанавливаю kivy[full] для проектов, над которыми работаю, поэтому я продемонстрирую это здесь. Однако установка с другими типами практически не отличается.

Шаг 6) Последний шаг! Откройте командный терминал с помощью (kvenv), введите python -m pip install kivy[full] и нажмите Enter.

Примечание. Если вы посмотрите на веб-сайт Kivy, вы увидите, что там написано «python -m pip install kivy[full] kivy_examples» вместо «python -m pip install kivy[full]». Однако оба способа будут работать.

Начиная с версии 1.9.1 мы предоставляем бинарные колеса для Kivy и все его зависимости, которые можно использовать с существующей установкой Python. См. Установка .

Мы также предоставляем ночные колеса, созданные с помощью мастера Kivy. См. Установка ночного колеса. См. также Обновление с предыдущего дистрибутива Kivy. Если вы устанавливаете kivy в другое место, а не в сайт-пакеты, см. Установка Kivy в другое место .

Установка¶

Теперь, когда python установлен, откройте командную строку и убедитесь, что python доступен, введя python --version . Затем выполните следующие действия для установки.

Убедитесь, что у вас установлена последняя версия пипа и колеса:

Установите зависимости (пропустите gstreamer (~120 МБ), если они не нужны, см. зависимости Kivy):

Если во время установки вы столкнулись с ошибкой памяти, добавьте после установки pip параметр --no-cache-dir .

Для Python 3.5+ вы также можете использовать бэкэнд angular вместо glew. Это можно установить с помощью:

(Необязательно) Установите примеры kivy:

Примеры устанавливаются в общий каталог в корневом каталоге, где установлен Python.

Вот и все. Теперь вы сможете импортировать kivy в python или запустить базовый пример, если вы установили примеры kivy:

Если вы столкнулись с какой-либо ошибкой отказа в доступе, попробуйте открыть командную строку от имени администратора и повторить попытку.

Что такое колеса, точка и колесо¶

В Python такие пакеты, как Kivy, можно установить с помощью менеджера пакетов Python, pip. Некоторые пакеты, такие как Kivy, требуют дополнительных шагов, таких как компиляция, при установке с использованием исходного кода Kivy с pip. Wheels (с расширением .whl) – это готовые дистрибутивы пакета, который уже был скомпилирован и не требует дополнительных действий для установки.

При размещении на pypi колесо устанавливается с помощью pip , например. python -m pip установить kivy. При прямой загрузке и установке колеса используется python -m pip install имя_файла_колеса, например:

Ночная установка колеса¶

Использование последней разрабатываемой версии может быть рискованным, и вы можете столкнуться с проблемами во время разработки. Если вы обнаружите какие-либо ошибки, сообщите о них.

Колеса моментальных снимков текущего мастера Kivy создаются при каждой фиксации в основной ветке репозитория kivy. Их можно найти здесь. Чтобы использовать их, вместо python -m pip install kivy мы установим одно из этих колес следующим образом.

Выполните шаги 1 и 2 из приведенного выше раздела "Установка".
Загрузите соответствующий руль для вашей системы.
Установите его с помощью python -m pip install имя-колеса, где имя-колеса — это имя переименованного файла, и добавьте deps в PATH.

Примеры Kivy отделены от ядра из-за их размера. Примеры можно установить отдельно как на Python 2, так и на 3 с помощью одного колеса:

Зависимости Kivy¶

Мы предлагаем колеса для Kivy и его зависимостей отдельно, поэтому необходимо устанавливать только нужные зависимости. Зависимости предлагаются как необязательные подпакеты kivy.deps, например. kivy.deps.sdl2 .

В настоящее время в Windows мы предоставляем следующие колеса зависимостей:

для аудио и видео и/или угла (только 3.5) для OpenGL для управления и/или OpenGL.

Можно выбрать, какой из них использовать для использования OpenGL, используя переменную окружения KIVY_GL_BACKEND, установив для нее значение glew (по умолчанию), angle или sdl2 . angular в настоящее время находится на экспериментальной стадии в качестве замены glew только для Python 3.5.

gstreamer — это необязательная зависимость, которую необходимо устанавливать, только если требуется отображение видео или звука. ffpyplayer — это альтернативная зависимость для аудио или видео.

Командная строка¶

Знайте свою командную строку. Чтобы выполнить любую из команд pip или wheel, нужен инструмент командной строки с python на пути. Командной строкой по умолчанию в Windows является командная строка, и самый быстрый способ открыть ее — нажать Win+R на клавиатуре, ввести cmd в открывшемся окне и нажать клавишу ввода.

Альтернативной командной оболочкой в стиле Linux, которую мы рекомендуем, является Git для Windows, которая предлагает командную строку bash, а также git. Обратите внимание, что CMD можно использовать, даже если установлен bash.

Идти по пути! Чтобы добавить свой python в путь, просто откройте командную строку, а затем используйте команду cd, чтобы изменить текущий каталог на место, где установлен python, например. компакт-диск C:\Python27 . В качестве альтернативы, если у вас установлена только одна версия Python, навсегда добавьте каталог python в путь для cmd или bash.

Использовать Kivy для разработки¶

Чтобы скомпилировать и установить kivy с использованием исходного кода kivy или использовать kivy с git, а не с колесом, необходимо выполнить несколько дополнительных действий:

Каталоги python и Python\Scripts должны быть в пути. Они должны быть в пути каждый раз, когда вы перекомпилируете kivy.

Убедитесь, что у вас есть последняя версия pip и wheel:

Получить компилятор. Для файла Python python\Lib\distutils\distutils.cfg добавьте две строки:

Установите MinGW с помощью:

Для Python 3.5 мы используем компилятор MSVC. Для версии 3.5 требуется Visual Studio 2015, которая доступна бесплатно. Просто скачайте и установите его, и все готово.

Visual Studio очень большой, поэтому вместо него можно использовать меньшие инструменты сборки Visual C.

Установите переменные среды. В окнах выполните:

Эти переменные необходимо устанавливать каждый раз при перекомпиляции kivy.

Установите другие зависимости, а также их версии для разработчиков (вы можете пропустить gstreamer и gstreamer_dev, если не собираетесь использовать видео/аудио):

Если вы загрузили или клонировали kivy в другое место и не хотите устанавливать его на сайт-пакеты, прочитайте следующий раздел.

Скомпилировать Kivy¶

Начать установку Kivy, клонированного с GitHub:

Если компиляция прошла без ошибок, Kivy готов к работе. Вы можете проверить это, запустив простой пример:

Установка Kivy в другое место¶

В процессе разработки Kivy часто устанавливается в другое место, а затем устанавливается с помощью:

Это позволяет Kivy оставаться в исходном местоположении, оставаясь при этом доступным для python, что полезно для отслеживания изменений, которые вы вносите в Kivy, например, непосредственно с помощью Git.

Для использования Kivy в другом месте требуется дополнительная настройка. Из-за этой проблемы wheel и pip устанавливают колеса зависимостей в python\Lib\site-packages\kivy . Поэтому их нужно переместить в вашу фактическую установку kivy из пакетов сайта.

После установки зависимостей kivy и загрузки или клонирования kivy в нужное место выполните следующие действия:

Переместите содержимое python\Lib\site-packages\kivy\deps в your-path\kivy\deps, где your-path — это путь, по которому находится ваш kivy. Это означает, что если вы клонировали данные с GitHub, файлы deps должны оказаться во внутренней папке kivy.
Полностью удалите каталог python\Lib\site-packages\kivy.
Из python\Lib\site-packages переместите все каталоги kivy.deps.*.dist-info на ваш путь рядом с kivy .

Теперь вы можете безопасно скомпилировать kivy в его текущем местоположении с помощью одной из этих команд:

Если kivy не удалось импортировать, возможно, вы не удалили все папки *.dist-info и папки kivy или kivy.deps* из пакетов сайта.

Как сделать Python доступным везде¶

Существует два способа запуска Python в файлах *.py.

Метод двойного щелчка¶

Если у вас установлен только один Python, вы можете связать все файлы *.py с вашим Python, если он еще не установлен, а затем запустить его, дважды щелкнув. Или вы можете сделать это только один раз, если хотите иметь возможность выбирать каждый раз:

Щелкните правой кнопкой мыши файл Python (с расширением .py) приложения, которое вы хотите запустить.
В появившемся контекстном меню выберите Открыть с помощью
Просмотрите свой жесткий диск и найдите файл python.exe, который вы хотите использовать. Выберите его.
Выберите «Всегда открывать файл с помощью…», если вы не хотите повторять эту процедуру каждый раз, когда дважды щелкаете файл .py.
Все готово. Откройте файл.

Метод отправки¶

Вы можете запустить файл .py с нашим Python, используя меню «Отправить»:

Перейдите к файлу python.exe, который вы хотите использовать. Щелкните его правой кнопкой мыши и скопируйте.
Откройте проводник Windows (проводник файлов в Windows 8) и перейдите по адресу «shell:sendto». Вы должны получить специальный каталог Windows SendTo
Вставьте ранее скопированный файл python.exe в качестве ярлыка.
Переименуйте его в python

Теперь вы можете запустить свое приложение, щелкнув правой кнопкой мыши файл .py -> «Отправить» -> «python»

Обновление предыдущего дистрибутива Kivy¶

Для установки новых колес на предыдущий дистрибутив Kivy необходимо удалить из дистрибутива все файлы и папки, кроме папки python. Затем эта папка python будет рассматриваться как обычный установленный в системе python, после чего можно будет продолжить все шаги, описанные в разделе «Установка».

Чтобы установить Kivy в Windows через pip, следуйте основному руководству по установке.

Компоненты установки¶

Ниже приведена дополнительная информация, связанная с некоторыми шагами в основном руководстве по установке для Windows.

Установка Python¶

Чтобы установить Python в Windows, загрузите его с основного веб-сайта Python и следуйте инструкциям по установке. Вы можете прочитать об отдельных вариантах установки в руководстве по Python.

Если вы установили модуль запуска Python, вам будет проще установить несколько версий Python рядом и выбирать, какую из них запускать при каждом вызове.

Зависимости исходной установки¶

Чтобы установить Kivy из исходного кода, следуйте инструкциям по установке, пока не дойдете до шага установки Kivy, а затем установите компилятор ниже, прежде чем продолжить.

Чтобы установить kivy из исходного кода, вам понадобится компилятор. В Windows требуются Инструменты сборки Visual Studio, и они доступны бесплатно. Вы можете:

Загрузите и установите полную Visual Studio IDE, содержащую инструменты сборки. Это самый простой подход, и IDE можно загрузить отсюда.

Среда IDE очень большая, поэтому вы также можете загрузить только небольшие инструменты сборки, которые используются из командной строки. Текущую загрузку (2019 г.) можно найти на этой странице в разделе «Инструменты для Visual Studio 2019». Дополнительную информацию по этой теме можно найти на вики Kivy.

Теперь, когда компилятор установлен, продолжайте установку Kivy.

Как сделать Python доступным везде¶

Существует два способа запуска Python при двойном щелчке файлов *.py.

Метод двойного щелчка¶

Если у вас установлен только один Python и если вы установили его с параметрами по умолчанию, то файлы *.py уже связаны с вашим Python. Вы можете запустить их, дважды щелкнув их в файловом менеджере или просто выполнив их имя в окне консоли (без добавления python ).

В качестве альтернативы, если они не назначены, вы можете сделать это следующим образом:

Щелкните правой кнопкой мыши файл Python (с расширением .py) в файловом менеджере.

В появившемся контекстном меню выберите Открыть с помощью

Просмотрите свой жесткий диск и найдите файл python.exe, который вы хотите использовать (например, в виртуальной среде). Выберите его.

Выберите «Всегда открывать файл с помощью…», если вы не хотите повторять эту процедуру каждый раз, когда дважды щелкаете файл .py.

Готово. Откройте файл.

Метод отправки¶

Вы можете запустить файл .py с помощью Python, используя меню Отправить:

Перейдите к файлу python.exe, который вы хотите использовать. Щелкните правой кнопкой мыши и скопируйте его.

Откройте Проводник Windows (проводник файлов в Windows 8) и перейдите по адресу «shell:sendto». Вы должны получить специальный каталог Windows SendTo .

Вставьте ранее скопированный файл python.exe в качестве ярлыка.

Переименуйте его в python

Теперь вы можете запустить свое приложение, щелкнув правой кнопкой мыши файл .py -> «Отправить» -> «python»

Хотя у Kivy уже есть поставщики аудио и видео, GStreamer требуется для более сложных вещей.

Чтобы было проще,

в дальнейшем тексте означает путь к каталогу с файлом python.exe.

Пакет wheel предоставляет скомпилированный Kivy, но с удаленными исходными компонентами cython, что означает, что основной код нельзя перекомпилировать таким образом. Однако код Python доступен для редактирования.

Стабильная версия Kivy доступна на pypi.

Последняя версия из официального репозитория доступна через ночные сборки на гугл диске. Перейдите по ссылке в документации, соответствующей вашей версии Python. После загрузки нужного колеса переименуйте его в соответствии с форматированием этого примера и выполните команду.

Для установки Kivy из исходного кода требуется больше зависимостей, чем при использовании колес, но установка более гибкая.

Создать новый файл в

\Lib\distutils\distutils.cfg с этими строками, чтобы обеспечить использование правильного компилятора для исходного кода.

Тогда нужен компилятор. Либо используйте уже установленные, либо загрузите mingwpy. Важные файлы, такие как gcc.exe, будут расположены в

Не забудьте установить переменные среды, чтобы Kivy знал, какие поставщики следует использовать.

Теперь установите дополнительные зависимости, необходимые для компиляции.

Проверьте раздел Paths, чтобы убедиться, что все настроено правильно, и установите Kivy. Выберите один из следующих вариантов:

Пути

Kivy требуется доступ к двоичным файлам из некоторых зависимостей. Это означает, что правильные папки должны находиться в переменной PATH среды.

Таким образом Python IDLE IDE можно включить в путь с помощью

\Lib\idlelib; . Затем напишите в консоли idle, и IDLE будет готов к использованию Kivy.

Упростить

Чтобы избежать повторной установки переменных среды, либо задайте каждый необходимый путь таким образом, либо создайте пакетный (.bat) файл с этими строками, помещенными в

Чтобы запустить проект Kivy после установки, запустите cmd.exe или командный файл и используйте python .py

установка в Ubuntu

Для установки kivy на ubuntu с примером kivy откройте терминал и выполните следующую команду

Читайте также: