KivyMD 2.0.0

KivyMD 是一个符合 Material Design 设计规范的部件集合，用于 Kivy 框架，Kivy 是一个用于开发跨平台、支持触摸的图形应用程序的框架。

该项目的目标是尽可能接近 Google 的 Material Design 规范，同时不牺牲易用性。这个库是 KivyMD 项目的一个分支。我们发现了其优势并将这个项目提升到了一个新的水平。

加入项目吧！只需 fork 项目，创建分支并在补丁准备就绪时提交 pull request。如果需要任何修改，我们会通过 PR 评论指导你完成必要的步骤，或者可能会请求访问权限以直接提交这些修改。

如果你希望成为项目开发者（无需 fork 即可在项目中创建分支，以便更轻松地协作），至少要有一个获批的 PR 并提出申请。如果你经常为项目做贡献，我们可能会主动向你提供这个角色。

安装

pip install kivymd==2.0.0

依赖：

如何安装

上面的命令将从 PyPI 安装 KivyMD 的最新发布版本。

如果你想安装 master 分支的开发版本，你应该指定 zip 压缩包的链接：

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

提示: 将 master.zip 替换为 <提交哈希>.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

这将从 PyPI 下载 KivyMD 的最新发布版本。

如果你想使用 master 分支的开发版本，你应该指定 zip 归档的链接：

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

如果版本已更新，在构建之前不要忘记运行 buildozer android clean 或删除 .buildozer 目录（Buildozer 不会更新已下载的包）。

在 Linux 上

直接使用 Buildozer 方法或通过 Docker。

在 Windows 10 上

安装 Ubuntu WSL 并按照 Linux 步骤操作。

通过 GitHub Actions 自动构建

使用 ArtemSBulgakov/buildozer-action@v1 在推送或拉取请求时自动构建你的包。
查看完整工作流程示例。

如何与 kivy-ios 一起使用

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

文档

查看文档：https://kivymd.readthedocs.io
KivyMD 小部件使用示例的 Wiki：https://github.com/kivymd/KivyMD/wiki

演示

Kitchen sink 应用程序演示了每个 KivyMD 小部件。你可以在应用程序的代码中看到如何使用小部件。

Flutter 与 KivyMD 的比较

天空视图概念	健康食品配送
<a href="https://www.youtube.com/watch?v=xvi2D1c4mfQ"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/3ee0c453-b17b-4151-bc51-e709e50a934a.png" title="点击在 YouTube 上观看"></a>	<a href="https://www.youtube.com/watch?v=P-ylDDm4TJM"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/607791d9-3918-41d7-aae1-12d810b8bf97.png" title="点击在 YouTube 上观看"></a>
Asics 鞋概念	Facebook 桌面重新设计
<a href="https://www.youtube.com/watch?v=ehuXPgun0k0"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/875d8ed9-6603-4ad8-aa7e-1ddf83b11784.png" title="点击在 YouTube 上观看"></a>	<a href="https://www.youtube.com/watch?v=ZNBQib6Hk4s"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/59ab170d-4009-4ed8-b4c9-052c3c08dd06.png" title="点击在 YouTube 上观看"></a>

使用 MVC 和热重载

支持

如果你需要帮助或有问题，可以在我们的邮件列表上寻求帮助：

Discord 服务器： https://discord.gg/wu3qBST（英语 #support，俄语 #ru-support）
StackOverflow 标签： kivymd
电子邮件： KivyMD-library@yandex.com

设置

PyCharm/Intellij IDEA中Kivy/KivyMD .kv文件的语法高亮和自动完成

宣传视频

贡献

我们始终欢迎您提交Bug报告、功能请求和Pull请求! 查看CONTRIBUTING.md 并随时改进KivyMD。

设置环境

我们建议您使用PyCharm来处理KivyMD代码。在您的虚拟环境中安装 Kivy和开发依赖项：

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将使用Black格式化修改后的文件，并使用isort对导入进行排序。

姐妹项目

KivyMD扩展

KivyMD库的附加扩展。

https://github.com/kivymd-extensions

KivyMDBuilder

可视化构建应用程序。

https://github.com/kivymd/KivyMDBuilder

许可证

KivyMD根据MIT许可证条款发布，与Kivy相同。
Roboto字体根据Apache许可证2.0版的条款许可和分发。
Iconic字体由 Material Design Icons社区提供，受 SIL开放字体许可1.1保护

贡献者

KivyMD团队

他们花费了大量时间来改进KivyMD。

Yuri Ivanov @HeaTTheatR - 核心开发者
Artem Bulgakov @ArtemSBulgakov - 技术管理员，贡献者
Andrés Rodríguez @mixedCase - KivyMD项目的第一作者，贡献者

代码贡献者

这个项目的存在要感谢所有做出贡献的人。 如何贡献

财务贡献者

在OpenCollective上成为财务贡献者，帮助我们维持我们的社区。

金牌赞助商

成为金牌赞助商，在我们的Readme上展示您的logo，并链接到您的网站。

<a href="https://route4me.com" target="_blank" style="display: inline-block; text-align: center;"> <div style="text-align: center;"> <img width="280" src="https://yellow-cdn.veclightyear.com/0a4dffa0/1f39c6bf-5d31-48ac-b8ca-d3bed35c03cf.png" alt="最佳路线规划器"><br> 最佳路线规划器 - 路线优化软件 </div> </a>