KivyMD

Kivymd 2.0.0

Kivymd es una colección de widgets compatibles con el diseño de materiales para su uso con Kivy, un marco para aplicaciones gráficas entre plataformas y habilitadas en toque.

El objetivo del proyecto es aproximar la especificación de diseño de material de Google lo más cerca posible sin sacrificar la facilidad de uso. Esta biblioteca es una bifurcación del proyecto Kivymd. Encontramos la fuerza y ​​llevamos este proyecto a un nuevo nivel.

¡Únete al proyecto! Simplemente bifurca el proyecto, ramifica y envíe una solicitud de extracción cuando su parche esté listo. Si se necesita algún cambio, lo guiaremos a través de los pasos que deben realizarse a través de comentarios de relaciones públicas o acceso a su FOR se puede solicitar que los envíe directamente.

Si desea convertirse en un desarrollador de proyectos (permiso para crear sucursales en el proyecto sin bifurcar para una colaboración más fácil), tenga al menos un PR aprobado y solicite. Si contribuye regularmente al proyecto, el papel se puede ofrecerle sin preguntar también.

Instalación

pip install kivymd==2.0.0

Dependencias:

• Kivy> = 2.3.0 (instalación)
• Python 3.7+
• Almohada
• Cazadora de material
• asynckivy

Cómo instalar

El comando anterior instalará la última versión de lanzamiento de Kivymd de Pypi.

Si desea instalar la versión de desarrollo desde Master Branch, debe especificar el enlace al archivo ZIP:

pip install https://github.com/kivymd/KivyMD/archive/master.zip

Consejo : Reemplace master.zip con <commit hash>.zip (por ejemplo, 51b8ef0.zip ) para descargar kivymd de confirmación específica.

También puede instalar manualmente desde fuentes. Simplemente clone el proyecto y ejecute PIP:

git clone https://github.com/kivymd/KivyMD.git --depth 1
cd KivyMD
pip install .

Consejo de velocidad : si no necesita un historial de confirmación completa (alrededor de 1.14 GIB), puede usar un clon poco profundo ( git clone https://github.com/kivymd/KivyMD.git --depth 1 ) para ahorrar tiempo. Si necesita un historial de confirmación completa, elimine --depth 1 .

Cómo usar con buildozer

 requirements = python3,
    kivy,
    https://github.com/kivymd/KivyMD/archive/master.zip,
    materialyoucolor,
    exceptiongroup,
    asyncgui,
    asynckivy

Esto descargará la última versión de lanzamiento de Kivymd de Pypi.

Si desea usar la versión de desarrollo de Master Branch, debe especificar el enlace al archivo ZIP:

 requirements = kivy, https://github.com/kivymd/KivyMD/archive/master.zip

No olvide ejecutar buildozer android clean o eliminar el directorio .buildozer antes de construir si se actualizó la versión (BuildOZer no actualiza los paquetes ya descargados).

En Linux

• Use buildozer directamente o a través de Docker.

En Windows 10

• Instale Ubuntu WSL y siga los pasos de Linux.

Construir automáticamente a través de acciones de GitHub

• Use ArtemsBulgakov/Buildozer-Action@V1 para construir sus paquetes automáticamente en la solicitud de empuje o extracción.
• Ver ejemplo de flujo de trabajo completo.

Cómo usar con kivy-ios

toolchain build python3 kivy pillow
toolchain pip install --no-deps kivymd

Documentación

• Ver documentación en https://kivymd.readthedocs.io
• Wiki con ejemplos de uso de widgets kivymd: https://github.com/kivymd/kivymd/wiki

Población

La aplicación de fregadero de la cocina demuestra cada widget de Kivymd. Puede ver cómo usar widget en código de aplicación.

Comparación de Flutter y Kivymd

Concepto de vista del cielo	Entrega de alimentos saludables
Concepto de zapatos asics	Rediseño de escritorio de Facebook

Use MVC y recarga en caliente

Apoyo

Si necesita ayuda o tiene una pregunta, puede pedir ayuda en nuestra lista de correo:

• Discord Server: https://discord.gg/wu3qbst (inglés #support, ruso #ru-support)
• Etiqueta StackoverFlow: Kivymd
• Correo electrónico: [email protected]

Ajustes

Destacación de sintaxis y autocompleto para archivos Kivy/Kivymd .KV en PyCharm/IntelliJ Idea

Video promocional

Que contribuye

¡Siempre damos la bienvenida a sus informes de errores, solicitudes de funciones y solicitudes de extracción! Echa un vistazo a contribuir.md y no dudes en mejorar KivyMD.

Entorno de configuración

Le recomendamos que use Pycharm para trabajar con el código Kivymd. Instale las dependencias de Kivy y el desarrollo en su entorno virtual:

pip install -e .[dev,docs]
pre-commit install

Formatear todos los archivos y ejecutar pruebas:

pre-commit run --all-files
pytest kivymd/tests --timeout=600 --cov=kivymd --cov-report=term

Precomitar formateará archivos modificados con las importaciones negras y de clasificación con ISORT.

Proyectos hermanos

Extensiones de Kivymd

Extensiones adicionales para la Biblioteca Kivymd.

https://github.com/kivymd-extensions

Kivymdbuilder

Cree aplicaciones visualmente.

https://github.com/kivymd/kivymdbuilder

Licencia

• Kivymd se libera bajo los términos de la licencia MIT, igual que Kivy.
• Roboto Font tiene licencia y distribuida bajo los términos de la licencia Apache, versión 2.0.
• Fuente icónica por la comunidad de íconos de diseño de material cubierto por SIL Open Font License 1.1

Colaboradores

Equipo de Kivymd

Pasaron mucho tiempo para mejorar Kivymd.

• Yuri Ivanov @HeattheAtr - Desarrollador de núcleo
• Artem Bulgakov @artemsbulgakov - Administrador técnico, contribuyente
• Andrés Rodríguez @MixedCase - Primer autor de Kivymd Project, Colaborador

Contribuyentes de código

Este proyecto existe gracias a todas las personas que contribuyen. Cómo contribuir

Contribuyentes financieros

Conviértete en un contribuyente financiero en OpenColective y ayúdanos a mantener nuestra comunidad.

Patrocinadores de oro

Conviértase en un patrocinador de oro y obtenga su logotipo en nuestro ReadMe con un enlace a su sitio web.

Mejor planificador de ruta: software de optimización de ruta

Patrocinadores

Conviértete en un patrocinador si quieres ayudar a desarrollar este proyecto.