配置Kivy

Kivy 的配置文件名为 config.ini,遵循 标准 INI 格式。

定位配置文件

配置文件的位置由环境变量`KIVY_HOME`控制::

<KIVY_HOME>/config.ini

在桌面平台上,默认设置为:

<HOME_DIRECTORY>/.kivy/config.ini
如果你使用的是venv(虚拟环境),它应该看起来像这样::

<PROJECT_DIRECTORY>/.kivy/config.ini

如果你没有使用虚拟环境,且你的用户名是“tito”,那么该文件将位于此处:

  • Windows:C:\Users\tito\.kivy\config.ini

  • macOS:/Users/tito/.kivy/config.ini

  • Linux:/home/tito/.kivy/config.ini

在Android上,此默认设置为:

<ANDROID_APP_PATH>/.kivy/config.ini

如果你的应用名为“org.kivy.launcher”,该文件将位于此处:

/data/data/org.kivy.launcher/files/.kivy/config.ini

在iOS上,此默认值为:

<HOME_DIRECTORY>/Documents/.kivy/config.ini

本地配置

有时,我们可能只想为特定应用或测试Kivy的某个独立部分(例如输入提供者)更改配置。要创建单独的配置文件,只需使用以下命令:

from kivy.config import Config

Config.read(<file>)
# set config
Config.write()

当单个 .ini 文件的本地配置不够用时,例如,当您希望为 garden、kivy 日志和其他内容设置独立环境时,您需要在应用程序中更改 KIVY_HOME 环境变量以获得所需结果:

import os
os.environ['KIVY_HOME'] = <folder>

或者在每次运行应用程序之前,在控制台中手动更改它:

  1. Windows:

    set KIVY_HOME=<folder>
    
  2. Linux 与 OSX:

    export KIVY_HOME=<folder>
    

在更改``KIVY_HOME``之后,该文件夹的行为将与上述默认的``.kivy/``文件夹完全相同。

应用特定配置

对于桌面应用程序,使用 KIVY_DESKTOP_PATH_ID 环境变量来设置目录路径中面向用户的应用程序标题。这有助于最终用户在浏览文件系统时轻松识别您的应用程序目录。

在导入Kivy**之前**设置变量:

import os
os.environ['KIVY_DESKTOP_PATH_ID'] = 'My Photo Editor'

from kivy.app import App

这会创建清晰、易于识别的目录,例如在Windows上为``%APPDATA%\My_Photo_Editor``,让人一眼就能看出该目录属于哪个应用程序。

完整示例请参见 examples/desktop_path_id/,关于 KIVY_DESKTOP_PATH_ID 的详细信息请参阅 控制环境

理解配置令牌

所有配置项均在 kivy.config 模块中进行了说明。