【第2章Kivy核心架构】2.3 KV语言与Python代码分离设计

KV语言与Python代码分离设计

KV语言（Kivy Language）是Kivy框架中用于描述用户界面的一种声明式语言。将KV语言与Python代码分离是Kivy应用开发的推荐做法，这种分离设计有以下优势：

分离设计的优点

1. 关注点分离：UI设计与业务逻辑分离
2. 可维护性：修改界面不影响代码逻辑
3. 可读性：KV文件更直观展示UI结构
4. 团队协作：设计师和开发者可以并行工作

实现方式

1. 自动加载KV文件

Kivy会自动加载与主应用类同名且小写的.kv文件：

# main.py
from kivy.app import App

class MyApp(App):  # Kivy会自动查找my.kv文件
    pass

MyApp().run()

# my.kv
BoxLayout:
    Button:
        text: 'Click me'
    Label:
        text: 'Hello World'

2. 手动加载KV文件

可以使用Builder.load_file()或Builder.load_string()：

from kivy.app import App
from kivy.lang import Builder

Builder.load_file('ui.kv')  # 加载外部KV文件

class MyApp(App):
    pass

MyApp().run()

3. 动态加载KV字符串

from kivy.app import App
from kivy.lang import Builder

KV = '''
BoxLayout:
    Button:
        text: 'Dynamic KV'
'''

class MyApp(App):
    def build(self):
        return Builder.load_string(KV)

MyApp().run()

最佳实践

1. 命名规范：

   • KV文件名应与App类名匹配（MyApp → my.kv）
   • 使用小写和下划线命名KV文件

2. 组织结构：

   myapp/
   ├── main.py       # 主程序逻辑
   ├── ui.kv         # 主界面定义
   └── widgets/      # 自定义组件
       ├── custom_button.kv
       └── custom_button.py
   

3. 引用Python类：

   # custom_widget.kv
   <CustomButton@Button>:
       background_color: 1, 0, 0, 1
       text: 'Custom'
   

4. 数据绑定：

   Label:
       text: app.get_status()  # 绑定到App类的方法
   

5. 事件处理：

   Button:
       on_press: app.button_pressed()
   

示例：完整分离结构

main.py:

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout

class LoginScreen(BoxLayout):
    def check_credentials(self, username, password):
        return username == 'admin' and password == 'secret'

class MyApp(App):
    def build(self):
        return LoginScreen()

if __name__ == '__main__':
    MyApp().run()

my.kv:

<LoginScreen>:
    orientation: 'vertical'
    padding: 50
    spacing: 20
    
    TextInput:
        id: username
        hint_text: 'Username'
        size_hint_y: None
        height: 50
    
    TextInput:
        id: password
        hint_text: 'Password'
        password: True
        size_hint_y: None
        height: 50
    
    Button:
        text: 'Login'
        size_hint_y: None
        height: 50
        on_press:
            root.check_credentials(username.text, password.text)

这种分离设计使得UI修改可以在不触及Python代码的情况下完成，同时也保持了代码的清晰结构和可维护性。