Table Of Contents
Сад¶
Добавлено в версии 1.7.0.
Изменено в версии 1.11.1.
Сад - это проект по централизации дополнений для Kivy, поддерживаемых пользователями. Вы можете найти более подробную информацию на Kivy Garden. Все пакеты из сада централизованы в репозитории kivy-garden на Github.
Предупреждение
Виджеты садовых цветов предоставляются обычными пользователями, такими как вы. Разработчики Kivy не несут ответственности за код, размещенный в репозиториях организации сада - мы не активно отслеживаем репозитории цветов. Используйте на свой страх и риск.
Обновление до структуры сада¶
Начиная с выпуска kivy 1.11.0, kivy перешел на использование устаревшего инструмента сада, который устанавливает цветы с помощью garden install flower, где цветок не имеет правильной структуры пакета Python, к цветам, которые можно устанавливать с помощью pip и загружать на pypi. Kivy поддерживает старые цветы сада параллельно с более новыми пакетами, поэтому инструмент сада и старые цветы сада будут использоваться бесконечно. Но мы будем предоставлять поддержку только для формата более новых пакетов в будущем.
Для разработчиков садовых пакетов - руководство по миграции вашего садового пакета из устаревшей структуры garden.flower в более новую структуру flower, используемую с pip, смотрите это руководство.
Мы надеемся, что большинство садовых пакетов будет переведено в новый формат, чтобы облегчить установку.
Общие рекомендации по использованию¶
Чтобы использовать цветок сада Kivy, сначала проверьте, в устаревшем ли формате находится цветок. Если имя цветка имеет формат garden.flower, например, garden.graph, то это устаревший цветок. Если он просто flower, например, graph, то он в новом формате. Если он находится в устаревшем формате, смотрите Инструкции по устаревшему инструменту сада о том, как его устанавливать и использовать. В противном случае продолжайте снизу.
Садовые цветы теперь можно устанавливать с помощью инструмента pip как обычные пакеты Python. Предположим, вы хотите установить цветок, давайте используем graph в качестве примера. Вы можете установить его напрямую из github с помощью:
python -m pip install https://github.com/kivy-garden/graph/archive/master.zip
Посмотрите вкладку релизов репозитория, если вы хотите установить конкретную версию или предварительно скомпилированный пакет, если у цветка есть такие. Затем используйте URL с pip.
Или вы можете автоматически установить его с помощью сервера pypi сада:
python -m pip install kivy_garden.graph --extra-index-url https://kivy-garden.github.io/simple/
Чтобы постоянно добавить сервер сада в конфигурацию pip, чтобы вам не приходилось указывать его с --extra-index-url, добавьте:
[global]
timeout = 60
index-url = https://kivy-garden.github.io/simple/
в вашем pip.conf.
Если создатель цветка загрузил его в pypi, вы можете просто установить его с pip install kivy_garden.flower.
Инструкции по устаревшему инструменту сада¶
Сад теперь распространяется как отдельный модуль Python, kivy-garden. Вы можете установить его с помощью pip:
pip install kivy-garden
Модуль сада изначально не включает в себя никаких пакетов. Вы можете их скачать с помощью инструмента сада, установленного с помощью пакета pip:
# Установка садового пакета
garden install graph
# Обновление садового пакета
garden install --upgrade graph
# Удаление садового пакета
garden uninstall graph
# Список установленных садовых пакетов
garden list
# Поиск новых пакетов
garden search
# Поиск всех пакетов, содержащих "graph"
garden search graph
# Показать справку
garden --help
Все садовые пакеты устанавливаются по умолчанию в ~/.kivy/garden.
Примечание
В предыдущих версиях Kivy сад был инструментом в kivy/tools/garden. Теперь этого больше нет, но модуль kivy-garden предоставляет точно такую же функциональность.
Упаковка¶
Если вы хотите включить садовые пакеты в свое приложение, вы можете добавить --app к команде install. Это создаст каталог libs/garden в вашей текущей директории, который будет использоваться kivy.garden.
Например:
cd myapp
garden install --app graph
- kivy.garden.garden_system_dir = 'garden'¶
системный путь, где можно устанавливать модули сада