KivyMD

Kivymd 2.0.0

KivyMD est une collection de widgets conformes à la conception de matériaux à utiliser avec Kivy, un cadre pour des applications graphiques multiplateformes et compatibles tactiles.

L'objectif du projet est de se rapprocher des spécifications de conception des matériaux de Google aussi près que possible sans sacrifier la facilité d'utilisation. Cette bibliothèque est une fourche du projet Kivymd. Nous avons trouvé la force et a porté ce projet à un nouveau niveau.

Rejoignez le projet! Frais simplement le projet, branchez et soumettez une demande de traction lorsque votre patch est prêt. Si des modifications sont nécessaires, nous vous guiderons à travers les étapes qui doivent être effectuées via des commentaires de relations publiques ou l'accès à votre FOR peut être demandé pour les soumettre carrément.

Si vous souhaitez devenir un développeur de projet (autorisation de créer des branches sur le projet sans former une collaboration plus facile), faites approuver au moins un RP et le demander. Si vous contribuez régulièrement au projet, le rôle peut vous être proposé sans demander également.

Installation

pip install kivymd==2.0.0

Dépendances:

• Kivy> = 2.3.0 (installation)
• Python 3.7+
• Oreiller
• Mât de matériel
• asynckivy

Comment installer

La commande ci-dessus installera la dernière version de version de Kivymd de PYPI.

Si vous souhaitez installer la version de développement de Master Branch, vous devez spécifier le lien vers l'archive zip:

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

Astuce : remplacez master.zip par <commit hash>.zip (par exemple 51b8ef0.zip ) pour télécharger kivymd à partir d'un engagement spécifique.

Vous pouvez également installer manuellement à partir de sources. Il suffit de cloner le projet et d'exécuter PIP:

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

Conseil de vitesse : si vous n'avez pas besoin d'historique complet de validation (environ 1,14 gib), vous pouvez utiliser un clone superficiel ( git clone https://github.com/kivymd/KivyMD.git --depth 1 ) pour gagner du temps. Si vous avez besoin d'un historique complet de validation, supprimez --depth 1 .

Comment utiliser avec Buildozer

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

Cela téléchargera la dernière version de la version de Kivymd de PYPI.

Si vous souhaitez utiliser la version de développement à partir de Master Branch, vous devez spécifier le lien vers l'archive zip:

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

N'oubliez pas d'exécuter buildozer android clean ou supprimez le répertoire .buildozer avant la construction si la version a été mise à jour (Buildozer ne met pas à jour les packages déjà téléchargés).

Sur Linux

• Utilisez Bustozer directement ou via Docker.

Sur Windows 10

• Installez Ubuntu WSL et suivez les étapes Linux.

Construire automatiquement via des actions github

• Utilisez Artemsbulgakov / Buildozer-Action @ V1 pour construire automatiquement vos packages sur la demande de poussée ou de traction.
• Voir l'exemple complet du workflow.

Comment utiliser avec Kivy-ios

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

Documentation

• Voir la documentation sur https://kivymd.readthedocs.io
• Wiki avec des exemples d'utilisation de widgets kivymd: https://github.com/kivymd/kivymd/wiki

Démos

L'application d'évier de cuisine montre chaque widget Kivymd. Vous pouvez voir comment utiliser le widget dans le code de l'application.

Comparaison de Flutter & Kivymd

Concept de vue du ciel	Livraison de nourriture saine
Concept de chaussures Asics	Refonte de bureau Facebook

Utilisez MVC et Reload chaud

Soutien

Si vous avez besoin d'aide ou si vous avez une question, vous pouvez demander de l'aide sur notre liste de diffusion:

• Discord Server: https://discord.gg/wu3qbst (anglais #Support, russe # ru-soupport)
• Étiquette Stackoverflow: Kivymd
• Courriel: [email protected]

Paramètres

Syntaxe Soulignement et complétion automatique pour les fichiers Kivy / Kivymd .KV dans l'idée PyCharm / Intellij

Vidéo promotionnelle

Contributif

Nous accueillons toujours vos rapports de bogues, vos demandes de fonctionnalités et vos demandes de traction! Découvrez contribution.md et n'hésitez pas à améliorer le kivymd.

Environnement de configuration

Nous vous recommandons d'utiliser PyCharm pour travailler avec Kivymd Code. Installez Kivy et les dépendances de développement dans votre environnement virtuel:

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

Format tous les fichiers et les tests d'exécution:

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

Le pré-engagement formara des fichiers modifiés avec des importations noires et tri avec ISORT.

Projets soeurs

Extensions de kivymd

Extensions supplémentaires pour la bibliothèque Kivymd.

https://github.com/kivymd-extensions

Kivymdbuilder

Créer des applications visuellement.

https://github.com/kivymd/kivymdbuilder

Licence

• Kivymd est libéré en vertu des termes de la licence du MIT, comme Kivy.
• Roboto Font est sous licence et distribuée selon les termes de la licence Apache, version 2.0.
• Police emblématique par la communauté des icônes de conception des matériaux couverts par SIL Open Polon Licence 1.1

Contributeurs

Équipe kivymd

Ils ont passé beaucoup de temps pour améliorer le kivymd.

• Yuri Ivanov @heattheatr - Développeur de base
• Artem Bulgakov @artemsbulgakov - Administrateur technique, contributeur
• Andrés Rodríguez @MixedCase - Premier auteur de Kivymd Project, contributeur

Contributeurs de code

Ce projet existe grâce à toutes les personnes qui contribuent. Comment contribuer

Contributeurs financiers

Devenez un contributeur financier sur OpenCollective et nous aidez à maintenir notre communauté.

Sponsors d'or

Devenez un sponsor d'or et obtenez votre logo sur notre lecture avec un lien vers votre site Web.

Meilleur planificateur d'itinéraire - logiciel d'optimisation des routes

Bailleurs de fonds

Devenez un bailleur de fonds si vous souhaitez aider à développer ce projet.