配置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.inimacOS:
/Users/tito/.kivy/config.iniLinux:
/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>
或者在每次运行应用程序之前,在控制台中手动更改它:
Windows:
set KIVY_HOME=<folder>
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 模块中进行了说明。