目录

花园

在 1.7.0 版本加入.

在 1.11.1 版本发生变更.

Garden 是一个由用户维护的 Kivy 插件集中项目。你可以在 Kivy Garden 找到更多信息。所有 garden 包都集中在 kivy-garden Github 仓库中。

警告

garden flower 控件由像您这样的普通用户贡献。Kivy 开发者对 garden 组织仓库中托管的代码不承担任何责任——我们不会主动监控 flower 仓库。请自行承担使用风险。

更新至garden结构

从 kivy 1.11.0 版本开始，kivy 已从使用 garden 传统工具（通过 garden install flower 安装花，且花没有适当的 Python 包结构）转向支持可通过 pip 安装并上传至 pypi 的花。Kivy 同时支持传统 garden 花和新版包，因此 garden 工具和传统花可以无限期使用。但未来我们将仅支持新版包格式。

对于garden包维护者——如需了解如何将您的garden包从旧版结构`garden.flower`迁移到与pip一起使用的新版`flower`结构，请参阅`本指南 <https://kivy-garden.github.io/#guideformigratingflowersfromlegacystructure>`_。

我们希望大多数花园包都能转换为更新的格式，以便于安装。

通用使用指南

要使用一个kivy garden花，首先检查该花是否为旧版格式。如果花名格式为`garden.flower`，如`garden.graph <https://github.com/kivy-garden/garden.graph>`_，则属于旧版花。如果仅为`flower`，如`graph <https://github.com/kivy-garden/graph>`_，则为当前格式。若为旧版格式，请参阅`旧版garden工具说明`_了解安装和使用方法。否则，请继续阅读以下指南。

现在，Garden 花朵可以像普通的 Python 包一样，使用 pip 工具进行安装。以你想要安装的花朵为例，我们使用 graph 作为示例。你可以直接从 GitHub 安装 master 版本，命令如下：：

python -m pip install https://github.com/kivy-garden/graph/archive/master.zip

如果您想安装特定版本或预编译的wheel包（如果该flower有提供的话），请查看仓库的releases标签页。然后使用带有`pip`的URL进行安装。

或者你可以使用garden的pypi服务器自动安装它，命令如下:

python -m pip install kivy_garden.graph --extra-index-url https://kivy-garden.github.io/simple/

要将我们的garden服务器永久添加到您的pip配置中，这样您就不必使用`--extra-index-url`来指定它，请添加：：

[global]
timeout = 60
index-url = https://kivy-garden.github.io/simple/

添加到你的 pip.conf 文件中。

如果花（flower）的维护者已将花上传至 pypi，你可以直接使用 pip install kivy_garden.flower 进行安装。

遗留花园工具说明

Garden 现在作为独立的 Python 模块 kivy-garden 进行分发。您可以通过 pip 安装它:

pip install kivy-garden

garden 模块初始不包含任何包。您可以通过 pip 包安装的 garden 工具来下载它们。

# Installing a garden package
garden install graph

# Upgrade a garden package
garden install --upgrade graph

# Uninstall a garden package
garden uninstall graph

# List all the garden packages installed
garden list

# Search new packages
garden search

# Search all the packages that contain "graph"
garden search graph

# Show the help
garden --help

所有 garden 包默认安装在 ~/.kivy/garden 目录下。

备注

在Kivy的早期版本中，garden是位于kivy/tools/garden的一个工具。该工具现已不再存在，但kivy-garden模块提供了完全相同的功能。

打包

如果你想在应用程序中包含garden包，可以在`install`命令后添加`--app`参数。这将在当前目录下创建一个`libs/garden`目录，该目录将被`kivy.garden`使用。

例如:

cd myapp
garden install --app graph
class kivy.garden.GardenImporter[源代码]

基类：MetaPathFinder

kivy.garden.garden_system_dir = 'garden'

garden 模块可以安装的系统路径

« 事件管理器 图形。 »