模块

模块是Kivy应用启动时可以加载的类。模块的加载由配置文件管理。目前,我们包含:

  • touchring:在每个触摸点周围绘制一个圆圈。

  • : monitor:添加一个红色顶栏,用于显示FPS,并附带一个小型图表,指示输入活动情况。

  • keybinding:将某些按键绑定到操作,例如截图。

  • : recorder:录制并回放一系列事件。

  • screen:模拟不同屏幕的特性(dpi/密度/分辨率)。

  • inspector:检查您的控件层级结构和控件属性。

  • webdebugger:通过网页浏览器实时检查您的应用内部状态。

  • joycursor:使用操纵杆在您的应用中导航。

  • showborder:显示部件的边框。

模块会自动从Kivy路径和用户路径加载:

  • PATH_TO_KIVY/kivy/modules

  • HOME/.kivy/mods

激活模块

有多种方式可以激活Kivy模块。

在配置中激活一个模块

要以这种方式激活模块,你可以编辑你的配置文件(位于 HOME/.kivy/config.ini):

[modules]
# uncomment to activate
touchring =
# monitor =
# keybinding =

仅需模块名称后跟“=”即可激活该模块。

在Python中激活一个模块

在启动你的应用程序之前,最好在导入的开始部分,你可以这样做::

import kivy
kivy.require('1.0.8')

# Activate the touchring module
from kivy.config import Config
Config.set('modules', 'touchring', '')

通过命令行激活模块

在命令行启动应用程序时,可以在参数中添加 -m <模块名>。例如:

python main.py -m webdebugger

备注

某些模块(如屏幕)可能需要额外的参数。然而,当未提供这些参数启动时,它们会在控制台中打印这些参数。

创建你自己的模块。

在你的 HOME/.kivy/mods 目录下创建一个文件,并定义两个函数:

def start(win, ctx):
    pass

def stop(win, ctx):
    pass

开始/停止是Kivy中每个打开的窗口都会调用的函数。当你启动一个模块时,可以利用这些函数来存储和管理模块状态。请使用`ctx`变量作为字典。这个上下文对于模块的每个实例/start()调用都是唯一的,并且也会传递给stop()。