KivyMD

Kivymd 2.0.0

Kivymd-это коллекция, соответствующие дизайну материала для использования с Kivy, фреймворком для кроссплатформенных графических приложений с поддержкой.

Цель проекта состоит в том, чтобы приблизить спецификацию дизайна материала Google как можно ближе, не жертвуя простотой использования. Эта библиотека является вилкой проекта Kivymd. Мы нашли силу и подняли этот проект на новый уровень.

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

Если вы хотите стать разработчиком проекта (разрешение на создание филиалов в проекте без разжигания для облегчения сотрудничества), получите хотя бы один PR и попросите об этом. Если вы регулярно вносите вклад в проект, вам может предложить роль, не спрашивая.

Установка

pip install kivymd==2.0.0

Зависимости:

• Киви> = 2.3.0 (установка)
• Python 3.7+
• Подушка
• Материалколор
• Асиннкиви

Как установить

Команда выше установит последнюю версию выпуска Kivymd из PYPI.

Если вы хотите установить версию разработки из Master Branch, вам следует указать ссылку на Zip Archive:

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

Совет : замените master.zip на <commit hash>.zip (например, 51b8ef0.zip ), чтобы загрузить kivymd с конкретного коммита.

Также вы можете установить вручную из источников. Просто клонируйте проект и запустите PIP:

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

Совет скорости : если вам не нужна полная история коммита (около 1,14 GIB), вы можете использовать мелкий клон ( git clone https://github.com/kivymd/KivyMD.git --depth 1 ), чтобы сэкономить время. Если вам нужна полная история коммита, то удалите --depth 1 .

Как использовать с BuildOzer

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

Это будет загружать последнюю версию выпуска Kivymd из PYPI.

Если вы хотите использовать версию разработки из Master Branch, вам следует указать ссылку на Zip Archive:

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

Не забудьте запустить buildozer android clean или удалить каталог .buildozer , прежде чем строить, если версия была обновлена ​​(Buildozer не обновляет уже загруженные пакеты).

На Linux

• Используйте Buildozer напрямую или через Docker.

В Windows 10

• Установите Ubuntu WSL и выполните шаги Linux.

Построить автоматически через действия GitHub

• Используйте Artemsbulgakov/Buildozer-Action@v1, чтобы автоматически построить свои пакеты по запросу на push или pull.
• Смотрите пример полного рабочего процесса.

Как использовать с Kivy-IOS

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

Документация

• См. Документацию по адресу https://kivymd.readthedocs.io
• Вики с примерами использования виджетов Kivymd: https://github.com/kivymd/kivymd/wiki

Демо

Приложение кухонной раковины демонстрирует каждый виджет Kivymd. Вы можете увидеть, как использовать виджет в коде приложения.

Сравнение Flutter & Kivymd

Концепция Sky View	Доставка здоровой пищи
Концепция обуви Asics	Редакция настольного стола в Facebook

Используйте MVC и горячую перезагрузку

Поддерживать

Если вам нужна помощь или у вас есть вопрос, вы можете попросить о помощи в нашем списке рассылки:

• Discord Server: https://discord.gg/wu3qbst (английский #Support, русский #ru-support)
• Тег Stackoverflow: kivymd
• Электронная почта: [email protected]

Настройки

Синтаксическое выделение и автоматическое завершение для файлов Kivy/Kivymd .kv в идее Pycharm/Intellij

Промо -видео

Внося

Мы всегда приветствуем ваши отчеты об ошибках, запросы на функции и запросы на получение! Проверьте Anplosing.md и не стесняйтесь улучшить Kivymd.

Установка среды

Мы рекомендуем вам использовать Pycharm для работы с Kivymd Code. Установите Kivy и Development зависимости в вашей виртуальной среде:

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

Форматируйте все файлы и запустите тесты:

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

Pre-Commit будет отформатировать модифицированные файлы с черным и сортировать импорт с помощью ISORT.

Сестринские проекты

Kivymd расширения

Дополнительные расширения для библиотеки Kivymd.

https://github.com/kivymd-extensions

Kivymdbuilder

Создайте приложения визуально.

https://github.com/kivymd/kivymdbuilder

Лицензия

• Kivymd выпускается в соответствии с условиями лицензии MIT, так же, как Киви.
• Font Roboto лицензирован и распространяется в соответствии с условиями лицензии Apache, версия 2.0.
• Знаменитый шрифт от сообщества дизайна материалов, охватываемая SIL Open Font License 1.1

Участники

Kivymd Team

Они потратили много времени, чтобы улучшить Kivymd.

• Yuri Ivanov @HeatTheatatr - Core Developer
• Artmem Bulgakov @Artemsbulgakov - технический администратор, участник
• Андрес Родригес @mixedcase - первый автор проекта Kivymd, участник

Кодовые участники

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

Финансовые участники

Станьте финансовым участником в Opencollective и помогите нам поддерживать наше сообщество.

Золотые спонсоры

Станьте спонсором золота и получите свой логотип в нашем Readme по ссылке на ваш сайт.

Лучший планировщик маршрутов - программное обеспечение для оптимизации маршрутов

Покровители

Станьте спонсором, если вы хотите помочь разработать этот проект.