Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

inglés español

Guías Jardín Referencia de API PDF Wiki

Versión
Tabla de contenido
estable
Instalación de Kivy

Búsqueda rápida Usando pip

Configurar terminal y pip
Crea un entorno virtual
Instalar Kivy
Ruedas precompiladas
Empezando De la fuente
Ruedas precompiladas y de prelanzamiento
Introducción
Instalación de desarrollo
Instalación de Kivy Verificando la demo
Instalación usando Conda
Una primera aplicación Instalando las dependencias de Kivy
Glosario de Python
Propiedades
Instalación de Python
Lenguaje de diseño Kv Cómo usar la línea de comando
Que es pip y que son ruedas
Eventos
¿Qué son las ruedas nocturnas?

Cosas que no son widgets

Introducción Introducción »
Diseños
Instalación de Kivy
Dibujo
Installation for Kivy version 2.0.0. Read the changelog
embalaje here. For other Kivy versions, select the documentation
from the dropdown on the top left.
Ejemplos de
Kivy 2.0.0 officially supports Python versions 3.6 - 3.9.
Buceando en

Galería de ejemplos
Platform Installation Packaging

Empezando

Introducción Windows pip PyInstaller

Instalación de Kivy
Kivy.app,
Una primera aplicación OS X pip, Kivy.app
PyInstaller

Propiedades

1 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Lenguaje de diseño Kv
Platform Installation Packaging
Eventos

Cosas que no son widgets Linux pip, PPA —

Diseños

Dibujo RPi pip —

embalaje
python-for- python-for-
Ejemplos de Android
android android

Buceando en

Proyecto Kivy iOS kivy-ios kivy-ios

Guía de programación
Anaconda conda —
Tutoriales

Referencia de API
Using pip

The easiest way to install Kivy is with pip, which installs

Kivy using either a pre-compiled wheel, if available,
otherwise from source (see below).

Kivy proporciona ruedas precompiladas para las versiones

de Python compatibles en Windows, OS X, Linux y RPi.
Alternativamente, se requiere la instalación desde la fuente
para las versiones más nuevas de Python que no se
enumeran anteriormente o si las ruedas no funcionan o no
funcionan correctamente.

Configurar terminal y pip

Antes Kivy se puede instalar, Python y necesidades de

pepita a ser pre-instalados . Luego, inicie una nueva
terminal que tenga Python disponible . En la terminal,
actualización pipy otras dependencias de instalación por lo
que tiene la última versión de la siguiente manera (para los
usuarios de Linux puede que tenga que sustituir python3en
lugar de pythony también añadir una --userbandera en los
comandos posteriores fuera del entorno virtual):

Crear entorno virtual

2 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Cree un nuevo entorno virtual para su proyecto Kivy. Un

entorno virtual evitará posibles conflictos de instalación con
otras versiones y paquetes de Python. Es opcional pero
muy recomendable :

1. Cree el entorno virtual nombrado kivy_venven su

directorio actual:

2. Activar el entorno virtual. Deberá realizar este paso

desde el directorio actual cada vez que inicie una
nueva terminal. Esto configura el entorno para que
kivy_venvse utilice el nuevo Python.

Para la CMD predeterminada de Windows , en la

línea de comando, haga lo siguiente:

Si está en una terminal bash en Windows , en su

lugar haga lo siguiente:

Si estás en linux , haz lo siguiente:

Su terminal ahora debería preceder la ruta con algo como

(kivy_venv), lo que indica que el kivy_venventorno está
activo. Si no dice eso, el entorno virtual no está activo y lo
siguiente no funcionará.

Instalar Kivy

Finalmente, instale Kivy usando una de las siguientes

opciones:

Ruedas precompiladas

La más simple es instalar la versión estable actual kivyy,

opcionalmente, kivy_examplesde las ruedas PyPi provistas
por kivy-team. Simplemente haz:

Esto también instala las dependencias mínimas de Kivy.

3 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Para instalar adicionalmente Kivy con soporte de audio /

video , instale kivy[base,media]o kivy[full]. Consulte
las dependencias de Kivy para ver la lista de selectores.

Para Raspberry Pi, debe instalar adicionalmente las

dependencias enumeradas en las dependencias de origen
antes de instalar Kivy arriba.

De la fuente

Si una rueda no está disponible o no funciona, Kivy se

puede instalar desde la fuente con algunos pasos
adicionales. Instalar desde la fuente significa que Kivy se
instalará desde el código fuente y se compilará
directamente en su sistema.

Primero instale las dependencias del sistema adicionales

enumeradas para cada plataforma: Windows , OS X , Linux
, RPi .

Con las dependencias instaladas, ahora puede instalar Kivy

en el entorno virtual.

Para instalar la versión estable de Kivy, desde la terminal

haga:

Para instalar la última versión de Kivy de master , haga lo

siguiente:

Si desea instalar Kivy desde una rama diferente, desde su

repositorio bifurcado, o desde una confirmación específica
(por ejemplo, para probar una solución del PR de un
usuario) reemplace los componentes correspondientes de la
URL.

Por ejemplo, para instalar desde la stablerama, la URL se

convierte en https://github.com/kivy/kivy/archive
/stable.zip. O para probar un hash de confirmación
específico, use eghttps://github.com/kivy/kivy
/archive
/3d3e45dda146fef3f4758aea548da199e10eb382.zip

4 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Ruedas pre-lanzadas y precompiladas

Para instalar una rueda precompilada de la última versión

preliminar de Kivy, en lugar de la versión estable actual,
agregue la --prebandera a pip:

Esto solo instalará una versión de desarrollo de Kivy si se

lanzó una para PyPi . En su lugar, también se pueden
instalar las últimas ruedas Nightly de vanguardia desde el
servidor Kivy con:

Se hace en dos pasos, porque de lo contrario pippuede

ignorar las ruedas del servidor e instalar una versión
anterior de PyPi.

Para Raspberry Pi, recuerde instalar adicionalmente las

dependencias enumeradas en las dependencias de origen
antes de instalar Kivy arriba.

desarrollo

Si desea editar Kivy antes de instalarlo, o si desea intentar

solucionar algún problema de Kivy y enviar una solicitud de
extracción con la solución, primero deberá descargar el
código fuente de Kivy. Los siguientes pasos asumen que git
está preinstalado y disponible en la terminal.

El proceso típico es clonar Kivy localmente con:

Esto crea una carpeta con nombre kivy en su ruta actual. A

continuación, instale las dependencias del sistema
adicionales enumeradas para cada sistema operativo:
Windows , OS X , Linux , RPi .

Luego cambie al directorio kivy e instale Kivy como una

instalación editable :

5 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Ahora, puedes usar git para cambiar de rama, editar el

código y enviar un PR. Recuerde compilar Kivy cada vez que
cambie los archivos cython de la siguiente manera:

O si usa bash o en Linux, simplemente haga:

para recompilar.

Para ejecutar el conjunto de pruebas, simplemente ejecute:

o en bash o Linux:

Verificando la demostración

Kivy ahora debería estar instalado. Debería poder hacerlo

en Python o, si instaló los ejemplos de Kivy, ejecute la
demostración (en Windows):import kivy

o en bash o Linux:

La ruta exacta al directorio de ejemplos de Kivy también se

almacena en kivy.kivy_examples_dir.

La demostración de mono 3d a continuación kivy-

examples/3Drendering/main.pytambién es divertida de
ver.

Instalación usando Conda

Si usa Anaconda , puede instalar Kivy con su administrador

de paquetes Conda usando:

6 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

No lo use pippara instalar kivy si está usando Anaconda, a

menos que lo esté instalando desde la fuente.

Instalando las dependencias de Kivy

Kivy admite uno o más backends para sus proveedores

principales. Por ejemplo, es compatible con glew, angle y
sdl2 para el backend de gráficos en Windows. Para cada
categoría (ventana, gráficos, video, audio, etc.), se debe
instalar al menos un backend para poder usar la categoría.

Para facilitar la instalación, proporcionamos

extras_require grupos que instalarán backends
seleccionados para garantizar que la instalación de Kivy
funcione. Entonces, uno puede instalar Kivy de manera más
simple con, por ejemplo, `` pip install kivy [base, media,
tuio] ''. La lista completa de selectores y los paquetes que
instalan se encuentra en setup.py . Los paquetes exactos
de cada selector pueden cambiar en el futuro, pero el
objetivo general de cada selector seguirá siendo el que se
describe a continuación.

Ofrecemos los siguientes selectores:

base : las dependencias típicas mínimas

necesarias para que Kivy se ejecute,

sin incluir video / audio.

medios : solo las dependencias de vídeo / audio

necesarias para que Kivy

ser capaz de reproducir medios.

completo : todas las dependencias típicas

necesarias para que Kivy se ejecute, incluidos
vídeo / audio y

la mayoría de las dependencias opcionales.

dev : todas las dependencias adicionales

necesarias para ejecutar Kivy en modo de
desarrollo

(es decir, no incluye las dependencias base

/ media / full). Por ejemplo, los
encabezados necesarios para la
compilación y todas las dependencias
necesarias para ejecutar las pruebas y

7 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

crear los documentos.

tuio : las dependencias necesarias para que

TUIO funcione (principalmente oscpy).

Los siguientes selectores instalan backends empaquetados

como ruedas por kivy en el Kivy_depsespacio de nombres.
Por lo general, se lanzan y se versionan para que coincidan
con versiones específicas de Kivy, por lo que
proporcionamos selectores para facilitar la instalación (es
decir, en lugar de tener que hacerlo , ahora puede instalar
automáticamente el sdl2 correcto para la versión de
Kivy).pip install kivy kivy_deps.sdl2==x.y.zpip
install kivy[sdl2]

gstreamer : el backend de video / audio de

gstreamer, si está disponible

(actualmente solo en Windows)

ángulo : un backend OpenGL alternativo, si está

disponible

(actualmente solo en Windows)

sdl2 : el backend de ventana / imagen / audio,

si está disponible (actualmente solo en
Windows,

en OSX y Linux ya está incluido en la

rueda principal de Kivy).

glew : un backend OpenGL alternativo, si está

disponible (actualmente solo en Windows)

A continuación se muestran las kivy_depsruedas de

dependencia:

gstreamer (opcional)

kivy_deps.gstreameres una dependencia opcional

que solo es necesaria para el soporte de audio / video.
Solo lo proporcionamos en Windows, para otras
plataformas debe instalarse de forma independiente.
Alternativamente, use ffpyplayer en su lugar.

resplandor y / o ángulo

kivy_deps.glewy kivy_deps.angleson para OpenGL

. Puedes instalar ambos, eso no es problema. Solo
está disponible en Windows. En otras plataformas no

8 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

se requiere externamente.

Uno puede seleccionar cuál de estos usar para

OpenGL usando la KIVY_GL_BACKENDvariable de
entorno: configurándolo en glew(el predeterminado)
angle_sdl2, o sdl2. Aquí, angle_sdl2es un sustituto
de glewpero también requiere kivy_deps.sdl2ser
instalado.

sdl2

kivy_deps.sdl2es para ventana / imágenes / audio y

opcionalmente OpenGL. Solo está disponible en
Windows y se incluye en la rueda principal de Kivy
para otras plataformas.

Glosario de Python

Aquí explicamos cómo instalar paquetes de Python, cómo

usar la línea de comandos y qué son las ruedas.

Instalando Python

Kivy está escrito en Python y, como tal, para usar Kivy,

necesita una instalación existente de Python . Se pueden
instalar múltiples versiones de Python una al lado de la
otra, pero Kivy debe instalarse como paquete en cada
versión de Python en la que desee usar Kivy.

Para instalar Python, consulte las instrucciones para cada

plataforma: Windows , OS X , Linux , RPi .

Una vez que Python esté instalado, abra la consola y

asegúrese de que Python esté disponible escribiendo
.python --version

Cómo usar la línea de comando

Para ejecutar cualquiera de los comandos pipo wheeldados

aquí, necesita una línea de comando (aquí también llamada
consola , terminal , shell o bash , donde los dos últimos se
refieren a líneas de comando de estilo Linux) y Python debe
estar en la RUTA .

La línea de comando predeterminada en Windows es el

símbolo del sistema , cmd corto . La forma más rápida de
abrirlo es presionar Win + R en su teclado. En la ventana
que se abre, escriba cmdy luego presione enter.

9 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Las líneas de comando alternativas de estilo Linux en

Windows que recomendamos son Git para Windows o Mysys
.

Tenga en cuenta que la línea de comandos predeterminada

de Windows aún se puede usar, incluso si hay un terminal
bash instalado.

Para agregar temporalmente su instalación de Python a la

RUTA, simplemente abra su línea de comando y luego use
el cdcomando para cambiar el directorio actual al lugar
donde está instalado Python, por ejemplo .cd C:\Python37

Si ha instalado Python usando las opciones

predeterminadas, entonces la ruta a Python ya estará
permanentemente en su variable PATH. Hay una opción en
el instalador que le permite hacer eso, y está habilitada de
forma predeterminada.

Sin embargo, si Python no está en su RUTA, siga estas

instrucciones para agregarlo:

Instrucciones para la línea de comandos de Windows

Instrucciones para las líneas de comando de bash

Que es pip y que son ruedas

En Python, los paquetes como Kivy se pueden instalar con

el administrador de paquetes de Python, llamado pip
("paquete de instalación de Python").

Al instalar desde la fuente, algunos paquetes, como Kivy,

requieren pasos adicionales, como la compilación.

Por el contrario, las ruedas (archivos con una

.whlextensión) son distribuciones preconstruidas de un
paquete que ya ha sido compilado. Estas ruedas no
requieren pasos adicionales al instalarlas.

Cuando una rueda está disponible en pypi.org ("Índice de

paquetes de Python"), se puede instalar con pip. Por
ejemplo, cuando ejecuta en una línea de comando, esto
encontrará automáticamente la rueda apropiada en
PyPI.python -m pip install kivy

Al descargar e instalar una rueda directamente, use el

comando , por ejemplo:python -m pip install
<wheel_file_name>

10 de 11 14/10/2021 3:14 p. m.
Installing Kivy — Kivy 2.0.0 documentation https://kivy-org.translate.goog/doc/stable/gettingstarted/installation.ht...

Que son las ruedas nocturnas

Todos los días creamos una rueda de instantáneas de la

versión de desarrollo actual de Kivy ('rueda nocturna').
Puede encontrar la versión de desarrollo en la rama
maestra del repositorio de Kivy Github .

A diferencia de la última versión estable (que discutimos en

la sección anterior), Nightly Wheels contiene todos los
cambios más recientes en Kivy, incluidas las correcciones
experimentales. Para obtener instrucciones de instalación,
consulte Ruedas compiladas previamente al lanzamiento .

Advertencia
Usar la última versión de desarrollo puede ser arriesgado
y puede encontrar problemas durante el desarrollo. Si
encuentra algún error, infórmelo.

" Introducción Una primera aplicación »

11 de 11 14/10/2021 3:14 p. m.