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
依赖:
- Kivy >= 2.3.0 (安装说明)
- Python 3.7+
- Pillow
- MaterialColor
- asynckivy
如何安装
上面的命令将从 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 上
在 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 的比较
使用 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,并链接到您的网站。
最佳路线规划器 - 路线优化软件
支持者
如果您想帮助开发这个项目,成为支持者。